Encontrar AMIs com o SSM Agent pré-instalado - AWS Systems Manager
Verifique o status do SSM Agent

Encontrar AMIs com o SSM Agent pré-instalado

O AWS Systems Manager Agent (SSM Agent) está pré-instalado em alguns Amazon Machine Images (AMIs) fornecidos pela AWS e por terceiros confiáveis.

Por exemplo, ao iniciar uma instância do Amazon Elastic Compute Cloud (Amazon EC2) criada de uma AMI com um dos seguintes sistemas operacionais, você provavelmente descobrirá que o SSM Agent já está instalado:

  • AlmaLinux

  • AMIs base do Amazon Linux 1 datadas de 9/2017 e posteriores

  • Amazon Linux 2

  • AMIs da Base otimizada para ECS do Amazon Linux 2

  • Amazon Linux 2023 (AL2023)

  • AMIs do Amazon Linux otimizadas para Amazon EKS

  • macOS 10,14.x (Mojave), 10,15.x (Catalina), 11.x (Big Sur), 12.x (Monterey), 13.x (Ventura) e 14.x (Sonoma)

  • SUSE Linux Enterprise Server (SLES) 12 e 15

  • Ubuntu Server 16.04, 18.04, 20.04 e 22.04

  • Windows Server 2008-2012 R2 AMIs publicadas em novembro de 2016 ou mais tarde

  • Windows Server 2016, 2019 e 2022 (excluindo versões Nano)

nota

A versão do SSM Agent pré-instalada em um AMI pode não ser a versão mais recente disponível. Como prática recomendada, use sempre a versão mais recente do SSM Agent em seus nós gerenciados. Para obter mais informações sobre automatização das atualizações do SSM Agent, consulte Automatizar atualizações do SSM Agent.

O SSM Agent pode estar pré-instalado em AMIs gerenciadas pela AWS que não estejam nesta lista. Isso normalmente indica que não haverá suporte total ao sistema operacional (SO) por todos os recursos do Systems Manager.

O SSM Agent também pode estar pré-instalado nas AMIs encontradas no AWS Marketplace ou no repositório de AMIs da comunidade, mas, a AWS não oferece suporte a essas AMIs.

Verifique o status do SSM Agent

Dependendo de quando foi inicializada, uma instância criada a partir de uma AMI na lista anterior pode não ter sido pré-instalada pelo SSM Agent. Também é possível que uma instância tenha o agente pré-instalado, mas o agente não esteja em execução. Portanto, recomendamos que você verifique o status do SSM Agent antes de tentar usar o Systems Manager em uma instância pela primeira vez.

Use o procedimento a seguir para verificar se o SSM Agent está instalado e em execução em uma instância. Se achar que o agente não está instalado, é possível instalá-lo manualmente em instâncias do Linux, macOS, e Windows Server.

Para verificar a instalação do SSM Agent em uma instância

  1. Depois de iniciar uma nova instância, aguarde alguns minutos para que ela seja inicializada.

  2. Conecte-se à instância usando o método preferido. Por exemplo, você pode usar o SSH para se conectar às instâncias do Linux ou usar o Remote Desktop para se conectar às instâncias do Windows Server.

  3. Verifique o status do SSM Agent executando o comando para o tipo de sistema operacional da instância.

    Sistema operacional Comando
    Amazon Linux 1 sudo status amazon-ssm-agent
    Amazon Linux 2 e Amazon Linux 2023 sudo systemctl status amazon-ssm-agent
    macOS Não há nenhum comando para verificar o status do SSM Agent no macOS. Você pode verificar o status localizando e avaliando o arquivo de log /var/log/amazon/ssm/amazon-ssm-agent.log do agente.
    SUSE Linux Enterprise Server sudo systemctl status amazon-ssm-agent
    Ubuntu Server (32 bits) sudo status amazon-ssm-agent
    Ubuntu Server (64 bits, Deb) sudo systemctl status amazon-ssm-agent
    Ubuntu Server (64 bits, Snap) sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
    Windows Server Get-Service AmazonSSMAgent
    dica

    Para visualizar os comandos para verificar o status do SSM Agent em todos os tipos de sistema operacional compatíveis com o Systems Manager, consulte Verificar o status do SSM Agent e iniciar o agente.

  4. Avalie a saída do comando para saber o status do SSM Agent.

    Status: Installed and running (Instalado e sendo executado)

    Na maioria dos casos, a saída do comando indica que o agente está instalado e sendo executado.

    O exemplo a seguir mostra que o SSM Agent está instalado e sendo executado em uma instância do Amazon Linux 2.

    amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2021-10-20 19:09:29 UTC; 4min 6s ago
--truncated--

    O exemplo a seguir mostra que o SSM Agent está instalado e sendo executado em uma instância do Windows Server.

    Status   Name               DisplayName
------   ----               -----------
Running  AmazonSSMAgent     Amazon SSM Agent
    Status: Installed and running (Instalado e não sendo executado)

    Na alguns casos, a saída do comando indica que o agente está instalado, mas não está sendo executado.

    O exemplo a seguir mostra que o SSM Agent está instalado, mas não está sendo executado em uma instância do Amazon Linux 2.

    amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
Active: inactive (dead) since Wed 2021-10-20 22:16:41 UTC; 18s ago
--truncated--

    O exemplo a seguir mostra que o SSM Agent está instalado, mas não está sendo executado em uma instância do Windows Server.

    Status   Name               DisplayName
------   ----               -----------
Stopped  AmazonSSMAgent     Amazon SSM Agent

    Se o agente estiver instalado, mas não estiver seno executado, ative-o manualmente usando o comando para o tipo de sistema operacional em questão.

    Sistema operacional Comando
    Amazon Linux 1 sudo start amazon-ssm-agent
    Amazon Linux 2 e Amazon Linux 2023

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent
    macOS

    sudo launchctl load -w /Library/LaunchDaemons/com.amazon.aws.ssm.plist

    sudo launchctl start com.amazon.aws.ssm
    SUSE Linux Enterprise Server

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent
    Ubuntu Server (32 bits)

    sudo start amazon-ssm-agent
    Ubuntu Server (64 bits, Deb)

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent
    Ubuntu Server (64 bits, Snap) sudo snap start amazon-ssm-agent
    Windows Server

    Execute o seguinte comando no PowerShell.

    Start-Service AmazonSSMAgent
    Status: Not installed (Não instalado)

    Na alguns casos, a saída do comando indica que o agente não está instalado.

    O exemplo a seguir mostra que o SSM Agent não está instalado em uma instância do Amazon Linux 2.

    Unit amazon-ssm-agent.service could not be found.

    O exemplo a seguir mostra que o SSM Agent não está instalado em uma instância do Windows Server.

    Get-Service : Cannot find any service with service name 'AmazonSSMAgent'.
--truncated--

    Se o agente não estiver instalado, você poderá instalá-lo manualmente usando o procedimento para o tipo de sistema operacional: