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.
Résolution des problèmes de disponibilité des nœuds gérés en utilisant ssm-cli
ssm-cliIl s'agit d'un outil de ligne de commande autonome inclus dans SSM Agent installation. Lorsque vous installez SSM Agent 3.1.501.0 ou version ultérieure sur une machine, vous pouvez exécuter des ssm-cli commandes sur cette machine. La sortie de ces commandes vous aide à déterminer si la machine répond aux exigences minimales requises pour être gérée par une EC2 instance Amazon ou non AWS Systems Manager, et si elle est donc ajoutée aux listes de nœuds gérés dans Systems Manager. EC2 (SSM Agent la version 3.1.501.0 a été publiée en novembre 2021.)
Configuration requise
Pour qu'une EC2 instance Amazon ou une instance non EC2 machine soit gérée par AWS Systems Manager et disponible dans des listes de nœuds gérés, elle doit répondre à trois exigences principales :
-
SSM Agent doit être installé et exécuté sur un ordinateur doté d'un système d'exploitation compatible.
Certains ont AWS géré Amazon Machine Images (AMIs) pour EC2 sont configurés pour lancer des instances avec SSM Agentpréinstallé. (Vous pouvez également configurer un AMI pour préinstaller SSM Agent.) Pour plus d'informations, consultez Trouver les AMIs avec SSM Agent préinstallé.
-
Un profil d'instance AWS Identity and Access Management (IAM) (pour les EC2 instances) ou un rôle de service IAM (pour les EC2 non-machines) fournissant les autorisations requises pour communiquer avec le service Systems Manager doit être attaché à la machine.
-
SSM Agent doit être en mesure de se connecter à un point de terminaison Systems Manager pour s'enregistrer auprès du service. Le nœud géré est ensuite disponible pour le service, comme le confirme le signal que celui-ci envoie toutes les cinq minutes afin de vérifier l'état du nœud géré.
Commandes préconfigurées dans ssm-cli
Il contient des commandes préconfigurées qui rassemblent les informations requises afin de déterminer pourquoi une machine, confirmée comme en cours d'exécution, ne figure pas dans vos listes de nœuds gérées dans Systems Manager. Ces commandes sont exécutées lorsque vous spécifiez l'option get-diagnostics.
Sur la machine, exécutez la commande suivante afin d'utiliser ssm-cli pour résoudre les problèmes de disponibilité des nœuds gérés.
La sortie générée lors de l'exécution de cette commande renvoie un tableau similaire à celui qui suit.
Note
Les contrôles de connectivité auxssmmessages,, s3 kmslogs, et aux monitoring points de terminaison concernent des fonctionnalités optionnelles supplémentaires telles que Session Manager qui peut se connecter à Amazon Simple Storage Service (Amazon S3) ou CloudWatch Amazon Logs, et AWS Key Management Service utiliser le chiffrement AWS KMS().
Le tableau suivant fournit des détails supplémentaires pour chacune des vérifications effectuées par ssm-cli.
| Check | Détails |
|---|---|
| Service de métadonnées d' EC2 instance Amazon | Indique si le nœud géré est en mesure d'accéder au service de métadonnées. Un test qui échoue indique un problème de connectivité à http://169.254.169.254 qui peut être dû à la configuration de l'acheminement local, du proxy, ou du pare-feu et du proxy du système d'exploitation (OS). |
| Enregistrement d'une instance hybride | Indique si SSM Agent est enregistré à l'aide d'une activation hybride. |
Connectivité au point de terminaison ssm |
Indique si le nœud a accès aux points de terminaison de service de Systems Manager sur le port TCP 443. Un test raté indique des problèmes de connectivité https://ssm. en fonction de l' Région AWS emplacement du nœud. Les problèmes de connectivité peuvent être dus à la configuration du VPC, et notamment aux groupes de sécurité, aux listes de contrôle d'accès réseau, aux tables de routage ou aux pare-feu et proxies du système d'exploitation. |
Connectivité au point de terminaison ec2messages |
Indique si le nœud a accès aux points de terminaison de service de Systems Manager sur le port TCP 443. Un test raté indique des problèmes de connectivité https://ec2messages. en fonction de l' Région AWS emplacement du nœud. Les problèmes de connectivité peuvent être dus à la configuration du VPC, et notamment aux groupes de sécurité, aux listes de contrôle d'accès réseau, aux tables de routage ou aux pare-feu et proxies du système d'exploitation. |
Connectivité au point de terminaison ssmmessages |
Indique si le nœud a accès aux points de terminaison de service de Systems Manager sur le port TCP 443. Un test raté indique des problèmes de connectivité https://ssmmessages. en fonction de l' Région AWS emplacement du nœud. Les problèmes de connectivité peuvent être dus à la configuration du VPC, et notamment aux groupes de sécurité, aux listes de contrôle d'accès réseau, aux tables de routage ou aux pare-feu et proxies du système d'exploitation. |
Connectivité au point de terminaison s3 |
Indique si le nœud est en mesure d’atteindre le point de terminaison d'Amazon Simple Storage Service sur le port TCP 443. Un test raté indique des problèmes de connectivité https://s3. en fonction de l' Région AWS emplacement du nœud. La connectivité à ce point de terminaison n'est pas nécessaire pour qu'un nœud apparaisse dans votre liste de nœuds gérés. |
Connectivité au point de terminaison kms |
Indique si le nœud est capable d'atteindre le point de terminaison du service AWS Key Management Service sur le port TCP 443. Un test raté indique des problèmes de connectivité |
Connectivité au point de terminaison logs |
Indique si le nœud est capable d'atteindre le point de terminaison du service pour Amazon CloudWatch Logs sur le port TCP 443. Un test raté indique des problèmes de connectivité https://logs. en fonction de l' Région AWS emplacement du nœud. La connectivité à ce point de terminaison n'est pas nécessaire pour qu'un nœud apparaisse dans votre liste de nœuds gérés. |
Connectivité au point de terminaison monitoring |
Indique si le nœud est capable d'atteindre le point de terminaison du service pour Amazon CloudWatch sur le port TCP 443. Un test raté indique des problèmes de connectivité https://monitoring. en fonction de l' Région AWS emplacement du nœud. La connectivité à ce point de terminaison n'est pas nécessaire pour qu'un nœud apparaisse dans votre liste de nœuds gérés. |
| AWS Informations d'identification | Indique si SSM Agent possède les informations d'identification requises en fonction du profil d'instance IAM (pour les EC2 instances) ou du rôle de service IAM (pour les EC2 non-machines) attaché à la machine. Un test qui échoue indique qu'aucun profil d'instance IAM ou fonction du service IAM n'est attaché à la machine, ou qu'il ne contient pas les autorisations requises pour Systems Manager. |
| Service d'agent | Indique si SSM Agent le service est en cours d'exécution, et si le service s'exécute en tant que root pour Linux ou macOS, ou SYSTEM pour Windows Server. Un test raté indique SSM Agent le service n'est pas en cours d'exécution ou ne s'exécute pas en tant que root ou SYSTEM. |
| Configuration du proxy | Indique si SSM Agent est configuré pour utiliser un proxy. |
| État de l'image Sysprep (Windows uniquement) | Indique l'état Sysprep du nœud. SSM Agent ne démarrera pas sur le nœud si l'Sysprepétat est une valeur autre queIMAGE_STATE_COMPLETE. |
| SSM Agent version | Indique si la dernière version disponible de SSM Agent est installé. |
