pj

AWS CloudShell: 10 comandos práticos para conhecer seu ambiente

O AWS CloudShell é um terminal acessível pelo navegador, diretamente no Console de Gerenciamento da AWS. Seu diferencial está em possuir o AWS Command Line Interface (AWS CLI) instalado e por utilizar as credenciais da sua sessão, permitindo executar comandos sem instalar ferramentas ou configurar chaves de acesso no seu computador.

Neste artigo, aprenderemos a usar o AWS CloudShell para gerar um inventário de instâncias, encontrar recursos desconectados, investigar eventos e consultar informações de segurança, monitoramento e armazenamento.

Para praticar os dez exemplos, disponibilizei um template do AWS CloudFormation que preparará um ambiente temporário e controlado.

Sumário

Tutorial em vídeo

Preparação do laboratório

Você precisará de uma conta AWS, acesso ao CloudShell e uma identidade com a política AdministratorAccess.

No CloudShell, utilizaremos o Bash, com o AWS CLI e o jq, ferramenta para processar respostas em JSON, disponíveis no ambiente padrão.

  1. Acesse o arquivo lab-cloudshell.yaml no GitHub e utilize a opção Download raw file para baixá-lo.
  2. No console da AWS, selecione Norte da Virgínia (us-east-1).
  3. Abra o AWS CloudFormation, escolha Criar pilha e selecione a opção para fazer upload de um arquivo de modelo.
  4. Envie o arquivo YAML e, na etapa seguinte, informe cloudshell como nome da pilha.
  5. Mantenha os parâmetros padrão. Na etapa de configuração, marque a confirmação de que o CloudFormation pode criar recursos do IAM com nomes personalizados.
  6. Revise as configurações e envie a solicitação.
  7. Aguarde o estado CREATE_COMPLETE. Depois, abra o CloudShell na mesma região para executar os exemplos.
Eventos no AWS CloudFormation
Eventos no AWS CloudFormation

O template prepara uma instância EC2, volumes EBS, um Elastic IP sem associação, funções Lambda, um alarme do CloudWatch e os recursos necessários para a automação. Ele não cria buckets nem arquivos no Amazon S3.

A instância EC2 é parada automaticamente durante a preparação. O template também configura a solicitação de exclusão da pilha para dez minutos após a parada da instância. Confira o horário em Saídas → DeletionTimeUtc, apresentado em UTC. O agendamento tem precisão de um minuto, e a exclusão leva um tempo adicional.

As consultas regionais podem mostrar outros recursos da sua conta, além daqueles criados pelo laboratório. Resultados vazios podem indicar ausência de recursos correspondentes, enquanto erros AccessDenied indicam falta de permissão.

1. Exportar um inventário EC2 para CSV

O primeiro comando lista o identificador, o tipo, o estado e o IP privado das instâncias Amazon EC2 da região atual. O jq organiza a resposta e inclui o cabeçalho no arquivo inventario-ec2.csv.

				
					aws ec2 describe-instances --output json |
jq -r '
  ["ID","Tipo","Estado","IP privado"],
  (.Reservations[].Instances[] |
    [.InstanceId,.InstanceType,.State.Name,.PrivateIpAddress])
  | @csv
' > inventario-ec2.csv
				
			

O arquivo será salvo no diretório atual. Se já existir outro arquivo com o mesmo nome, ele será sobrescrito.

Para visualizar seu conteúdo no terminal, execute:

				
					cat inventario-ec2.csv
				
			

2. Encontrar volumes EBS desconectados

Além de conhecer as instâncias, podemos verificar os volumes Amazon EBS que estão desconectados.

O comando abaixo filtra os volumes no estado available e apresenta seu identificador, tamanho em GiB e tipo.

				
					aws ec2 describe-volumes \
  --filters Name=status,Values=available \
  --query 'Volumes[].{ID:VolumeId,TamanhoGiB:Size,Tipo:VolumeType}' \
  --output table
				
			

O volume adicional de 1 GiB criado pelo laboratório deverá aparecer no resultado.

Exemplo de volume EBS via AWS CloudShell
Exemplo de volume EBS via AWS CloudShell

3. Investigar solicitações de parada de instâncias EC2

Para investigar solicitações de parada, podemos consultar o AWS CloudTrail.

Este comando apresenta os dez eventos StopInstances mais recentes disponíveis no histórico da região, incluindo data, identidade e recursos associados. E o histórico abrange os últimos 90 dias.

				
					aws cloudtrail lookup-events \
  --lookup-attributes AttributeKey=EventName,AttributeValue=StopInstances \
  --max-items 10 \
  --query 'Events[].{Quando:EventTime,Identidade:Username,Recursos:Resources}' \
  --output json
				
			

Neste laboratório, a parada é solicitada pela função Lambda cloudshell-lab.

O evento pode levar alguns minutos para aparecer e permanece no histórico depois da exclusão da pilha.

Exemplo de EC2 via AWS CloudShell
Exemplo de EC2 via AWS CloudShell

4. Localizar regras de entrada abertas para qualquer IP

Também podemos consultar as regras de entrada dos security groups.

O exemplo abaixo encontra regras com origem IPv4 0.0.0.0/0 ou IPv6 ::/0, mostrando o grupo, o protocolo e o intervalo de portas.

				
					aws ec2 describe-security-group-rules \
  --query 'SecurityGroupRules[?IsEgress==`false` && (CidrIpv4==`0.0.0.0/0` || CidrIpv6==`::/0`)].{Grupo:GroupId,Protocolo:IpProtocol,De:FromPort,Ate:ToPort,IPv4:CidrIpv4,IPv6:CidrIpv6}' \
  --output table
				
			

A regra TCP/80 do laboratório deverá aparecer. Entretanto, uma regra aberta, isoladamente, não comprova que o recurso esteja acessível pela internet. Também é necessário considerar rotas, endereços e outros controles de rede.

Neste ambiente, a regra é demonstrativa. A instância não recebe IP público, e a VPC não possui Internet Gateway nem NAT Gateway.

Exemplo de regras abertas com o AWS CloudShell

5. Encontrar Elastic IPs sem associação

Outra consulta útil é identificar Elastic IPs sem associação na região atual. Esses endereços continuam alocados à conta e geram cobrança até serem liberados.

				
					aws ec2 describe-addresses \
  --query 'Addresses[?AssociationId==`null`].{IP:PublicIp,Alocacao:AllocationId}' \
  --output table
				
			

O Elastic IP criado pelo laboratório permanece sem associação para aparecer nesse resultado.

Exemplo de IP elástico via AWS CloudShell
Exemplo de IP elástico via AWS CloudShell

6. Identificar alarmes de métricas em alerta

Para consultar o monitoramento do ambiente, este comando lista os alarmes de métricas do Amazon CloudWatch no estado ALARM, acompanhados do motivo informado pelo serviço.

 
				
					aws cloudwatch describe-alarms \
  --state-value ALARM \
  --query 'MetricAlarms[].{Alarme:AlarmName,Motivo:StateReason}' \
  --output table
				
			

O alarme do laboratório utiliza TreatMissingData: breaching, configuração que trata a ausência de dados como violação. Por isso, ele deve entrar em ALARM após a avaliação, sem representar uma falha real da aplicação.

Esse alarme não envia notificações nem executa ações sobre a instância EC2. A consulta apresenta apenas alarmes de métricas, sem listar alarmes compostos.

Exemplo de alarme via AWS CloudShell
Exemplo de alarme via AWS CloudShell

7. Consultar cotas ajustáveis do Amazon EC2

Além dos recursos existentes, podemos consultar os limites disponíveis.

O comando abaixo utiliza o Service Quotas para listar as cotas ajustáveis do Amazon EC2 com valor maior que zero.

				
					aws service-quotas list-service-quotas \
  --service-code ec2 \
  --query 'Quotas[?Adjustable==`true` && Value>`0`].{Cota:QuotaName,Valor:Value,Ajustavel:Adjustable}' \
  --output table --no-cli-pager
				
			

Os valores representam limites disponibilizados pelo serviço, e não o consumo atual dos recursos.

Essa consulta também não solicita aumentos nem altera as cotas da conta.

Exemplo de cotas via AWS CloudShell
Exemplo de cotas via AWS CloudShell

8. Encontrar os dez maiores objetos de cada bucket S3

No Amazon S3, o script abaixo descobre os buckets de uso geral da conta e apresenta até dez objetos de maior tamanho em cada um.

				
					(
  set -euo pipefail

  buckets=$(
    aws s3api list-buckets \
      --output json \
      --no-cli-pager
  )

  if [ "$(jq '.Buckets | length' <<< "$buckets")" -eq 0 ]; then
    printf 'Nenhum bucket encontrado.\n'
    exit 0
  fi

  while IFS= read -r bucket; do
    printf '\nBucket: %s\n' "$bucket"

    if objetos=$(
      aws s3api list-objects-v2 \
        --bucket "$bucket" \
        --output json \
        --no-cli-pager
    ); then
      jq '
        (.Contents // []) |
        sort_by(.Size) |
        reverse |
        .[:10] |
        map({
          Arquivo: .Key,
          TamanhoMiB: ((.Size / 1048576 * 100 | round) / 100)
        })
      ' <<< "$objetos"
    else
      printf 'Não foi possível consultar este bucket.\n'
    fi
  done < <(jq -r '.Buckets[].Name' <<< "$buckets")
)
				
			

O resultado apresenta os tamanhos em MiB e considera os objetos atuais, sem incluir versões anteriores nem uploads multipart incompletos. Buckets vazios retornam []. Se uma consulta falhar, o script informa o problema e continua para o próximo bucket.

Diferentemente das consultas regionais anteriores, este exemplo pode consultar buckets de outras regiões, conforme as permissões da identidade utilizada. Ele consulta metadados, sem baixar os arquivos, e não contempla buckets de diretório.

Exemplo de listagem S3 via AWS CloudShell
Exemplo de listagem S3 via AWS CloudShell

9. Conferir os runtimes das funções Lambda

Voltando aos recursos regionais, podemos listar as funções do AWS Lambda para conferir o nome, o runtime, que identifica o ambiente de execução, e a memória configurada.

				
					aws lambda list-functions \
  --query 'Functions[].{Funcao:FunctionName,Runtime:Runtime,MemoriaMB:MemorySize}' \
  --output table
				
			

No laboratório, a listagem apresentará a função demonstrativa e a função de preparação, ambas com Node.js 22 e 128 MB de memória.

Funções implantadas como imagens de contêiner podem não preencher o campo Runtime.

Exemplo Lambda via AWS CloudShell
Exemplo Lambda via AWS CloudShell

10. Verificar o estado das stacks do CloudFormation

Por fim, este comando apresenta os nomes e os estados das pilhas do AWS CloudFormation existentes na região atual.

				
					aws cloudformation describe-stacks \
  --query 'Stacks[].{Stack:StackName,Estado:StackStatus}' \
  --output table
				
			

Durante os testes, a pilha cloudshell deve aparecer como CREATE_COMPLETE.

Quando a limpeza começar, poderá aparecer como DELETE_IN_PROGRESS. Depois que a exclusão terminar, ela deixará de aparecer nessa consulta.

Exemplo de pilha CloudFormation via AWS CloudShell
Exemplo de pilha CloudFormation via AWS CloudShell

Exclusão do laboratório

Ao concluir os exemplos, exclua a pilha pelo CloudFormation ou pelo CloudShell.

No console, selecione a região us-east-1, abra o CloudFormation, selecione a pilha cloudshell e escolha Excluir. Aguarde a conclusão.

Pelo CloudShell, solicite a exclusão com:

				
					aws cloudformation delete-stack \
  --stack-name cloudshell \
  --region us-east-1
				
			

Depois, acompanhe a conclusão:

				
					aws cloudformation wait stack-delete-complete \
  --stack-name cloudshell \
  --region us-east-1
				
			

O comando de espera não apresenta progresso e retorna sem erro quando a exclusão termina. Se houver falha, consulte os eventos da pilha no console e corrija a causa antes de considerar a limpeza concluída.

A função IAM cloudshell-exclusao-cfn possui DeletionPolicy: Retain, preservando as permissões necessárias enquanto a exclusão ocorre. Por isso, ela e sua política inline permanecem após a remoção da pilha.

				
					aws cloudformation wait stack-delete-complete \
  --stack-name cloudshell \
  --region us-east-1 &&
aws iam delete-role-policy \
  --role-name cloudshell-exclusao-cfn \
  --policy-name CleanupLab &&
aws iam delete-role \
  --role-name cloudshell-exclusao-cfn
				
			

Esses comandos consideram que a pilha foi criada com o nome cloudshell. Remova a função retida antes de recriar o laboratório com o mesmo nome, evitando conflito.

Conclusão

Com esses dez exemplos, vimos como o AWS CloudShell pode ser uma alternativa prática para gerar relatórios e observar o ambiente por meio de consultas no terminal. Para solicitações específicas e pontuais, ele permite reunir informações úteis sem preparar ferramentas no computador.

Seu ambiente computacional é efêmero, mas o CloudShell padrão oferece armazenamento persistente no diretório $HOME. Isso permite preservar arquivos, como o inventário em CSV, entre sessões, respeitando as condições de retenção do serviço.

Minha recomendação é aproveitar esses comandos como ponto de partida para consultas que façam sentido no seu ambiente, observando as permissões e o alcance de cada exemplo. O template, os comandos e as orientações para resolver erros estão disponíveis no repositório AWS CloudShell: 10 comandos práticos.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Artigos Relacionados

Continue aprendendo com nosso conteúdo especializado

Como conquistei os selos de 90 dias no AWS Builder Center

Nessa noite, conquistei os dois selos que considero mais difíceis no AWS Builder Center: sequência de 90

RAG ou Ajuste Fino: diferenças e quando usar cada um

Criar uma aplicação de inteligência artificial inicia com a escolha de um LLM (Large Language Model ou

Jev: O modelo de IA que toma decisões sem gerar texto

No dia 15 de setembro de 2026, a TypeSafe AI anunciou o Jev, um modelo de inteligência