Pré-requisitos Conteúdo Etapa 1: faça login em AWS Management Console Etapa 2: selecione uma região AWS CloudShell, inicie e escolha um shell Etapa 3: baixar um arquivo do AWS CloudShell Etapa 4: fazer upload de um arquivo para AWS CloudShell Etapa 5: Remover um arquivo do AWS CloudShell Etapa 6: criar um backup do diretório inicial Etapa 7: reiniciar uma sessão de shell Etapa 8: excluir um diretório inicial da sessão de shell Etapa 9: editar o código do seu arquivo e executá-lo usando a linha de comando Etapa 10: Use AWS CLI para adicionar o arquivo como um objeto em um bucket do Amazon S3 Tópicos relacionados

Começando com AWS CloudShell

Este tutorial introdutório mostra como iniciar AWS CloudShell e executar tarefas importantes usando a interface de linha de comando do shell.

Primeiro, você faz login no AWS Management Console e seleciona um Região da AWS. Em seguida, você inicia CloudShell em uma nova janela do navegador e em um tipo de shell com o qual trabalhar.

Depois, você cria uma nova pasta no seu diretório inicial e carrega um arquivo nela a partir da sua máquina local. Você trabalha nesse arquivo usando um editor pré-instalado antes de executá-lo como um programa na linha de comando. Por fim, você chama AWS CLI comandos para criar um bucket do Amazon S3 e adicionar seu arquivo como um objeto ao bucket.

Pré-requisitos

Permissões do IAM

Você pode obter permissões AWS CloudShell anexando a seguinte política AWS gerenciada à sua identidade do IAM (como usuário, função ou grupo):

AWSCloudShellFullAccess: fornece aos usuários acesso total AWS CloudShell a seus recursos.

Neste tutorial, você também interage com Serviços da AWS. Mais especificamente, você interage com o Amazon S3 criando um bucket do S3 e adicionando um objeto a esse bucket. Sua identidade do IAM exige uma política que conceda, no mínimo, as permissões s3:CreateBucket e s3:PutObject.

Para obter mais informações, consulte Ações do Amazon S3 no Guia do usuário do Amazon Simple Storage Service.

Arquivo de exercícios

Esse exercício também envolve carregar e editar um arquivo que é executado como um programa a partir da interface da linha de comando. Abra um editor de texto na máquina local e adicione o seguinte trecho de código.


import sys
x=int(sys.argv[1])
y=int(sys.argv[2])
sum=x+y
print("The sum is",sum)

Salve o arquivo com o nome add_prog.py.

Conteúdo

Etapa 1: faça login em AWS Management Console
Etapa 2: selecione uma região AWS CloudShell, inicie e escolha um shell
Etapa 3: baixar um arquivo do AWS CloudShell
Etapa 4: fazer upload de um arquivo para AWS CloudShell
Etapa 5: Remover um arquivo do AWS CloudShell
Etapa 6: criar um backup do diretório inicial
Etapa 7: reiniciar uma sessão de shell
Etapa 8: excluir um diretório inicial da sessão de shell
Etapa 9: editar o código do seu arquivo e executá-lo na linha de comando
Etapa 10: Use AWS CLI para adicionar o arquivo como um objeto em um bucket do Amazon S3

Etapa 1: faça login em AWS Management Console

Essa etapa envolve a inserção das informações do usuário do IAM para acessar AWS Management Console o. Se você já estiver no console, vá para a etapa 2.

Você pode acessar o AWS Management Console usando uma URL de login de usuários do IAM ou acessando a página principal de login.
IAM user sign-in URL
Abra um navegador e insira o seguinte URL de login. Substitua account_alias_or_id pelo alias ou ID da conta que seu administrador forneceu.

https://account_alias_or_id.signin.aws.amazon.com/console/

Insira suas credenciais de login do IAM e escolha Sign in (Entrar).
Main sign-in page
Abra https://aws.amazon.com/console/.

Se você não fez login anteriormente usando esse navegador, a página principal de login será exibida. Escolha IAM user (Usuário do IAM), insira o alias ou o ID da conta e escolha Next (Próximo).

Se você já fez login como usuário do IAM. Talvez o seu navegador se lembre do alias ou do ID da conta da Conta da AWS. Nesse caso, insira suas credenciais de login do IAM e escolha Sign in (Entrar).
nota
Você também pode fazer login como usuário raiz. Essa identidade tem acesso completo a todos Serviços da AWS os recursos da conta. Recomendamos não usar o usuário raiz para suas tarefas diárias, nem mesmo as administrativas. Em vez disso, siga as práticas recomendadas sobre utilização de usuário raiz somente para criar seu primeiro usuário do IAM.

Etapa 2: selecione uma região AWS CloudShell, inicie e escolha um shell

Nesta etapa, você inicia a AWS CloudShell partir da interface do console, escolhe um disponível Região da AWS e alterna para o shell de sua preferênciaBash, como PowerShell, ouZ shell.

Para escolher uma Região da AWS para trabalhar, acesse o menu Selecionar uma região e selecione uma AWS região suportada para trabalhar. (As regiões disponíveis estão em destaque.)

Importante
Se você alternar entre regiões, a interface será atualizada e o nome da Região da AWS selecionada será exibido acima do texto da linha de comando. Todos os arquivos que você adiciona ao armazenamento persistente estão disponíveis somente nessa mesma Região da AWS. Se você alterar as regiões, diferentes armazenamentos e arquivos estarão acessíveis.

Importante
Se CloudShell não estiver disponível na região selecionada quando você iniciar CloudShell noConsole Toolbar, no canto inferior esquerdo do console, a região padrão será definida como a região mais próxima da região selecionada. Você pode executar o comando que fornece permissões para gerenciar recursos em uma região diferente da região padrão. Para obter mais informações, consulte Trabalhando em Regiões da AWS.
Exemplo
Se você escolher Europa (Espanha)eu-south-2, mas CloudShell não estiver disponível na Europa (Espanha)eu-south-2, a Região padrão será definida como Europa (Irlanda)eu-west-1, que é a mais próxima da Europa (Espanha)eu-south-2.
Você usará as cotas de serviço para a região padrão, Europa (Irlanda), eu-west-1 e a mesma CloudShell sessão será restaurada em todas as regiões. A região padrão pode ser alterada e você será notificado na janela do CloudShell navegador.
A partir do AWS Management Console, você pode iniciar CloudShell escolhendo uma das seguintes opções:
1. Na barra de navegação, escolha o CloudShellícone.
2. Na caixa Pesquisar, digite “CloudShell” e escolha CloudShell.
3. No widget Visitado recentemente, escolha CloudShell.
4. Escolha CloudShellnoConsole Toolbar, no canto inferior esquerdo do console.
  - Para ajustar a altura da CloudShell sessão, arraste=.
  - Para mudar sua CloudShell sessão para tela cheia, clique no ícone Abrir na nova guia do navegador.
Quando o prompt de comando for exibido, o shell estará pronto para interação.

nota
Se você encontrar problemas que o impeçam de iniciar ou interagir com sucesso AWS CloudShell, verifique as informações para identificar e resolver esses problemas emSolução de problemas AWS CloudShell.
Para escolher um shell pré-instalado com o qual trabalhar, digite o nome de programa no prompt da linha de comando.

Bash

bash

Se você alternar para o Bash, o símbolo no prompt de comando será atualizado para $.

nota
Bashé o shell padrão que está sendo executado quando você inicia AWS CloudShell.

PowerShell

pwsh

Se você mudar para PowerShell, o símbolo no prompt de comando será atualizado paraPS>.

Z shell

zsh

Se você alternar para o Z shell, o símbolo no prompt de comando será atualizado para %.

Para obter informações sobre as versões pré-instaladas em seu ambiente de shell, consulte a tabela de shells na seção de ambiente CloudShell computacional da AWS.

Etapa 3: baixar um arquivo do AWS CloudShell

nota

Essa opção não está disponível para ambientes VPC.

Esta etapa orienta você no processo de download de um arquivo.

Para baixar um arquivo, acesse Ações e escolha Baixar arquivo no menu.

A caixa de diálogo Baixar arquivo é exibida.
Na caixa de diálogo Baixar arquivo, insira o caminho do arquivo a ser baixado.
nota
Você pode usar caminhos absolutos ou relativos ao especificar um arquivo para download. Com nomes de caminhos relativos, /home/cloudshell-user/ é adicionado automaticamente ao início por padrão. Portanto, para baixar um arquivo chamado mydownload-file, os dois caminhos a seguir são válidos:
- Caminho absoluto: /home/cloudshell-user/subfolder/mydownloadfile.txt
- Caminho relativo: subfolder/mydownloadfile.txt
Escolha Baixar.

Se o caminho do arquivo estiver correto, uma caixa de diálogo será exibida. Use essa caixa de diálogo para abrir o arquivo com o aplicativo padrão. Ou salve o arquivo em uma pasta na sua máquina local.

nota

A opção Download não está disponível quando você inicia CloudShell noConsole Toolbar. Você pode baixar um arquivo do CloudShell console ou usando o navegador Chrome. Para obter mais informações sobre como baixar um arquivo, consulte Etapa 3: Baixar um arquivo do AWS CloudShell.

Etapa 4: fazer upload de um arquivo para AWS CloudShell

nota

Essa opção não está disponível para ambientes VPC.

Esta etapa descreve como fazer upload de um arquivo e, em seguida, movê-lo para um novo diretório em seu diretório inicial.

Para verificar seu diretório de trabalho atual, no prompt, digite o seguinte comando:

pwd

Quando você pressiona Enter, o shell retorna seu diretório de trabalho atual (por exemplo, /home/cloudshell-user).
Para fazer upload de um arquivo para esse diretório, acesse Ações e escolha Carregar arquivo no menu.

A caixa de diálogo Carregar arquivo é exibida.
Escolha Navegar.
Na caixa de diálogo Upload de arquivo do seu sistema, selecione o arquivo de texto que você criou para este tutorial (add_prog.py) e escolha Abrir.
Na caixa de diálogo Carregar arquivo, escolha Carregar.

Uma barra de progresso rastreia o upload. Se o upload for bem-sucedido, uma mensagem confirmará que add_prog.py foi adicionado à raiz do seu diretório inicial.
Para criar um diretório para o arquivo, digite o comando make directories: mkdir mysub_dir.
Para mover o arquivo carregado da raiz do seu diretório inicial para o novo diretório, use o comando mv:

mv add_prog.py mysub_dir.
Para alterar seu diretório de trabalho para o novo diretório, digite cd mysub_dir.

O prompt de comando é atualizado para indicar que você alterou seu diretório de trabalho.
Para visualizar o conteúdo do diretório atual, mysub_dir, digite o comando ls.

O conteúdo do diretório de trabalho está listado. Isso inclui o arquivo que você acabou de carregar.

Etapa 5: Remover um arquivo do AWS CloudShell

Esta etapa descreve como remover um arquivo do AWS CloudShell.

Para remover um arquivo do AWS CloudShell, use comandos de shell padrão, como rm (remove).

rm my-file-for-removal
Para remover vários arquivos que atendam aos critérios especificados, execute o comando find.

O exemplo a seguir remove todos os arquivos que incluem o sufixo “.pdf” em seus nomes.
```
find -type f -name '*.pdf' -delete
```

nota

Suponha que você pare de usar AWS CloudShell em um específico Região da AWS. Em seguida, os dados que estão no armazenamento persistente dessa região são removidos automaticamente após um período especificado. Para obter informações, consulte Armazenamento persistente.

Etapa 6: criar um backup do diretório inicial

Crie um arquivo de backup

Crie uma pasta temporária fora do diretório inicial.


HOME_BACKUP_DIR=$(mktemp --directory)

Você pode usar uma das seguintes opções para criar um backup:

Criar um arquivo de backup usando tar

Para criar um arquivo de backup usando tar, insira o seguinte comando:


tar \
    --create \
    --gzip \
    --verbose \
    --file=${HOME_BACKUP_DIR}/home.tar.gz \
    [--exclude ${HOME}/.cache] \ // Optional
    ${HOME}/
echo "Home directory backed up to this file: ${HOME_BACKUP_DIR}/home.tar.gz"

Criar um arquivo de backup usando zip

Para criar um arquivo de backup usando zip, insira o seguinte comando:


zip \
    --recurse-paths \
    ${HOME_BACKUP_DIR}/home.zip \
    ${HOME} \
    [--exclude ${HOME}/.cache/\*] // Optional
echo "Home directory backed up to this file: ${HOME_BACKUP_DIR}/home.zip"

Transferir o arquivo de backup para fora CloudShell

Você pode usar uma das seguintes opções para transferir o arquivo de backup para fora CloudShell:
1. Baixar o arquivo de backup em sua máquina local
  
  Você pode baixar o arquivo criado na etapa anterior. Para obter mais informações sobre como baixar um arquivo do CloudShell, consulte Baixar um arquivo do AWS CloudShell.
  
  Na caixa de diálogo do arquivo de download, insira o caminho do arquivo a ser baixado (por exemplo, /tmp/tmp.iA99tD9L98/home.tar.gz).
2. Transferir o arquivo de backup para o S3
  
  Para gerar um bucket, insira este comando:
```
aws s3 mb s3://${BUCKET_NAME}
```
  Use o AWS CLI para copiar o arquivo para o bucket do S3:
```
aws s3 cp ${HOME_BACKUP_DIR}/home.tar.gz s3://${BUCKET_NAME}
```
  nota
  Taxas de transferência de dados podem ser aplicadas.
Fazer backup diretamente em um bucket do S3

Para fazer backup diretamente em um bucket do S3, insira o seguinte comando:
```
aws s3 cp \
    ${HOME}/ \
    s3://${BUCKET_NAME} \
    --recursive \
    [--exclude .cache/\*] // Optional
```

Etapa 7: reiniciar uma sessão de shell

nota

Como medida de segurança, se você não interagir com o shell usando o teclado ou o ponteiro por um longo período, a sessão será interrompida automaticamente. Sessões de longa execução também são interrompidas automaticamente. Para ter mais informações, consulte Sessões de shell.

Para reiniciar uma sessão de shell, escolha Ações, Reiniciar AWS CloudShell.

Você é notificado de que a reinicialização AWS CloudShell interrompe todas as sessões ativas na atual Região da AWS.
Para confirmar, escolha Reiniciar.

Uma interface exibe uma mensagem de que o ambiente CloudShell computacional está parando. Depois que o ambiente for interrompido e reiniciado, você poderá começar a trabalhar com a linha de comando em uma nova sessão.

nota
Em alguns casos, pode levar alguns minutos para que o ambiente seja reiniciado.

Etapa 8: excluir um diretório inicial da sessão de shell

nota

Essa opção não está disponível para ambientes VPC. Quando você reinicia um ambiente VPC, seu diretório inicial é excluído.

Atenção

Excluir seu diretório inicial é uma ação irreversível em que todos os dados armazenados em seu diretório inicial são excluídos permanentemente. No entanto, considere essa opção nas seguintes situações:

Você modificou um arquivo incorretamente e não consegue acessar o ambiente AWS CloudShell computacional. A exclusão do seu diretório pessoal retorna AWS CloudShell às configurações padrão.
Você deseja remover todos os seus dados AWS CloudShell imediatamente. Se você parar de usar AWS CloudShell em uma AWS região, o armazenamento persistente será automaticamente excluído no final do período de retenção, a menos que você inicie AWS CloudShell novamente na região.

Se você precisar de armazenamento de longo prazo para seus arquivos, considere um serviço como o Amazon S3 ou. CodeCommit

Para excluir uma sessão de shell, escolha Ações, Excluir diretório CloudShell inicial da AWS.

Você é notificado de que a exclusão do diretório AWS CloudShell inicial exclui todos os dados atualmente armazenados em seu AWS CloudShell ambiente.

nota
Não é possível desfazer essa ação.
Para confirmar a exclusão, insira excluir no campo de entrada de texto e selecione Excluir.

A AWS CloudShell interrompe todas as sessões ativas na atual Região da AWS e cria um novo ambiente imediatamente.

Para sair manualmente das sessões do shell

Com a linha de comando, você pode sair de uma sessão de shell e fazer logout usando o comando exit. Em seguida, pressione qualquer tecla para se reconectar e continuar usando o AWS CloudShell.

Etapa 9: editar o código do seu arquivo e executá-lo usando a linha de comando

Esta etapa demonstra como usar o editor Vim pré-instalado para trabalhar com um arquivo. Em seguida, execute esse arquivo como programa da linha de comando.

Para editar o arquivo que você carregou na etapa anterior, insira o seguinte comando:
vim add_prog.py

A interface do shell é atualizada para exibir o editor do Vim.
Para editar o arquivo no Vim, pressione a tecla I. Agora edite o conteúdo para que o programa some três números em vez de dois.
```
import sys
x=int(sys.argv[1])
y=int(sys.argv[2])
z=int(sys.argv[3])
sum=x+y+z
print("The sum is",sum)
```
nota
Se você colar o texto no editor e tiver o atributo Safe Paste ativado, um aviso será exibido. O texto de várias linhas copiado pode conter scripts maliciosos. Com o atributo Safe Paste, é possível verificar o texto completo antes de colá-lo. Se você estiver convencido de que o texto é seguro, escolha Colar.
Depois de editar o programa, pressione Esc para inserir o modo de comando Vim. Em seguida, insira o comando :wq para salvar o arquivo e sair do editor.

nota
Se você é novo no modo de comando Vim, inicialmente poderá achar difícil alternar entre o modo de comando e o modo de inserção. O modo de comando é usado ao salvar arquivos e sair do aplicativo. O modo de inserção é usado ao inserir um novo texto. Para entrar no modo de inserção, pressione I e, para entrar no modo de comando, pressione Esc. Para obter mais informações Vim e outras ferramentas disponíveis em AWS CloudShell, consulteFerramentas de desenvolvimento e utilitários de shell.
Na interface da linha de comando principal, execute o programa a seguir e especifique três números para entrada. A sintaxe é a seguinte.

python3 add_prog.py 4 5 6

A linha de comando exibe a saída do programa: The sum is 15.

Etapa 10: Use AWS CLI para adicionar o arquivo como um objeto em um bucket do Amazon S3

Nesta etapa, você cria um bucket do Amazon S3 e, em seguida, usa o PutObjectmétodo para adicionar seu arquivo de código como um objeto nesse bucket.

nota

Na maioria dos casos, você pode usar um serviço, como CodeCommit confirmar um arquivo de software em um repositório com controle de versão. Este tutorial mostra como você pode usá-lo AWS CLI AWS CloudShell para interagir com outros serviços da AWS. Usando este método, não é necessário baixar nem instalar nenhum recurso adicional. Além disso, como você já está autenticado no shell, não precisará configurar as credenciais antes de fazer chamadas.

Para criar um bucket em um determinado local Região da AWS, digite o seguinte comando:
```
aws s3api create-bucket --bucket insert-unique-bucket-name-here --region us-east-1
```
nota
Se você estiver criando um bucket fora da us-east-1 Region, adicione create-bucket-configuration com o parâmetro LocationConstraint para especificar a região. Veja a seguir um exemplo de sintaxe.
```
$ aws s3api create-bucket --bucket my-bucket --region eu-west-1 --create-bucket-configuration LocationConstraint=eu-west-1
```
Se a chamada tiver êxito, a linha de comando exibirá uma resposta do serviço semelhante à seguinte saída.
```
{
    "Location": "/insert-unique-bucket-name-here"
}                    
```
nota
Se você não seguir as regras de nomeação de intervalos, o seguinte erro será exibido: Ocorreu um erro (InvalidBucketName) ao chamar a CreateBucket operação: O intervalo especificado não é válido.
Para fazer upload de um arquivo e adicioná-lo como um objeto ao bucket que você acabou de criar, chame o método PutObject.
```
aws s3api put-object --bucket insert-unique-bucket-name-here --key add_prog --body add_prog.py
```
Depois que o objeto é carregado no bucket do Amazon S3, a linha de comando exibe uma resposta do serviço semelhante à seguinte saída:
```
{"ETag": "\"ab123c1:w:wad4a567d8bfd9a1234ebeea56\""}
```
O ETag é o hash do objeto que foi armazenado. Você pode usar esse hash para verificar a integridade do objeto carregado no Amazon S3.

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

Perguntas frequentes

Tutoriais

Começando com AWS CloudShell

Pré-requisitos

Conteúdo

Etapa 1: faça login em AWS Management Console

nota

Etapa 2: selecione uma região AWS CloudShell, inicie e escolha um shell

Importante

Importante

nota

nota

Etapa 3: baixar um arquivo do AWS CloudShell

nota

nota

nota

Etapa 4: fazer upload de um arquivo para AWS CloudShell

nota

Etapa 5: Remover um arquivo do AWS CloudShell

nota

Etapa 6: criar um backup do diretório inicial

nota

Etapa 7: reiniciar uma sessão de shell

nota

nota

Etapa 8: excluir um diretório inicial da sessão de shell

nota

Atenção

nota

Etapa 9: editar o código do seu arquivo e executá-lo usando a linha de comando

nota

nota

Etapa 10: Use AWS CLI para adicionar o arquivo como um objeto em um bucket do Amazon S3

nota

nota

nota

Tópicos relacionados