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.
Comment installer le SSM Agent sur des nœuds Linux hybrides
Cette rubrique décrit comment procéder à l'installation AWS Systems Manager SSM Agent sur des machines Linux autres que EC2 (Amazon Elastic Compute Cloud) dans un environnement hybride et multicloud. Si vous prévoyez d'utiliser des machines Windows Server dans un environnement hybride et multicloud, consultez l'étape suivante, Comment installer le SSM Agent sur des Windows nœuds hybrides.
Important
Cette procédure concerne les types de machines autres que les instances EC2 pour un environnement hybride et multicloud. Pour télécharger et installer l'SSM Agent sur une instance EC2 pour Linux, reportez-vous à la section Installation et désinstallation manuelles SSM Agent sur les instances EC2 pour Linux.
Avant de commencer, recherchez le code d'activation et l'ID d'activation qui vous ont été envoyés à la fin de l'activation hybride, plus haut dans la rubrique Créez une activation hybride pour enregistrer les nœuds auprès de Systems Manager. Vous indiquez le code et l'ID dans la procédure suivante.
région
représente l'identifiant d'une région Région AWS
prise en charge par AWS Systems Manager, par exemple us-east-2
pour la région USA Est (Ohio). 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.
Par exemple, pour télécharger SSM Agent pour Amazon Linux, RHEL, CentOS et SLES 64 bits à partir de la région USA Est (Ohio) (us-east-2), utilisez l'URL suivante :
https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
Pour installer SSM Agent sur des machines non EC2 dans un environnement hybride et multicloud
-
Connectez-vous à un serveur ou une VM de votre environnement hybride et multicloud.
-
Si vous utilisez un proxy HTTP ou HTTPS, vous devez définir les variables d'environnement
http_proxy
ouhttps_proxy
dans la session shell en cours. Si vous n'utilisez pas de proxy, vous pouvez ignorer cette étape.Pour un serveur proxy HTTP, saisissez les commandes suivantes sur la ligne de commande :
export http_proxy=http://
hostname
:port
export https_proxy=http://hostname
:port
Pour un serveur proxy HTTPS, saisissez les commandes suivantes sur la ligne de commande :
export http_proxy=http://
hostname
:port
export https_proxy=https://hostname
:port
-
Copiez et collez l'un des blocs de commande suivants dans SSH. Remplacez les valeurs d'espace réservé par le code d'activation et l'ID d'activation générés lors de la création d'une activation de nœuds gérés, et par l'identifiant de la Région AWS depuis laquelle vous souhaitez télécharger SSM Agent, puis appuyez sur
Enter
.Note
Prenez note des informations importantes suivantes :
-
sudo
n'est pas nécessaire si vous êtes un utilisateur racine. -
Téléchargez
ssm-setup-cli
à partir de Région AWS l'endroit où votre activation hybride a été créée. -
ssm-setup-cli
prend en charge une optionmanifest-url
qui détermine la source à partir de laquelle l’agent est téléchargé. Ne spécifiez aucune valeur pour cette option à moins que votre organisation ne l’exige. -
Lors de l’enregistrement des instances, n’utilisez que le lien de téléchargement fourni pour
ssm-setup-cli
.ssm-setup-cli
ne doit pas être stocké séparément pour une utilisation ultérieure. -
Vous pouvez utiliser le script fourni ici
pour valider la signature de ssm-setup-cli
.
région
représente l'identifiant d'une région Région AWS prise en charge par AWS Systems Manager, par exempleus-east-2
pour la région USA Est (Ohio). Pour obtenir une liste des valeursregion
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.De plus,
ssm-setup-cli
inclut les options suivantes :-
version
: les valeurs valides sontlatest
etstable
. -
downgrade
: permet de rétrograder SSM Agent à une version antérieure. Spécifieztrue
pour installer une version antérieure de l’agent. -
skip-signature-validation
: ignore la validation de signature lors du téléchargement et de l’installation de l’agent.
-
mkdir /tmp/ssm curl https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/3.0.1479.0/linux_amd64/amazon-ssm-agent.rpm -o /tmp/ssm/amazon-ssm-agent.rpm sudo yum install -y /tmp/ssm/amazon-ssm-agent.rpm sudo stop amazon-ssm-agent sudo -E amazon-ssm-agent -register -code "
activation-code
" -id "activation-id
" -region "region
" sudo start amazon-ssm-agent
mkdir /tmp/ssm curl https://amazon-ssm-
region
.s3.region
.amazonaws.com/latest/linux_amd64/ssm-setup-cli -o /tmp/ssm/ssm-setup-cli sudo chmod +x /tmp/ssm/ssm-setup-cli sudo /tmp/ssm/ssm-setup-cli -register -activation-code "activation-code
" -id "activation-id
" -region "region
"
mkdir /tmp/ssm curl https://amazon-ssm-
region
.s3.region
.amazonaws.com/latest/linux_amd64/ssm-setup-cli -o /tmp/ssm/ssm-setup-cli sudo chmod +x /tmp/ssm/ssm-setup-cli sudo /tmp/ssm/ssm-setup-cli -register -activation-code "activation-code
" -activation-id "activation-id
" -region "region
"
mkdir /tmp/ssm curl https://amazon-ssm-
region
.s3.region
.amazonaws.com/latest/linux_amd64/ssm-setup-cli -o /tmp/ssm/ssm-setup-cli sudo chmod +x /tmp/ssm/ssm-setup-cli sudo /tmp/ssm/ssm-setup-cli -register -activation-code "activation-code
" -activation-id "activation-id
" -region "region
"
mkdir /tmp/ssm curl https://amazon-ssm-
region
.s3.region
.amazonaws.com/latest/debian_amd64/ssm-setup-cli -o /tmp/ssm/ssm-setup-cli sudo chmod +x /tmp/ssm/ssm-setup-cli sudo /tmp/ssm/ssm-setup-cli -register -activation-code "activation-code
" -activation-id "activation-id
" -region "region
"
mkdir /tmp/ssm curl https://amazon-ssm-
region
.s3.region
.amazonaws.com/latest/debian_arm/ssm-setup-cli -o /tmp/ssm/ssm-setup-cli sudo chmod +x /tmp/ssm/ssm-setup-cli sudo /tmp/ssm/ssm-setup-cli -register -activation-code "activation-code
" -activation-id "activation-id
" -region "region
"
-
Utilisation de packages .deb
mkdir /tmp/ssm curl https://amazon-ssm-
region
.s3.region
.amazonaws.com/latest/debian_amd64/ssm-setup-cli -o /tmp/ssm/ssm-setup-cli sudo chmod +x /tmp/ssm/ssm-setup-cli sudo /tmp/ssm/ssm-setup-cli -register -activation-code "activation-code
" -activation-id "activation-id
" -region "region
" -
Utilisation de packages Snap
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 . Sur Ubuntu Server 20.10 STR & 20.04, 18.04 et 16.04 LTS, les fichiers du programme d'installation 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
).sudo snap install amazon-ssm-agent --classic sudo systemctl stop snap.amazon-ssm-agent.amazon-ssm-agent.service sudo /snap/amazon-ssm-agent/current/amazon-ssm-agent -register -code "
activation-code
" -id "activation-id
" -region "region
" sudo systemctl start snap.amazon-ssm-agent.amazon-ssm-agent.serviceImportant
Le canal candidat dans le magasin de Snaps contient la dernière version de l'SSM Agent ; pas le canal stable. Si vous souhaitez suivre les informations de version de SSM Agent sur le canal candidat, exécutez la commande suivante sur vos nœuds gérés 64 bits Ubuntu Server 18.04 et 16.04 LTS.
sudo snap switch --channel=candidate amazon-ssm-agent
La commande télécharge et installe SSM Agent sur la machine activée par un système hybride dans votre environnement hybride et multicloud. La commande arrête SSM Agent, puis enregistre la machine auprès du service Systems Manager. La machine est désormais un nœud géré. Les instances Amazon EC2 configurées pour Systems Manager sont également des nœuds gérés. Pourtant, dans la console Systems Manager, vos nœuds activés par un système hybride se distinguent des instances Amazon EC2 par le préfixe « mi- ».
Passez au Comment installer le SSM Agent sur des Windows nœuds hybrides.
Configuration de la rotation automatique de la clé privée
Pour renforcer votre niveau de sécurité, vous pouvez configurer AWS Systems Manager Agent (SSM Agent) pour qu'il fasse automatiquement pivoter la clé privée pour votre environnement hybride et multicloud. Vous pouvez accéder à cette fonction en utilisant la version 3.0.1031.0 ou ultérieure de l'SSM Agent. Procédez comme suit pour activer cette fonction.
Pour configurer SSM Agent de sorte à effectuer une rotation de la clé privée d'un environnement hybride et multicloud
-
Accédez à
/etc/amazon/ssm/
sur une machine Linux ou àC:\Program Files\Amazon\SSM
sur une machine Windows. -
Copiez le contenu de
amazon-ssm-agent.json.template
vers un nouveau fichier appeléamazon-ssm-agent.json
. Enregistrezamazon-ssm-agent.json
dans le même répertoire queamazon-ssm-agent.json.template
. -
Recherchez
Profile
,KeyAutoRotateDays
. Saisissez le nombre de jours qui doit séparer les rotations automatiques de clé privée. -
Redémarrez SSM Agent.
Chaque fois que vous modifiez la configuration, redémarrez l'SSM Agent.
Vous pouvez personnaliser d'autres fonctions de l'SSM Agent en suivant la même procédure. Pour une up-to-date liste des propriétés de configuration disponibles et de leurs valeurs par défaut, consultez la section Définitions des propriétés de configuration
Désenregistrer et réenregistrer un nœud géré
Vous pouvez annuler l'enregistrement d'un nœud géré activé de manière hybride en appelant l'opération DeregisterManagedInstanceAPI depuis Windows AWS CLI ou depuis Tools for Windows. PowerShell Voici un exemple de commande de l'interface de ligne de commande :
aws ssm deregister-managed-instance --instance-id
"mi-1234567890"
Pour supprimer les informations d’enregistrement restantes pour l’agent, supprimez la clé IdentityConsumptionOrder
du fichier amazon-ssm-agent.json
. Ensuite, exécutez la commande suivante :
amazon-ssm-agent -register -clear
Vous pouvez réenregistrer une machine après avoir annulé son enregistrement. Procédez comme suit pour réenregistrer une machine. Une fois la procédure terminée, votre nœud géré s'affiche à nouveau dans la liste des nœuds gérés.
Pour réenregistrer un nœud géré sur une machine Linux non EC2
-
Connectez-vous à votre machine.
-
Exécutez la commande suivante. Veillez à remplacer les valeurs d'espace réservé par le code d'activation et l'ID d'activation générés lors de la création d'une activation de nœuds gérés, et par l'identifiant de la région depuis laquelle vous souhaitez télécharger SSM Agent.
echo "yes" | sudo /tmp/ssm/ssm-setup-cli -register -activation-code "
activation-code
" -activation-id "activation-id
" -region "region
Résolution des problèmes d'installation de SSM Agent sur des machines Linux non EC2
Utilisez les informations suivantes pour résoudre les problèmes liés à l'installation de SSM Agent sur des machines Linux activées par un système hybride dans un environnement hybride et multicloud.
Vous recevez un DeliveryTimedOut message d'erreur
Problème : lors de la configuration d'une machine en Compte AWS tant que nœud géré pour une machine séparée Compte AWS, vous recevez DeliveryTimedOut
après avoir exécuté les commandes d'installation SSM Agent sur la machine cible.
Solution : DeliveryTimedOut
est le code de réponse attendu pour ce scénario. La commande pour installer l'SSM Agent sur le nœud cible modifie l'ID de nœud du nœud source. Comme l'ID de nœud a changé, le nœud source n'est pas en mesure de répondre au nœud cible que la commande a échoué, s'est terminée ou a expiré lors de l'exécution.
Impossible de charger les associations de nœuds
Problème : après avoir exécuté les commandes d'installation, l'erreur suivante s'affiche dans les journaux d'erreurs de l'SSM Agent :
Unable to load instance associations, unable to retrieve associations
unable to retrieve associations error occurred in
RequestManagedInstanceRoleToken: MachineFingerprintDoesNotMatch: Fingerprint
doesn't match
Cette erreur s'affiche lorsque l'ID de la machine ne reste pas après un redémarrage.
Solution : pour résoudre ce problème, exécutez la commande suivante. Cette commande force l'ID de la machine à rester après un redémarrage.
umount /etc/machine-id systemd-machine-id-setup