Guide détaillé : mise à jour automatique de SSM Agent avec l’AWS CLI - AWS Systems Manager

Guide détaillé : mise à jour automatique de SSM Agent avec l’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 recevoir des notifications concernant les mises à jour de SSM Agent, inscrivez‑vous sur la page SSM Agent Release Notes du site Web de GitHub.

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 en savoir plus, consultez Configuration de nœuds gérés pour AWS Systems Manager.

Si vous créez une association en utilisant AWS CLI ou AWS Tools for Windows PowerShell, utilisez le paramètre --Targets pour les instances cibles, comme illustré à 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. Si vous ne l'avez pas déjà fait, installez et configurez l'AWS Command Line Interface (AWS CLI).

    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.