CloudConsole

Run Command: rodar um comando de shell nas suas instâncias

Rode df -h, free -m ou qualquer comando em instâncias EC2 gerenciadas pelo Systems Manager, acompanhe ao vivo e leia a saída.

Abra Services → Systems Manager → Run Command, ou More → Run command em uma instância EC2 (ela já vem escolhida).

Resultado do Run Command: df -h deu certo em web-1 e checkout-api-1, com o código de saída e a saída de cada instância
Saída por instância
  1. Escolha as instâncias. A lista mostra o status de ping, a plataforma e a versão do SSM Agent de cada instância gerenciada. Instâncias cujo agente não está conectado não podem ser escolhidas.
  2. Digite os comandos, um por linha, ou toque em um atalho: Disk (df -h), Memory (free -m), Uptime, Service status (systemctl status <service>: troque o marcador), principais processos, erros recentes. Instâncias Windows recebem atalhos de PowerShell e AWS-RunPowerShellScript; as Linux, AWS-RunShellScript.
  3. Rode. É uma ação Pro e passa pela sua proteção. Em uma conta cujo nome parece de produção (prod, production, live), você sempre digita o nome da conta para confirmar.

A tela do comando se atualiza a cada poucos segundos até todas as instâncias terminarem e então mostra o código de saída, a saída e os erros de cada uma. A API guarda os primeiros 24.000 caracteres de cada; para mais, o comando precisa de saída para um bucket do S3 ou para o CloudWatch Logs, que a tela vincula quando configurada. Recent commands lista os últimos comandos, com os resultados.

Instâncias não gerenciadas

Instâncias EC2 em execução que faltam no Systems Manager aparecem com o motivo provável: No instance profile (anexe uma função com AmazonSSMManagedInstanceCore) ou SSM agent not connected (falta essa política na função, o agente está parado ou a instância não alcança os endpoints do SSM pela internet nem por endpoints de VPC).

Permissões

O quêAções do IAMEm ReadOnlyAccess / ViewOnlyAccess
Instâncias gerenciadasssm:DescribeInstanceInformation (e ec2:DescribeInstances para a lista das não gerenciadas)Sim / Não (adicione)
Comandos recentes, status e saídassm:ListCommands, ssm:ListCommandInvocations, ssm:GetCommandInvocationSim / Não (adicione)
Runssm:SendCommand no documento e nas instânciasNão / Não

Perguntas frequentes

Abre uma sessão de shell?

Não. O Run Command envia os comandos e devolve a saída; nada fica aberto. Para uma sessão interativa, use Copy SSM session command na instância e rode no seu computador.

Ainda com dúvidas?

Escreva para [email protected] contando o que você tentou e qual mensagem o app mostrou. Não envie chaves de acesso nem segredos. Respondemos em até dois dias úteis.