View a markdown version of this page

Instalar o SSM Agent no Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04 - AWS Systems Manager

Instalar o SSM Agent no Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04

Antes de começar

Antes de instalar o SSM Agent em um Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04, observe o seguinte:

Locais de arquivos do instalador do SSM Agent

No Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04, os arquivos do instalador do SSM Agent, incluindo arquivos binários do agente e arquivos de configuração, são armazenados no seguinte diretório: /snap/amazon-ssm-agent/current/. Se você fizer alterações em qualquer arquivo de configuração nesse diretório, copie esses arquivos do diretório /snap para o /etc/amazon/ssm/. Os arquivos de log e biblioteca não foram alterados (/var/lib/amazon/ssm, /var/log/amazon/ssm).

Usar o canal candidate do Snap

O canal candidato na loja Snap contém a versão mais recente do SSM Agent (incluindo todas as correções de bugs mais recentes), não o canal estável. Para saber mais sobre as diferenças entre os canais candidatos e estáveis, consulte Níveis de risco em https://snapcraft.io/docs/channels.

Se você quiser acompanhar as informações de versão do SSM Agent no canal candidato, execute o comando a seguir nas instâncias do Ubuntu Server 20.04 e 18.04 LTS de 64 bits.

sudo snap switch --channel=candidate amazon-ssm-agent
Snaps recomendados nas versões 18.04 e posteriores

No Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04, recomendamos usar apenas Snaps. Além disso, verifique se apenas uma instância do agente está instalada e em execução nas suas instâncias.

Maximum timeout exceededMensagem de erro do

Devido a um problema conhecido com o Snap, você pode ver um erro Maximum timeout exceeded com os comandos snap. Se este erro for exibido, execute os seguintes comandos, um de cada vez, para iniciar o agente, pará-lo e verificar seu status: 

sudo systemctl start snap.amazon-ssm-agent.amazon-ssm-agent.service
sudo systemctl stop snap.amazon-ssm-agent.amazon-ssm-agent.service
sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
Para instalar o SSM Agent no Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04 (com pacote Snap)

  1. O SSM Agent é instalado por padrão nas AMIs do Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04 com um identificador de 20180627 ou posterior.

    Você pode usar o seguinte script se precisar instalar o SSM Agent em um servidor on-premises ou se precisar reinstalar o agente. Você não precisa especificar um URL para download porque o comando snap faz download automático do agente da loja de aplicativos Snap em https://snapcraft.io.

    sudo snap install amazon-ssm-agent --classic

  2. Execute o comando a seguir para determinar se o SSM Agent está em execução. 

    sudo snap list amazon-ssm-agent

  3. Execute o comando a seguir para iniciar o serviço se o comando anterior retornar amazon-ssm-agent is stopped, inactive ou disabled.

    sudo snap start amazon-ssm-agent

  4. Verifique o status do agente.

    sudo snap services amazon-ssm-agent