Procedura dettagliata: aggiornamento automatico SSM Agent 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: aggiornamento automatico SSM Agent con AWS CLI

La procedura seguente illustra il processo di creazione di un State Manager associazione che utilizza AWS Command Line Interface. L'associazione aggiorna automaticamente il SSM Agent in base a una pianificazione specificata dall'utente. Per ulteriori informazioni sull' SSM Agent, consulta Utilizzo di SSM Agent. Per personalizzare la pianificazione degli aggiornamenti per SSM Agent utilizzando la console, vedereAggiornamento automatico di SSM Agent.

Per ricevere notifiche in merito SSM Agent aggiornamenti, iscriviti al SSM AgentPagina delle note di rilascio su GitHub.

Prima di iniziare

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

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

Per creare un'associazione per l'aggiornamento automatico 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 (AmazonEC2). Sostituisci ciascuno example resource placeholder con le tue informazioni. Il parametro Schedule imposta una pianificazione per eseguire l'associazione ogni domenica mattina alle 2:00 (UTC).

    State Manager le associazioni 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 scegliere come target più istanze specificando le istanze IDs in un elenco separato da virgole.

    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 di SSM Agent a cui si desidera effettuare l'aggiornamento.

    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 tue istanze non eseguono la versione più recente di SSM Agent, lo stato viene visualizzatoFailed. Quando viene aggiunta una nuova versione di SSM Agent viene pubblicata, l'associazione installa automaticamente il nuovo agente e ne viene visualizzato Success lo stato.