Rechercher AMIs avec le SSM Agent préinstallé - AWS Systems Manager

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.

Rechercher AMIs avec le SSM Agent préinstallé

AWS Systems Manager Agent (SSM Agent) est préinstallée sur certains Amazon Machine Images (AMIs) fournis par AWS des tiers de confiance.

Par exemple, lorsque vous lancez une instance Amazon Elastic Compute Cloud (AmazonEC2) créée à partir d'une AMI avec l'un des systèmes d'exploitation suivants, vous constaterez probablement que SSM Agent est déjà installé :

  • AlmaLinux

  • Amazon Linux 1 de base AMIs datées de septembre 2017 et ultérieures

  • Amazon Linux 2

  • Amazon Linux 2 ECS - Base optimisée AMIs

  • Amazon Linux 2023 (AL2023)

  • Amazon EKS — Amazon — Linux optimisé AMIs

  • macOS 10,14 (Mojave), 10,15 (Catalina), 11 (Big Sur), 12 (Monterey), 13 (Ventura) et 14 (Sonoma)

  • SUSE Linux Enterprise Server (SLES) 12 et 15

  • Ubuntu Server 16.04, 18.04, 20.04 et 22.04

  • Windows Server 2008-2012 R2 AMIs publié en novembre 2016 ou plus tard

  • Windows Server 2016, 2019 et 2022 (sauf les versions Nano)

Note

La version de SSM Agent préinstallé sur un AMI peut ne pas être la dernière version disponible. En guise de bonne pratique, nous vous recommandons de toujours utiliser la dernière version disponible de SSM Agent sur vos nœuds gérés. Pour plus d'informations sur l'automatisation SSM Agent mises à jour, voirAutomatisation des mises à jour de l'SSM Agent.

SSM Agent peut être préinstallé sur Managed AWS AMIs qui ne figurent pas sur cette liste. Cela indique généralement que le système d'exploitation n'est pas entièrement pris en charge par toutes les fonctionnalités de Systems Manager.

SSM Agent peut également être préinstallé sur AMIs trouvé dans AWS Marketplace ou dans la Communauté AMIs dépôt, mais AWS ne les prend pas en charge AMIs.

Vérifier le statut de SSM Agent

Selon la date d'initialisation, une instance créée à partir d' AMI dans la liste précédente, il se peut que ce ne soit pas le cas SSM Agent préinstallé. Il est également possible que l'agent soit préinstallé sur une instance, mais que celui-ci ne soit pas en cours d'exécution. Par conséquent, nous vous recommandons de vérifier l'état de SSM Agent avant d'essayer d'utiliser Systems Manager sur une instance pour la première fois.

Procédez comme suit pour vérifier que SSM Agent est installé et en cours d'exécution sur une instance. Si vous constatez que l'agent n'est pas installé, procédez manuellement à l'installation sous Linux, macOS, et Windows Serverinstances.

Pour vérifier l'installation de SSM Agent sur une instance
  1. Après avoir lancé une nouvelle instance, patientez quelques minutes pendant son initialisation.

  2. Connectez-vous à l'instance en utilisant votre méthode préférée. Par exemple, vous pouvez utiliser pour vous connecter SSH à des instances Linux ou utiliser le Bureau à distance pour vous connecter à Windows Server instances.

  3. Vérifiez le statut de SSM Agent en exécutant la commande correspondant au type de système d'exploitation de votre instance.

    Système d’exploitation Command
    Amazon Linux 1 sudo status amazon-ssm-agent
    Amazon Linux 2 et Amazon Linux 2023 sudo systemctl status amazon-ssm-agent
    macOS Il n'y a aucune commande à vérifier SSM Agent status sur macOS. Vous pouvez vérifier l'état en localisant et en évaluant le fichier journal de l'agent/var/log/amazon/ssm/amazon-ssm-agent.log.
    SUSE Linux Enterprise Server sudo systemctl status amazon-ssm-agent
    Ubuntu Server (32 bits) sudo status amazon-ssm-agent
    Ubuntu Server (64 bits — Deb) sudo systemctl status amazon-ssm-agent
    Ubuntu Server (64 bits — Snap) sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
    Windows Server Get-Service AmazonSSMAgent
    Astuce

    Pour afficher les commandes de vérification SSM Agent état de tous les types de systèmes d'exploitation pris en charge par Systems Manager, veuillez consulterVérification du statut de l'SSM Agent et démarrage de l'agent.

  4. Évaluez la sortie de la commande pour connaître l'état de SSM Agent.

    État : installé et en cours d'exécution

    Dans la plupart des cas, la sortie de commande indique que l'agent est installé et en cours d'exécution.

    L'exemple suivant indique que SSM Agent est installé et en cours d'exécution sur une instance Amazon Linux 2.

    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: active (running) since Wed 2021-10-20 19:09:29 UTC; 4min 6s ago
    --truncated--
                                

    L'exemple suivant indique que SSM Agent est installé et en cours d'exécution sur Windows Server instance.

    Status   Name               DisplayName
    ------   ----               -----------
    Running  AmazonSSMAgent     Amazon SSM Agent
    État : installé mais pas en cours d'exécution

    Dans certains cas, la sortie de commande indique que l'agent est installé, mais qu'il n'est pas en cours d'exécution.

    L'exemple suivant indique que SSM Agent est installé, mais qu'il n'est pas en cours d'exécution sur une instance Amazon Linux 2.

    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: inactive (dead) since Wed 2021-10-20 22:16:41 UTC; 18s ago
    --truncated--
                                

    L'exemple suivant indique que SSM Agent est installé mais ne fonctionne pas sur un Windows Server instance.

    Status   Name               DisplayName
    ------   ----               -----------
    Stopped  AmazonSSMAgent     Amazon SSM Agent
                                

    Si l'agent est installé, mais n'est pas en cours d'exécution, vous pouvez l'activer manuellement à l'aide des commandes correspondant au type de système d'exploitation de votre instance.

    Système d’exploitation Command
    Amazon Linux 1 sudo start amazon-ssm-agent
    Amazon Linux 2 et Amazon Linux 2023

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    macOS

    sudo launchctl load -w /Library/LaunchDaemons/com.amazon.aws.ssm.plist

    sudo launchctl start com.amazon.aws.ssm

    SUSE Linux Enterprise Server

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    Ubuntu Server (32 bits)

    sudo start amazon-ssm-agent

    Ubuntu Server (64 bits — Deb)

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    Ubuntu Server (64 bits — Snap) sudo snap start amazon-ssm-agent
    Windows Server

    Exécutez la commande suivante dans PowerShell.

    Start-Service AmazonSSMAgent

    État : non installé

    Dans certains cas, la sortie de commande indique que l'agent n'est pas installé.

    L'exemple suivant indique que SSM Agent n'est pas installé sur une instance Amazon Linux 2.

    Unit amazon-ssm-agent.service could not be found.

    L'exemple suivant indique que SSM Agent n'est pas installé sur un Windows Server instance.

    Get-Service : Cannot find any service with service name 'AmazonSSMAgent'.
    --truncated--

    Si l'agent n'est pas installé, vous pouvez l'installer manuellement à l'aide de la procédure correspondant à votre type de système d'exploitation :