Usar a interface da linha de comando do AWS Copilot

A interface da linha de comando (CLI) do AWS Copilot simplifica a criação, o lançamento e o funcionamento de aplicações em contêineres prontas para produção no Amazon ECS em um ambiente de desenvolvimento local. A CLI do AWS Copilot se alinha aos fluxos de trabalho do desenvolvedor que oferecem suporte a práticas recomendadas de aplicações modernas: do uso da infraestrutura como código à criação de um pipeline de CI/CD provisionado em nome de um usuário. Use a CLI do AWS Copilot como parte do ciclo diário de desenvolvimento e testes como uma alternativa ao AWS Management Console.

O AWS Copilot no momento oferece suporte a sistemas Linux, macOS e Windows. Para obter mais informações sobre a versão mais recente da CLI do AWS Copilot, consulte Releases (Versões).

nota

O código-fonte da CLI do AWS Copilot está disponível no GitHub. A documentação mais recente da CLI está disponível no site do AWS Copilot. Recomendamos que você envie problemas e solicitações pull para alterações que você gostaria de ter incluído. No entanto, o Amazon Web Services no momento não oferece suporte para a execução de cópias modificadas do código do AWS Copilot. Informe problemas com o AWS Copilot entrando em contato conosco no Gitter ou no GitHub. onde você pode discutir problemas, fornecer feedback e relatar bugs.

Instalar a CLI do AWS Copilot

A CLI do AWS CopilotI pode ser instalada em sistemas Linux ou macOS usando Homebrew ou baixando manualmente o binário. Use as seguintes etapas com seu método de instalação preferencial.

Instalar a CLI do AWS Copilot usando Homebrew

O comando a seguir é usado para instalar a CLI do AWS Copilot no sistema macOS ou Linux usando Homebrew. Antes da instalação, você deve ter o Homebrew instalado. Para obter mais informações, consulte Homebrew.


brew install aws/tap/copilot-cli

Instalar manualmente a CLI do AWS Copilot

Como alternativa ao Homebrew, você pode instalar manualmente a CLI do AWS Copilot no sistema macOS ou Linux. Use o comando a seguir para seu sistema operacional baixar o binário, aplicar permissões de execução a ele e, em seguida, verifique se ele funciona listando o menu de ajuda.

(Opcional) Verifique a CLI do AWS Copilot manualmente instalada usando assinaturas PGP

Os executáveis da CLI do AWS são assinados de forma criptografada usando assinaturas PGP. As assinaturas PGP podem ser usadas para verificar a validade do executável da CLI do AWS Copilot. Use as etapas a seguir para verificar as assinaturas por meio da ferramenta GnuPG.

Baixe e instale GnuPG. Para obter mais informações, consulte o Site do GnuPG.
macOS
Recomendamos o uso do Homebrew. Instale o Homebrew seguindo as instruções disponíveis no site da ferramenta. Para obter mais informações, consulte Homebrew. Depois que o Homebrew estiver instalado, use o seguinte comando no terminal do macOS.
```
brew install gnupg
```
Linux

Instale o gpg usando o gerenciador de pacotes no seu tipo de Linux.

Windows

Baixe o instalador simples do Windows no site do GnuPG e instale como administrador. Depois de instalar o GnuPG, feche e reabra o PowerShell do administrador.

Para obter mais informações, consulte GnuPG Download.
Verifique se o caminho do GnuPG foi adicionado ao caminho do ambiente.
macOS
```
echo $PATH
```
Se você não vir o caminho GnuPG na saída, execute o seguinte comando para adicioná-lo ao caminho.
```
PATH=$PATH:<path to GnuPG executable files>
```
Linux
```
echo $PATH
```
Se você não vir o caminho GnuPG na saída, execute o seguinte comando para adicioná-lo ao caminho.
```
export PATH=$PATH:<path to GnuPG executable files>
```
Windows
```
Write-Output $Env:PATH
```
Se você não vir o caminho GnuPG na saída, execute o seguinte comando para adicioná-lo ao caminho.
```
$Env:PATH += ";<path to GnuPG executable files>"
```
Crie um arquivo de texto simples local.
macOS
No terminal, insira:
```
touch <public_key_filename.txt>
```
Abra o arquivo com o TextEdit.
Linux

Crie um arquivo de texto em um editor de texto, como o gedit. Salve como public_key_filename.txt

Windows

Crie um arquivo de texto em um editor de texto, como o Notepad. Salve como public_key_filename.txt

Adicione o seguinte conteúdo da chave pública de PGP do Amazon ECS e salve o arquivo.

Detalhes da chave pública PGP do Amazon ECS para referência:

Key ID: BCE9D9A42D51784F
Type: RSA
Size: 4096/4096
Expires: Never
User ID: Amazon ECS
Key fingerprint: F34C 3DDA E729 26B0 79BE AEC6 BCE9 D9A4 2D51 784F

É possível fechar o editor de texto.

Importe o arquivo com a chave pública de PGP do Amazon ECS usando o seguinte comando no terminal.
```
gpg --import <public_key_filename.txt>
```
Baixe as assinaturas da CLI do AWS Copilot.. As assinaturas são assinaturas PGP desanexadas de caracteres ASCII armazenadas em arquivos com a extensão .asc. O arquivo de assinaturas tem o mesmo nome do executável correspondente, com .asc adicionado.
macOS
No macOS, execute o comando a seguir.
```
sudo curl -Lo copilot.asc https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin.asc
```
Linux
Para sistemas Linux x86 (64 bits), execute o comando a seguir.
```
sudo curl -Lo copilot.asc https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux.asc
```
Para sistemas Linux ARM, execute o comando a seguir.
```
sudo curl -Lo copilot.asc https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64.asc
```
Windows
Usando Powershell, execute o comando a seguir.
```
Invoke-WebRequest -OutFile 'C:\copilot\copilot.asc' https://github.com/aws/copilot-cli/releases/latest/download/copilot-windows.exe.asc
```

Verifique a assinatura com o comando a seguir.

Para sistemas macOS e Linux:


gpg --verify copilot.asc /usr/local/bin/copilot

Apenas para sistemas Windows:


gpg --verify 'C:\copilot\copilot.asc' 'C:\copilot\copilot.exe'

Saída esperada:

gpg: Signature made Tue Apr  3 13:29:30 2018 PDT
gpg:                using RSA key DE3CBD61ADAF8B8E
gpg: Good signature from "Amazon ECS <ecs-security@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: F34C 3DDA E729 26B0 79BE  AEC6 BCE9 D9A4 2D51 784F
     Subkey fingerprint: EB3D F841 E2C9 212A 2BD4  2232 DE3C BD61 ADAF 8B8E

Importante

O aviso na saída é esperado e não é um problema. Isso ocorre porque não existe uma cadeia de confiança entre a chave PGP pessoal (se você tiver uma) e a chave PGP do Amazon ECS. Para obter mais informações, consulte Web of trust.

Para instalações do Windows, execute o comando a seguir no Powershell para adicionar o diretório do AWS Copilot ao caminho.
```
 $Env:PATH += ";<path to Copilot executable files>"
```

Próximas etapas

Depois da instalação, saiba como implantar uma aplicação do Amazon ECS usando o AWS Copilot. Para ter mais informações, consulte Conceitos básicos do Amazon ECS usando AWS Copilot.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Visão geral das ferramentas do desenvolvedor

Conceitos básicos do AWS Copilot