O AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais
AWS CLI 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:
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 Preço do Amazon EC2
Tópicos
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 ter mais informações, consulte Criar um ambiente no 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 ter 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 ter mais informações, consulte Credenciais temporárias gerenciadas pela AWS.
Se você não estiver usando um ambiente EC2, faça o seguinte para instalar a AWS CLI:
-
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. -
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:
-
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çãoaws>
é exibida. Se o aws-shell estiver instalado, avance para Etapa 2: Configurar o gerenciamento de credenciais no ambiente. -
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.
-
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 ter mais informações, consulte Credenciais temporárias gerenciadas pela AWS.
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.
-
Se deseja usar o aws-shell mas ainda não o iniciou, inicie o aws-shell executando o comando
aws-shell
. A solicitaçãoaws>
é exibida. -
Crie um bucket. Execute o comando
aws s3 mb
com a AWS CLI ou o comandos3 mb
com o aws-shell, fornecendo o nome do bucket a ser criado. Neste exemplo, usamos um bucket chamadocloud9-123456789012-bucket
, em que123456789012
é 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. -
Liste os buckets disponíveis. Execute o comando
aws s3 ls
com a AWS CLI ou o comandos3 ls
com o aws-shell. Uma lista dos buckets disponíveis será exibida. -
Excluir o bucket. Execute o comando
aws s3 rb
com a AWS CLI ou o comandos3 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 comandos3 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.