Installation de SSM Agent sur Ubuntu Server 16.04 LTS 64 bits (Snap), 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04 - AWS Systems Manager

AWS Systems ManagerChange Managern'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez AWS Systems ManagerChange Managerla section Modification de la disponibilité.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Installation de SSM Agent sur Ubuntu Server 16.04 LTS 64 bits (Snap), 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04

Avant de commencer

Avant l’installation de SSM Agent sur un Ubuntu Server 16.04 LTS 64 bits (Snap), 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 ou 25.04, 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 16.04 LTS 64 bits (Snap), 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04, 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 les canaux candidats et les canaux stables, consultez les niveaux de risque sur 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.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 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04, 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 (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
Installer SSM Agent sur Ubuntu Server 16.04 LTS 64 bits (Snap), 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04 (avec package Snap)

  1. Par défaut, SSM Agent est installé sur des AMIs Ubuntu Server 16.04 LTS 64 bits (Snap), 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04 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