Installation manuelle de SSM Agent sur les instances Amazon Linux 2 et Amazon Linux 2023 - AWS Systems Manager

Installation manuelle de SSM Agent sur les instances Amazon Linux 2 et Amazon Linux 2023

Important

Cette rubrique fournit des commandes pour utiliser SSM Agent sur les instances Amazon Linux 2 et Amazon Linux 2023. Certaines commandes ne sont pas prises en charge sur les instances Amazon Linux 1. Avant de continuer, assurez-vous que vous regardez bien la rubrique correspondant à votre type d'instance. Pour savoir quelles commandes exécuter sur les instances Amazon Linux 1, consultez Installation manuelle de SSM Agent sur les instances Amazon Linux 1.

Dans la plupart des cas, les Amazon Machine Images (AMIs) pour Amazon Linux 2 et Amazon Linux 2023 fournies par AWS incluent déjà l'agent AWS Systems Manager (SSM Agent) par défaut. Pour en savoir plus, consultez Trouver les AMIs avec SSM Agent préinstallé.

Dans le cas où SSM Agent n'est pas préinstallé sur une nouvelle instance Amazon Linux 2 ou Amazon Linux 2023, ou si vous devez réinstaller manuellement l'agent, utilisez les informations de cette page pour vous aider.

Avant de commencer

Avant d'installer SSM Agent sur une instance Amazon Linux 2 ou Amazon Linux 2023, notez ce qui suit :

  • Pour obtenir des informations importantes qui s'appliquent à l'installation de SSM Agent sur tous les systèmes d'exploitation Linux, consultez la rubrique Installation et désinstallation manuelles de SSM Agent sur les instances EC2 pour Linux.

  • Si vous utilisez une commande yum pour mettre à jour l'SSM Agent sur un nœud géré après que l'agent a été installé ou mis à jour en utilisant le document SSM AWS-UpdateSSMAgent, le message suivant peut s'afficher : « Warning: RPMDB altered outside of yum (Avertissement : RPMDB modifié en dehors de yum) ». Ce message est prévu pour s'afficher. Il peut être ignoré sans risque.

Commandes d'installation rapide pour SSM Agent sur Amazon Linux 2 ou Amazon Linux 2023

Suivez ces étapes pour installer manuellement SSM Agent sur une seule instance. Cette procédure utilise les fichiers d'installation disponibles dans le monde entier.

Pour installer SSM Agent sur Amazon Linux 2 ou Amazon Linux 2023 à l'aide de commandes de copier-coller rapides
  1. Connectez-vous à votre instance Amazon Linux 2 ou Amazon Linux 2023 à l'aide de votre méthode préférée, telle que SSH.

  2. Copiez la commande de l'architecture de votre instance et exécutez-la sur l'instance.

    Note

    Même si les URL des commandes suivantes incluent un répertoire ec2-downloads-windows, il s'agit des fichiers d'installation globaux corrects pour Amazon Linux 2 et Amazon Linux 2023.

    x86_64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
    ARM64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
  3. (Recommandé) Exécutez la commande suivante pour vérifier que l'agent est en cours d'exécution.

    sudo systemctl status amazon-ssm-agent

    Dans la plupart des cas, la commande signale que l'agent est en cours d'exécution, comme illustré dans l'exemple suivant.

    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--

    Dans de rares cas, la commande signale que l'agent est installé, mais qu'il n'est pas en cours d'exécution, comme illustré dans l'exemple suivant.

    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--

    Dans ces cas, exécutez la commande suivante pour activer l'agent.

    sudo systemctl start amazon-ssm-agent

Création de commandes d'installation d'agent personnalisées pour Amazon Linux 2 ou Amazon Linux 2023 dans votre région

Lorsque vous installez SSM Agent sur plusieurs instances utilisant un script ou un modèle, nous vous recommandons d’utiliser les fichiers d’installation stockés dans l’Région AWS dans laquelle vous travaillez.

S'il s'agit des commandes suivantes, nous fournissons des exemples qui utilisent un compartiment S3 accessible au public dans la région USA Est (Ohio) (us-east-2).

Astuce

Vous pouvez également remplacer une URL globale dans la procédure Commandes d’installation rapide pour SSM Agent sur Amazon Linux 1 plus avant dans cette rubrique, avec une URL régionale personnalisée que vous créez.

Dans la commande ci-après, remplacez region (région) par vos propres informations. Pour obtenir une liste des valeurs region prises en charge, consultez la colonne Région dans la rubrique Points de terminaison de service Systems Manager de la Référence générale d'Amazon Web Services.

x86_64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm

Consultez l'exemple suivant.

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
ARM64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_arm64/amazon-ssm-agent.rpm

Consultez l'exemple suivant.

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_arm64/amazon-ssm-agent.rpm