Instalar a CLI do Amazon ECS Configurar a CLI do Amazon ECS

Usar a interface da linha de comando do Amazon ECS

O Amazon ECS lançou o AWS Copilot, uma ferramenta da interface da linha de comando (CLI) que simplifica a criação, o lançamento e a operação de aplicações em contêineres prontas para produção no Amazon ECS em um ambiente de desenvolvimento local. Para obter mais informações, consulte Usar a interface da linha de comando do AWS Copilot.

A interface da linha de comando (CLI) do Amazon Elastic Container Service (Amazon ECS) fornece comandos de alto nível para simplificar a criação, a atualização e o monitoramento de clusters e tarefas em um ambiente de desenvolvimento local. A CLI do Amazon ECS oferece suporte a arquivos do Docker Compose, uma especificação de código aberto popular para definição e execução de aplicações para vários contêineres. Use a CLI do ECS como parte do ciclo diário de desenvolvimento e testes como uma alternativa ao AWS Management Console.

A versão mais recente da CLI do Amazon ECS só é compatível com as versões principais da sintaxe de arquivo do Docker Compose versões 1, 2 e 3. A versão especificada no arquivo Compose deve ser a string "1", "1.0", "2", "2.0", "3" ou "3.0". As versões secundárias do Docker Compose não são compatíveis.

O código-fonte da CLI do Amazon ECS está disponível em. GitHub Essa ferramenta não está mais sendo desenvolvida de forma ativa.

Instalar a CLI do Amazon ECS

As etapas a seguir demonstram como instalar a CLI do Amazon ECS no sistema macOS, Linux ou Windows.

Para instalar a CLI do Amazon ECS

Baixe o binário da CLI do Amazon ECS.

Verifique a CLI do Amazon ECS usando assinaturas PGP. Os executáveis da CLI do Amazon ECS são assinados de forma criptografada com assinaturas PGP. As assinaturas PGP podem ser usadas para verificar a validade do executável da CLI do Amazon ECS. 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 Administrador. PowerShell

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 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

Você pode 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 Amazon ECS. 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.

Verifique a assinatura.

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.

Aplique permissões de execução ao binário.
macOS and Linux
```
sudo chmod +x /usr/local/bin/ecs-cli
```
Windows
Edite as variáveis de ambiente e adicione C:\Program Files\Amazon\ECSCLI ao campo de variável PATH, separado das entradas existentes usando um ponto-e-vírgula. Por exemplo:
```
setx path "%path%;C:\Program Files\Amazon\ECSCLI"
```
Reinicie PowerShell para que as alterações entrem em vigor.

nota
Depois que a PATH variável é definida, a CLI do Amazon ECS pode ser usada no PowerShell Windows ou no prompt de comando.
Verifique se a CLI está funcionando corretamente.
```
ecs-cli --version
```
Vá para Configurar a CLI do Amazon ECS.

Importante
Você deve configurar a CLI do Amazon ECS com suas credenciais da AWS, uma região da AWS e um nome de cluster do Amazon ECS para poder usá-la. Para obter mais informações, consulte Configurar a CLI do Amazon ECS.

Configurar a CLI do Amazon ECS

A CLI do Amazon ECS requer algumas informações básicas sobre a configuração antes que você possa usá-la, como suas credenciais da AWS, a região da AWS em que criará seu cluster e o nome do cluster do Amazon ECS a ser usado. As informações de configuração são armazenadas no diretório ~/.ecs dos sistemas macOS e Linux e em C:\Users\<username>\AppData\local\ecs nos sistemas Windows.

Para configurar a CLI do Amazon ECS

Configure um perfil da CLI com o comando a seguir, substituindo profile_name pelo nome de perfil desejado, variáveis de ambiente $AWS_ACCESS_KEY_ID e $AWS_SECRET_ACCESS_KEY pelas credenciais da AWS.
```
ecs-cli configure profile --profile-name profile_name --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY
```
Preencha a configuração com o comando a seguir, substituindo launch_type pelo tipo de inicialização de tarefa que você quer usar por padrão, region_name pela região da AWS desejada, cluster_name pelo nome de um cluster existente ou um cluster novo ou existente do Amazon ECS a ser usado e configuration_name pelo nome que você gostaria de fornecer a esta configuração.
```
ecs-cli configure --cluster cluster_name --default-launch-type launch_type --region region_name --config-name configuration_name
```

Usar perfis

A CLI do Amazon ECS é compatível com a configuração de vários conjuntos de credenciais da AWS, como perfis designados, usando o comando ecs-cli configure profile. Um perfil padrão pode ser definido usando o comando ecs-cli configure profile default. Esses perfis podem ser, em seguida, referenciados quando você executar comandos da CLI do Amazon ECS que exigem credenciais usando o indicador--ecs-profile, caso contrário, o perfil padrão é usado.

Usar configurações de cluster

Uma configuração de cluster é um conjunto de campos que descrevem um cluster do Amazon ECS, incluindo o nome do cluster e a região. Uma configuração padrão do cluster pode ser definida usando o comando ecs-cli configure default. A CLI do Amazon ECS é compatível com a configuração de várias configurações de cluster designado usando a opção --config-name.

Entender a ordem de precedência

Existem vários métodos para aprovar tanto as credenciais quanto a região em um comando da CLI do Amazon ECS. A lista a seguir é a ordem de precedência para cada um desses.

A ordem de precedência para credenciais é:

Indicadores de perfil da CLI do Amazon ECS:
1. Perfil do Amazon ECS (--ecs-profile)
2. Perfil da AWS (--aws-profile)
Variáveis de ambiente:
1. ECS_PROFILE
2. AWS_PROFILE
3. AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, e AWS_SESSION_TOKEN
O config do ECS tenta buscar as credenciais do perfil padrão do ECS.
Perfil padrão da AWS: tenta usar credenciais (aws_access_key_id, aws_secret_access_key) ou assume_role (role_arn, source_profile) do nome do perfil da AWS.
1. Variável de ambiente AWS_DEFAULT_PROFILE (usa como padrão default).
Função da instância do EC2

A ordem de precedência para região é:

Sinalizadores da CLI do Amazon ECS:
1. Indicador de região (--region)
2. Indicador de config do cluster (--cluster-config)
O config do ECS tenta encontrar a região no perfil padrão do ECS.
Variáveis do ambiente: tentam encontrar a região a partir das seguintes variáveis de ambiente:
1. AWS_REGION
2. AWS_DEFAULT_REGION
Perfil da AWS: tenta usar a região a partir do nome do perfil da AWS:
1. AWS_PROFILE variável de ambiente
2. Variável de ambiente AWS_DEFAULT_PROFILE (usa como padrão default)

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

Criar recursos do Amazon ECS com o AWS CloudFormation

Versões da plataforma

Usar a interface da linha de comando do Amazon ECS

Instalar a CLI do Amazon ECS

Para instalar a CLI do Amazon ECS

nota

Importante

nota

Importante

Configurar a CLI do Amazon ECS

Para configurar a CLI do Amazon ECS

Usar perfis

Usar configurações de cluster

Entender a ordem de precedência