Conceitos básicos da interface de linha de comando do Amazon ECS - Amazon Elastic Container Service

Conceitos básicos da interface de 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 ter mais informações, consulte Conceitos básicos da interface de 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 no GitHub. Essa ferramenta não está mais sendo desenvolvida de forma ativa.

Instalar a CLI 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 ter mais informações, consulte Conceitos básicos da interface de linha de comando do AWS Copilot.

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
  1. Baixe o binário da CLI do Amazon ECS.

    macOS
    sudo curl -Lo /usr/local/bin/ecs-cli https://amazon-ecs-cli.s3.amazonaws.com/ecs-cli-darwin-amd64-latest
    Linux
    sudo curl -Lo /usr/local/bin/ecs-cli https://amazon-ecs-cli.s3.amazonaws.com/ecs-cli-linux-amd64-latest
    Windows

    Abra o Windows PowerShell e insira os seguintes comandos.

    nota

    Se você encontrar problemas de permissão, assegure-se de que você tenha acesso de administrador no Windows e esteja executando o PowerShell como administrador.

    New-Item -Path 'C:\Program Files\Amazon\ECSCLI' -ItemType Directory Invoke-WebRequest -OutFile 'C:\Program Files\Amazon\ECSCLI\ecs-cli.exe' https://amazon-ecs-cli.s3.amazonaws.com/ecs-cli-windows-amd64-latest.exe
  2. 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.

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

    2. 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>"
    3. 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

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

      -----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v2 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 =Gi5D -----END PGP PUBLIC KEY BLOCK-----

      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
    5. 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>
    6. 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.

      macOS
      curl -Lo ecs-cli.asc https://amazon-ecs-cli.s3.amazonaws.com/ecs-cli-darwin-amd64-latest.asc
      Linux
      curl -Lo ecs-cli.asc https://amazon-ecs-cli.s3.amazonaws.com/ecs-cli-linux-amd64-latest.asc
      Windows
      Invoke-WebRequest -OutFile ecs-cli.asc https://amazon-ecs-cli.s3.amazonaws.com/ecs-cli-windows-amd64-latest.exe.asc
    7. Verifique a assinatura.

      macOS and Linux
      gpg --verify ecs-cli.asc /usr/local/bin/ecs-cli
      Windows
      gpg --verify ecs-cli.asc 'C:\Program Files\Amazon\ECSCLI\ecs-cli.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.

  3. 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 o PowerShell para que as alterações entrem em vigor.

    nota

    Depois que a variável PATH for definida, a CLI do Amazon ECS poderá ser usada pelo Windows PowerShell ou pelo prompt de comando.

  4. 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 ter mais informações, consulte Configurar a CLI do Amazon ECS.

Configurar a CLI 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 ter mais informações, consulte Conceitos básicos da interface de linha de comando do AWS Copilot.

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
  1. 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
  2. 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 é:

  1. Indicadores de perfil da CLI do Amazon ECS:

    1. Perfil do Amazon ECS (--ecs-profile)

    2. Perfil da AWS (--aws-profile)

  2. Variáveis de ambiente:

    1. ECS_PROFILE

    2. AWS_PROFILE

    3. AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, e AWS_SESSION_TOKEN

  3. O config do ECS tenta buscar as credenciais do perfil padrão do ECS.

  4. 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).

  5. Função da instância do EC2

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

  1. Sinalizadores da CLI do Amazon ECS:

    1. Indicador de região (--region)

    2. Indicador de config do cluster (--cluster-config)

  2. O config do ECS tenta encontrar a região no perfil padrão do ECS.

  3. Variáveis do ambiente: tentam encontrar a região a partir das seguintes variáveis de ambiente:

    1. AWS_REGION

    2. AWS_DEFAULT_REGION

  4. 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)