AWS Command Line Interface e tutorial aws-shell para o AWS Cloud9

O tutorial a seguir permite que você configure a AWS Command Line Interface (AWS CLI), o aws-shell ou ambos no ambiente de desenvolvimento do AWS Cloud9. A AWS CLI e o aws-shell são ferramentas unificadas que fornecem uma interface consistente para interagir com todas as partes da AWS. É possível usar a AWS CLI em vez do AWS Management Console para executar comandos rapidamente a fim de interagir com a AWS, e alguns desses comandos podem ser executados com a AWS CLI ou alternativamente usando o AWS CloudShell.

Para obter mais informações sobre a AWS CLI, consulte o Manual do usuário da AWS Command Line Interface. Para o aws-shell, consulte os recursos a seguir:

• aws-shell no site do GitHub

• aws-shell no site do pip

Para obter uma lista de comandos que podem ser executados com a AWS CLI para interagir com a AWS, consulte a Referência de comandos da AWS CLI É possível usar os mesmos comandos com o AWS CloudShell, porém, você deverá iniciar os comandos sem o prefixo aws.

A criação deste exemplo pode gerar cobranças em sua conta da AWS. Isso inclui possíveis cobranças por serviços como o Amazon EC2 e Amazon S3. Para obter mais informações, consulte Definição de preço do Amazon EC2 e Definição de preço do Amazon S3.

Pré-requisitos

Antes de usar esse exemplo, verifique se suas configurações cumprem os requisitos a seguir.

• É necessário ter um ambiente existente de desenvolvimento do AWS Cloud9 EC2 Este exemplo pressupõe que você já tem um ambiente do EC2 conectado a uma instância do Amazon EC2 que executa Amazon Linux ou Ubuntu Server. Caso tenha um tipo diferente de ambiente ou sistema operacional, poderá ser necessário adaptar as instruções desse exemplo para configurar ferramentas relacionadas. Para obter mais informações, consulte Criando um ambiente em AWS Cloud9.

• Você tem o IDE do AWS Cloud9 para o ambiente existente já aberto. Ao abrir um ambiente o AWS Cloud9 abre o IDE para esse ambiente em um navegador da Web. Para obter mais informações, consulte Abrir um ambiente no AWS Cloud9.

Etapa 1: Instalar a CLI da AWS CLI, o aws-shell ou ambos no ambiente

Nesta etapa, você usará o AWS Cloud9 para instalar a AWS CLI, o aws-shell ou ambos no ambiente para que você possa executar comandos para interagir com a AWS.

Se você estiver usando um ambiente de desenvolvimento EC2 para AWS Cloud9 e só quiser usar a AWS CLI, poderá ir direto para Etapa 3: Executar alguns comandos básicos com a CLI da AWS CLI ou o aws-shell no ambiente. Isso ocorre porque a AWS CLI já está instalada em um ambiente EC2, e um conjunto de credenciais de acesso da AWS já está configurado no ambiente. Para obter mais informações, consulte AWS credenciais temporárias gerenciadas.

Se você não estiver usando um ambiente EC2, faça o seguinte para instalar a AWS CLI:

1. Com o ambiente aberto, no IDE, verifique se a AWS CLI já está instalada. No terminal, execute o comando aws --version . (Para iniciar uma nova sessão de terminal, na barra de menus, selecione Janela, Novo terminal.) Se a AWS CLI estiver instalada, o número da versão será exibido, com informações como os números de versão do Python e do sistema operacional da instância do Amazon EC2 ou do seu próprio servidor. Se a AWS CLI estiver instalada, avance para Etapa 2: Configurar o gerenciamento de credenciais no ambiente.

2. Para instalar a AWS CLI, consulte Instalar a AWS Command Line Interface no Guia do usuário da AWS Command Line Interface. Por exemplo, para um ambiente EC2 executando o Amazon Linux, execute estes três comandos, um de cada vez, no terminal para instalar a AWS CLI.

   sudo yum -y update          # Install the latest system updates.
   sudo yum -y install aws-cli # Install the AWS CLI.
   aws --version               # Confirm the AWS CLI was installed.

   Por exemplo, para um ambiente EC2 que executa o Ubuntu Server, execute estes três comandos, um de cada vez, no terminal para instalar a AWS CLI.

   sudo apt update             # Install the latest system updates.
   sudo apt install -y awscli  # Install the AWS CLI.
   aws --version               # Confirm the AWS CLI was installed.

Para instalar o aws-shell, faça o seguinte:

1. Com o ambiente aberto, no IDE, verifique se o aws-shell já está instalado. No terminal, execute o comando aws-shell . (Para iniciar uma nova sessão de terminal, na barra de menus, selecione Janela, Novo terminal.) Se o aws-shell estiver instalado, a solicitação aws> é exibida. Se o aws-shell estiver instalado, avance para Etapa 2: Configurar o gerenciamento de credenciais no ambiente.

2. Para instalar o aws-shell, use o pip. Para usar o pip, é necessário ter o Python instalado.

   Para verificar se o Python já está instalado (e para instalá-lo, se necessário), siga as instruções em Etapa 1: Instalar o Python no Python Sample (Exemplo do Python) e retorne a este tópico.

   Para verificar se o pip já está instalado, no terminal, execute o comando pip --version . Se o pip estiver instalado, o número da versão é exibido. Se o pip não estiver instalado, instale-o executando estes três comandos, um de cada vez, no terminal.

   wget https://bootstrap.pypa.io/get-pip.py # Get the pip install file.
   sudo python get-pip.py                    # Install pip. (You might need to run 'sudo python2 get-pip.py' or 'sudo python3 get-pip.py' instead, depending on how Python is installed.)
   rm get-pip.py                             # Delete the pip install file, as it is no longer needed.

3. Para usar o pip para instalar o aws-shell, execute o comando a seguir.

   sudo pip install aws-shell

Etapa 2: Configurar o gerenciamento de credenciais no ambiente

Cada vez que você usar a AWS CLI ou o aws-shell para chamar um serviço da AWS, é necessário fornecer um conjunto de credenciais com a chamada. Essas credenciais determinam se a AWS CLI ou o aws-shell possuem as permissões apropriadas para realizar a chamada. Se as credenciais não cobrirem as permissões apropriadas, a chamada falhará.

Se você estiver usando um ambiente de desenvolvimento EC2 para AWS Cloud9, poderá ir direto para Etapa 3: Executar alguns comandos básicos com a CLI da AWS CLI ou o aws-shell no ambiente. Isso ocorre porque as credenciais já estão configuradas em um ambiente EC2. Para obter mais informações, consulte AWS credenciais temporárias gerenciadas.

Se você não estiver usando um ambiente EC2, será necessário armazenar manualmente as credenciais dentro do ambiente. Para fazer isso, siga as instruções em Chamar Serviços da AWS em um ambiente no AWS Cloud9 e retorne a este tópico.

Etapa 3: Executar alguns comandos básicos com a CLI da AWS CLI ou o aws-shell no ambiente

Nesta etapa, você usará a AWS CLI ou o aws-shell no ambiente para criar um bucket no Amazon S3, listar os buckets disponíveis e excluir o bucket.

1. Se deseja usar o aws-shell mas ainda não o iniciou, inicie o aws-shell executando o comando aws-shell. A solicitação aws> é exibida.

2. Criar um bucket. Execute o comando aws s3 mb com a AWS CLI ou o comando s3 mb com o aws-shell, fornecendo o nome do bucket a ser criado. Neste exemplo, usamos um bucket chamado cloud9-123456789012-bucket, em que 123456789012 é o ID da conta da AWS. Se usar um nome diferente, substitua-o ao longo desta etapa.

   aws s3 mb s3://cloud9-123456789012-bucket # For the AWS CLI.
   s3 mb s3://cloud9-123456789012-bucket     # For the aws-shell.

   nota

   Os nomes de buckets devem ser exclusivos em toda a AWS, não apenas em sua conta da AWS. O nome de bucket sugerido anteriormente pode ajudá-lo a criar um nome de bucket único. Se receber uma mensagem que contém o erro BucketAlreadyExists, é necessário executar o comando novamente com um nome de bucket diferente.

3. Liste os buckets disponíveis. Execute o comando aws s3 ls com a AWS CLI ou o comando s3 ls com o aws-shell. Uma lista dos buckets disponíveis será exibida.

4. Excluir o bucket. Execute o comando aws s3 rb com a AWS CLI ou o comando s3 rb com o aws-shell, fornecendo o nome do bucket a ser excluído.

   aws s3 rb s3://cloud9-123456789012-bucket # For the AWS CLI.
   s3 rb s3://cloud9-123456789012-bucket     # For the aws-shell.

   Para confirmar se o bucket foi excluído, execute o comando aws s3 ls novamente com a AWS CLI ou o comando s3 ls novamente com o aws-shell. O nome do bucket que foi excluído não deve mais aparecer na lista.

   nota

   Não é necessário excluir o bucket se quiser continuar a usá-lo. Para obter mais informações, consulte Adicionar um objeto a um bucket no Guia do Amazon Simple Storage Service. Consulte também s3 commands (Comandos do s3) na Referência de comandos da AWS CLI. (Lembre-se de que, se você não excluir o bucket, isso poderá gerar cobranças contínuas em sua conta da AWS.)

Para continuar a testar a AWS CLI, consulte Working with Amazon Web Services (Trabalhar com a Amazon Web Services) no Manual do usuário do AWS Command Line Interface, e também a Referência de comandos da AWS CLI CLI. Para continuar a testar o aws-shell, consulte a AWS CLI Command Reference (Referência de comandos da CLI da AWS), observando que você deve iniciar os comandos com o prefixo aws.

Etapa 4: Limpar

Se estiver usando o aws-shell, você pode parar de usá-lo executando o comando .exit ou .quit .

Para evitar cobranças contínuas em sua conta da AWS, ao terminar de usar este exemplo, exclua o ambiente. Para obter instruções, consulte Excluir um ambiente no AWS Cloud9.