View a markdown version of this page

Installation SSM Agent on Ubuntu Server 18,04, 20,04, 22,04 LTS, 23,10, 24,04 LTS, 24,0 et 25,04 - AWS Systems Manager

• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la documentation Amazon CloudWatch Dashboard.

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 SSM Agent on Ubuntu Server 18,04, 20,04, 22,04 LTS, 23,10, 24,04 LTS, 24,0 et 25,04

Avant de commencer

Avant d'effectuer l'installation SSM Agent sur un LTS Ubuntu Server 18.04, 20.04, 22.04, 23.10, 24.04 LTS, 24.0 et 25.04, notez ce qui suit :

Emplacements des fichiers d'installation SSM Agent

Sur les Ubuntu Server versions 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04, les fichiers d'SSM Agentinstallation, y compris les fichiers binaires de l'agent et les fichiers de configuration, 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, Risk-levelsconsultez https://snapcraft.io/docs/channels.

Si vous souhaitez suivre les informations de SSM Agent version sur le canal candidat, exécutez la commande suivante sur vos instances 64 bits Ubuntu Server 20.04 et 18.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.

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 on Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04 (avec le package Snap)

  1. SSM Agentest installé, par défaut, sur les versions Ubuntu Server 18.04, 20.04, 22.04 LTS, 23.10, 24.04 LTS, 24.0 et 25.04 AMIs avec un identifiant de ou version ultérieure. 20180627

    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. Il n'est pas nécessaire de spécifier une URL pour le téléchargement, car la snap commande télécharge automatiquement l'agent depuis le magasin 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