Guida passo dopo passo: Aggiornamento automatico di SSM Agent (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, consulta 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 SSM Agent aggiornamenti, iscriviti alla pagina Note di SSM Agent rilascio suGitHub.

Prima di iniziare

Prima di completare la procedura seguente, verificare di disporre di almeno un'istanza Amazon Elastic Compute Cloud (Amazon EC2) in esecuzione per Linux, macOS o Windows Server configurata per Systems Manager. Per ulteriori informazioni, consulta Configurazione di 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 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 scegliendo come target le istanze tramite i tag Amazon Elastic Compute Cloud (Amazon EC2). Sostituisci ciascun segnaposto delle risorse di esempio 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 *)"

   È inoltre possibile definire come target più istanze specificando gli ID delle istanze 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 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.