Como faço para instalar o SSM Agent em uma instância do Windows do Amazon EC2 na execução?

Breve descrição

O SSM Agent é pré-instalado em instâncias que você cria a partir de imagens de máquina da Amazon (AMIs) com os seguintes sistemas operacionais do Windows Server:

• AMIs do Windows Server 2012 R2 publicadas em novembro de 2016 ou posteriormente
• Windows Server 2016, 2019, 2022 (excluindo as versões Nano) e 2025

Para obter mais informações, consulte Encontrar AMIs com o SSM Agent pré-instalado.

Você deve instalar manualmente o SSM Agent nas instâncias que criou a partir de outras versões das AMIs do Windows, incluindo imagens importadas para a AWS.

É possível instalar o SSM Agent em várias instâncias existentes do Amazon EC2. Para instalar o SSM Agent em um único nó, adicione os dados do usuário a uma instância do Amazon EC2 Windows antes de executar a instância. Para atualizar automaticamente o SSM Agent, ative a atualização automática do SSM Agent nas configurações do Fleet Manager, um recurso do AWS Systems Manager.

Resolução

Pré-requisito: antes de instalar o SSM Agent, verifique se seu sistema operacional é compatível com o Systems Manager e se você configurou o Systems Manager corretamente.

É uma prática recomendada verificar e status do SSM Agent antes de usar o Systems Manager em uma instância pela primeira vez. Para obter instruções, consulte Verificar o status do SSM Agent.

Instale o SSM Agent em várias instâncias

É possível atualizar automaticamente o SSM Agent em mais de uma instância depois de executar essas instâncias. Para obter instruções, consulte Automatizar a instalação do agente AWS Systems Manager em nós não gerenciados do Amazon EC2.

Adicione dados do usuário para instalar o SSM Agent em uma nova instância

Para Windows, siga o seguinte procedimento:

1. Crie um perfil de instância do AWS Identity and Access Management (AWS IAM) para usar com o SSM Agent.
2. Execute uma nova instância EC2 e, em seguida, configure os parâmetros da instância, como imagens da aplicação e do sistema operacional, tipo de instância, par de chaves, configurações de rede e armazenamento.
3. Expanda a seção Detalhes avançados e, em seguida, selecione o perfil de instância que você criou na etapa 1 na lista suspensa Perfil de instância do IAM.
4. Na caixa Dados do usuário, insira o seguinte script do PowerShell:

   <powershell>$dir = $env:TEMP + "\ssm"  
   New-Item -ItemType directory -Path $dir -Force  
   cd $dir  
   (New-Object System.Net.WebClient).DownloadFile("https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/windows_amd64/AmazonSSMAgentSetup.exe", $dir + "\AmazonSSMAgentSetup.exe")  
   Start-Process .\AmazonSSMAgentSetup.exe -ArgumentList @("/q", "/log", "install.log") -Wait  
   </powershell>

   Para obter mais informações sobre dados do usuário, consulte Dados do usuário no Console de gerenciamento da AWS.
5. Em Resumo, insira o número de instâncias que você deseja executar.
6. Clique em Executar instância.

Para Linux, consulte Como faço para instalar o SSM Agent em uma instância do Linux do Amazon EC2 na execução?

Ative e agende atualizações automáticas do SSM Agent

Para obter instruções sobre como atualizar automaticamente o SSM Agent, consulte Atualização automática do SSM Agent.

Por padrão, o Systems Manager verifica as atualizações automáticas do SSM Agent a cada 14 dias. Para configurar um período de tempo diferente, acesse a área de Atualização automática do agente e selecione Atualizar automaticamente o SSM Agent. Em seguida, em Especificar programação, use a opção Conforme programação para definir a programação atualizada.

Observação: é possível especificar uma programação como uma entrada baseada em tempo, chamada expressão cron, ou como uma entrada baseada em frequência, chamada expressão rate. Para obter mais informações, consulte Expressões cron e rate para associações.

Informações relacionadas

Instalação e desinstalação manual do SSM Agent em instâncias do EC2 para Windows Server

Configurar o SSM Agent para usar um proxy para instâncias do Windows Server

O que é o AWS Systems Manager?

Trabalhar com o SSM Agent em instâncias do EC2 para Windows Server