Procédure pas à pas : mise à jour automatique SSM Agent avec le AWS CLI

Pour créer une association à mettre à jour automatiquement SSM Agent

1. Installez et configurez le AWS Command Line Interface (AWS CLI), si ce n'est pas déjà fait.

   Pour de plus amples informations, consultez Installation ou mise à jour de la version la plus récente de l' AWS CLI.

2. Exécutez la commande suivante pour créer une association en ciblant les instances à l'aide des balises Amazon Elastic Compute Cloud (Amazon EC2). Remplacez chaque example resource placeholder par vos propres informations. Le paramètre Schedule définit une planification pour exécuter l'association tous les dimanches matin à 2 h 00 (UTC).

   State Manager les associations ne supportent pas toutes les expressions cron et rate. Pour plus d'informations sur la création d'expressions cron et rate pour des associations, consultez Référence : Expressions Cron et Rate pour Systems Manager.

   Linux & macOS

   aws ssm create-association \
   --targets Key=tag:tag_key,Values=tag_value \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)"

   Windows

   aws ssm create-association ^
   --targets Key=tag:tag_key,Values=tag_value ^
   --name AWS-UpdateSSMAgent ^
   --schedule-expression "cron(0 2 ? * SUN *)"

   anchoranchor
   • Linux & macOS
   • Windows

   aws ssm create-association \
   --targets Key=tag:tag_key,Values=tag_value \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)"

   Vous pouvez cibler plusieurs instances en les spécifiant IDs dans une liste séparée par des virgules.

   Linux & macOS

   aws ssm create-association \
   --targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)"

   Windows

   aws ssm create-association ^
   --targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID ^
   --name AWS-UpdateSSMAgent ^
   --schedule-expression "cron(0 2 ? * SUN *)"

   anchoranchor
   • Linux & macOS
   • Windows

   aws ssm create-association \
   --targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)"

   Vous pouvez spécifier la version du SSM Agent vous souhaitez effectuer une mise à jour vers.

   Linux & macOS

   aws ssm create-association \
   --targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)" \
   --parameters version=ssm_agent_version_number

   Windows

   aws ssm create-association ^
   --targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID ^
   --name AWS-UpdateSSMAgent ^
   --schedule-expression "cron(0 2 ? * SUN *)" ^
   --parameters version=ssm_agent_version_number

   anchoranchor
   • Linux & macOS
   • Windows

   aws ssm create-association \
   --targets Key=instanceids,Values=instance_ID,instance_ID,instance_ID \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)" \
   --parameters version=ssm_agent_version_number

   Le système retourne des informations telles que les suivantes.

   {
       "AssociationDescription": {
           "ScheduleExpression": "cron(0 2 ? * SUN *)",
           "Name": "AWS-UpdateSSMAgent",
           "Overview": {
               "Status": "Pending",
               "DetailedStatus": "Creating"
           },
           "AssociationId": "123..............",
           "DocumentVersion": "$DEFAULT",
           "LastUpdateAssociationDate": 1504034257.98,
           "Date": 1504034257.98,
           "AssociationVersion": "1",
           "Targets": [
               {
                   "Values": [
                       "TagValue"
                   ],
                   "Key": "tag:TagKey"
               }
           ]
       }
   }

   Le système tente de créer l'association sur les instances et applique l'état la création d'état suivante. Le statut de l'association indique Pending.

3. Exécutez la commande suivante pour afficher le statut mis à jour de l'association que vous avez créé.

   aws ssm list-associations

   Si vos instances n'exécutent pas la version la plus récente du SSM Agent, le statut s'afficheFailed. Lorsqu'une nouvelle version de SSM Agent est publié, l'association installe automatiquement le nouvel agent et le statut s'afficheSuccess.