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.
Procédure pas à pas : mise à jour automatique SSM Agent avec AWS 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
Avant de commencer
Avant de terminer la procédure suivante, vérifiez que vous disposez d'au moins une instance Amazon Elastic Compute Cloud (AmazonEC2) en cours d'exécution pour Linux ou Windows Server configurée pour Systems Manager. macOS Pour de plus amples informations, veuillez consulter Con AWS Systems Manager figuration.
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
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.
-
Exécutez la commande suivante pour créer une association en ciblant les instances à l'aide des balises Amazon Elastic Compute Cloud (AmazonEC2). Remplacez chacun
example resource placeholder
avec vos propres informations. Le paramètreSchedule
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.
Vous pouvez cibler plusieurs instances en les spécifiant IDs dans une liste séparée par des virgules.
Vous pouvez spécifier la version de l'SSM Agent à laquelle vous voulez faire la mise à jour.
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
. -
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 indiqueSuccess
.