Instalar o SSM Agent no Ubuntu Server 22.04 LTS, 20.10 STR e 20.04, 18.04 e 16.04 LTS de 64 bits (Snap)

Antes de começar

Antes de instalar o SSM Agent em um Ubuntu Server 22.04 LTS, 20.10 STR e 20.04, 18.04 e 16.04 LTS de 64 bits (Snap), 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 22.04 LTS, 20.10 STR e 20.04, 18.04 e 16.04 LTS (com Snap), 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 Risk-levels 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 22.04 LTS, 20.10 STR e 20.04 e 18.04 LTS, 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

Instalar o SSM Agent em instâncias do Ubuntu Server 22.04 LTS, 20.10 STR e 20.04, 18.04 e 16.04 LTS de 64 bits (com o pacote do Snap)

1. O SSM Agent é instalado, por padrão, nas AMIs do Ubuntu Server 22.04 LTS, 20.04, 18.04 e 16.04 LTS de 64 bits 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