Démonstration : Mise à jour automatique de l'SSM Agent (CLI)

La procédure suivante vous guide au cours du processus de création d'une association State Manager à l'aide de l' AWS Command Line Interface. L'association met automatiquement à jour SSM Agent selon une planification que vous spécifiez. Pour plus d'informations sur SSM Agent, consultez Utilisation de l’option SSM Agent. Pour personnaliser le calendrier des mises à jour pour SSM Agent en utilisant la console, consultez Mise à jour automatique de l'SSM Agent.

Pour être informé des SSM Agent mises à jour, abonnez-vous à la page des notes de SSM Agent publication surGitHub.

Avant de commencer

Avant de réaliser la procédure suivante, veillez à avoir au moins une instance Amazon Elastic Compute Cloud (Amazon EC2) en cours d'exécution pour Linux, macOS ou Windows Server configurée pour Systems Manager. Pour plus d’informations, consultez Configuration de AWS Systems Manager.

Si vous créez une association en utilisant le AWS CLI ou AWS Tools for Windows PowerShell, utilisez le --Targets paramètre pour cibler les instances, comme illustré dans l'exemple suivant. N'utilisez pas le paramètre --InstanceID. Le paramètre --InstanceID est un paramètre hérité.

Pour créer une association afin de 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 avec des balises Amazon Elastic Compute Cloud (Amazon EC2). Remplacez chaque example resource placeholder (espace réservé pour les ressources) avec vos propres informations. Le paramètre Schedule définit une planification pour exécuter l'association tous les dimanches matin à 2 h 00 (UTC).

   Les associations State Manager ne prennent pas en charge 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 *)"

   Vous pouvez cibler plusieurs instances en spécifiant les ID d'instance 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 *)"

   Vous pouvez spécifier la version de l'SSM Agent à laquelle vous voulez faire la mise à jour.

   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

   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 de SSM Agent pour l'instant, l'état indique Failed. Lors de la publication d'une nouvelle version d'SSM Agent, l'association installe automatiquement le nouvel agent et le statut indique Success.