Procedura dettagliata: aggiorna SSM Agent automaticamente con AWS CLI - AWS Systems Manager

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Procedura dettagliata: aggiorna SSM Agent automaticamente con AWS CLI

La procedura seguente ti guiderà attraverso il processo di creazione di un'associazione di State Manager utilizzando AWS Command Line Interface. L'associazione aggiorna automaticamente l'SSM Agent in base a una pianificazione da te specificata. Per ulteriori informazioni su SSM Agent, consultare Utilizzo di SSM Agent. Per personalizzare la pianificazione degli aggiornamenti per SSM Agent tramite la console, consultare Aggiornamento automatico di SSM Agent.

Per ricevere notifiche sugli aggiornamenti dell'SSM Agent, iscriviti alla pagina Note di rilascio dell'SSM Agent su GitHub.

Prima di iniziare

Prima di completare la seguente procedura, verifica di avere almeno un'istanza Amazon Elastic Compute Cloud (Amazon EC2) per Linux in Windows Server esecuzione o configurata per Systems Manager. macOS Per ulteriori informazioni, consulta Configurazione di nodi gestiti per AWS Systems Manager.

Se crei un'associazione utilizzando AWS CLI o AWS Tools for Windows PowerShell, usa il --Targets parametro per indirizzare le istanze, come mostrato nell'esempio seguente. Non utilizzare il parametro --InstanceID. Il parametro --InstanceID è un parametro legacy.

Per creare un'associazione per aggiornare automaticamente l'SSM Agent

  1. Installa e configura AWS Command Line Interface (AWS CLI), se non l'hai già fatto.

    Per informazioni, consulta la pagina Installazione o aggiornamento della versione più recente di AWS CLI.

  2. Esegui il comando seguente per creare un'associazione indirizzando le istanze utilizzando i tag Amazon Elastic Compute Cloud (Amazon EC2). Sostituisci ogni example resource placeholder con le tue informazioni. Il parametro Schedule imposta una pianificazione per eseguire l'associazione ogni domenica mattina alle 2:00 (UTC).

    Le associazioni di State Manager non supportano tutte le espressioni cron e rate. Per ulteriori informazioni sulla creazione di espressioni cron e rate per le associazioni, consulta Riferimento: espressioni Cron e Rate per 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 *)"

    Puoi indirizzare più istanze specificando le istanze in un elenco separato da virgole. IDs

    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 *)"

    È possibile specificare la versione dell'SSM Agent a cui desideri aggiornare.

    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

    Il sistema restituisce informazioni simili alle seguenti.

    {
    "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"
            }
        ]
    }
}

    Il sistema tenta di creare l'associazione sulla/e istanza/e e applica lo stato dopo la creazione. L'associazione presenta lo stato Pending.

  3. Eseguire il comando seguente per visualizzare uno stato aggiornato dell'associazione creata. 

    aws ssm list-associations

    Se le istanze non stanno eseguendo attualmente la versione più recente dell'SSM Agent, lo stato mostra Failed. Quando viene pubblicata una nuova versione dell'SSM Agent, l'associazione installa automaticamente il nuovo agente e lo stato mostra Success.