Instalar o SSM Agent no Ubuntu Server 16.04 LTS de 64 bits (Snap), 18.04, 20.04, 20.10 STR, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04 - AWS Systems Manager

Instalar o SSM Agent no Ubuntu Server 16.04 LTS de 64 bits (Snap), 18.04, 20.04, 20.10 STR, 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 16.04 LTS de 64 bits (Snap), 18.04, 20.04, 20.10 STR, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04, observe o seguinte:

Instalação da versão 16.04 por instaladores Snaps ou deb

No Ubuntu Server 16.04, o SSM Agent é instalado usando os pacotes de instalação Snaps ou deb, dependendo da versão da AMI 16.04.

Locais de arquivos do instalador do SSM Agent

No Ubuntu Server 16,04 LTS de 64 bits (Snap), 18,04, 20,04, 20,10 STR, 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 de 64 bits do Ubuntu Server 20.10 STR e 20.04, 18.04 e 16.04 LTS.

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

No Ubuntu Server 18.04, 20.04, 20.10 STR, 22.04 LTS, 23.10, 24.04 LTS, 24.0 w 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. Se você quiser usar o SSM Agent sem Snaps, desinstale o SSM Agent. Então instale o SSM Agent como um pacote debian usando as instruções para instalar o SSM Agent no Ubuntu Server 16.04 e 14.04 de 64 bits (deb). Antes de instalar, certifique-se de não haja nenhum Snap instalado que se sobreponha à lista de pacotes que você deseja gerenciar como pacotes debian.

Mensagem de erro do Maximum timeout exceeded

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 16.04 LTS de 64 bits (Snap), 18.04, 20.04, 20.10 STR, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04 (com pacote Snap)

  1. O SSM Agent é instalado por padrão no Ubuntu Server 16.04 LTS de 64 bits (Snap), 18.04, 20.04, 20.10 STR, 22.04 LTS, 23.10, 24.04 LTS, 24.0 e 25.04 AMIs 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