Installation de SSM Agent sur Ubuntu Server 22.04 LTS, 20.10 STR et 20.04, 18.04 et 16.04 LTS 64 bits (Snap)

Avant de commencer

Avant l'installation de SSM Agent sur un Ubuntu Server 22.04 LTS, 20.10 STR et 20.04, 18.04 et 16.04 LTS 64 bits (Snap), notez les points suivants :

Installation de la version 16.04 par Snaps ou les installateurs deb

Sur Ubuntu Server 16.04, l'SSM Agent est installé à l'aide de Snaps ou de packages d'installation deb, en fonction de la version de l'AMI 16.04.

Emplacements des fichiers d'installation SSM Agent

Sur Ubuntu Server 22.04 LTS, 20.10 STR et 20.04, 18.04 et 16.04 LTS (avec Snap), les fichiers du programme d'installation de SSM Agent, y compris les fichiers binaires et les fichiers de configuration de l'agent, sont stockés dans le répertoire suivant : /snap/amazon-ssm-agent/current/. Si vous apportez des modifications aux fichiers de configuration de ce répertoire, vous devez copier ces fichiers du répertoire /snap vers le répertoire /etc/amazon/ssm/. Les fichiers journaux et de bibliothèque n'ont pas changé (/var/lib/amazon/ssm, /var/log/amazon/ssm).

Utilisation du canal Snap candidate

Le canal candidat dans le magasin de Snaps contient la dernière version de l'SSM Agent (y compris l'intégralité des dernières corrections de bogues) ; pas le canal stable. Pour en savoir plus sur les différences entre le canal candidat et le canal stable, veuillez consulter Niveaux de risque à l'adresse https://snapcraft.io/docs/channels.

Si vous voulez suivre les informations de version de l'SSM Agent sur le canal candidat, exécutez la commande suivante sur vos instances 64 bits Ubuntu Server 20.10 STR et 20.04, 18.04 et 16.04 LTS.

sudo snap switch --channel=candidate amazon-ssm-agent

Snaps recommandés sur les versions 18.04 et ultérieures

Sur Ubuntu Server 22.04 LTS, 20.10 STR et 20.04 et 18.04 LTS, nous vous recommandons d'utiliser uniquement les Snaps. Vérifiez également qu'une seule instance de l'agent est installée et en cours d'exécution sur vos instances. Si vous voulez utiliser l'SSM Agent sans les Snaps, désinstallez l'SSM Agent. Ensuite, installez SSM Agent sous forme de paquet Debian en utilisant les instructions d'installation SSM Agent sur Ubuntu Server 16.04 et 14.04 64 bits (deb). Avant de procéder à l'installation, assurez-vous que vous n'avez pas de Snaps installé qui chevauche la liste des paquets que vous voulez gérer comme des paquets debian.

Message d'erreur Maximum timeout exceeded

En raison d'un problème connu lié à Snap, vous pouvez voir une erreur Maximum timeout exceeded s'afficher lors de l'exécution des commandes snap. Si vous recevez cette erreur, exécutez les commandes suivantes une par une pour démarrer l'agent, l'arrêter et vérifier son statut :

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

Pour installer SSM Agent sur des instances Ubuntu Server 22.04 LTS, 20.10 STR et 20.04, 18.04 et 16.04 LTS 64 bits (avec un package Snap)

1. Par défaut, SSM Agent est installé sur des AMIs Ubuntu Server 22.04 LTS, 20.04, 18.04 et 16.04 LTS 64 bits avec un identifiant 20180627 ou ultérieur.

   Vous pouvez utiliser le script suivant si vous avez besoin d'installer l'SSM Agent sur un serveur sur site ou que vous devez réinstaller l'agent. Vous n'avez pas besoin de spécifier une URL pour le téléchargement, car la commande snap télécharge automatiquement l'agent à partir de la boutique d'applications Snap à l'adresse https://snapcraft.io.

   sudo snap install amazon-ssm-agent --classic

2. Exécutez la commande suivante afin de déterminer si l'SSM Agent est en cours d'exécution.

   sudo snap list amazon-ssm-agent

3. Exécutez la commande suivante pour démarrer le service si la commande précédente a renvoyé amazon-ssm-agent is stopped, inactive ou disabled.

   sudo snap start amazon-ssm-agent

4. Vérifiez le statut de l'agent.

   sudo snap services amazon-ssm-agent