Demonstração: atualizar automaticamente o SSM Agent (CLI)

O procedimento a seguir demonstra o processo de criação de uma associação do State Manager usando a AWS Command Line Interface. A associação atualiza automaticamente o SSM Agent de acordo com uma programação que você especifica. Para obter mais informações sobre o SSM Agent, consulte Trabalhar com o SSM Agent. Para personalizar o agendamento de atualização do SSM Agent usando o console, consulte Atualizar automaticamente o SSM Agent.

Para receber notificações sobre atualizações do SSM Agent, inscreva-se na página Notas de versão do SSM Agent no GitHub.

Antes de começar

Antes de concluir o procedimento a seguir, verifique se você tem pelo menos uma instância do Amazon Elastic Compute Cloud (Amazon EC2) para o Linux, macOS ou Windows Server em execução configurada para o Systems Manager. Para ter mais informações, consulte Configurar o AWS Systems Manager.

Se você criar uma associação usando a AWS CLI ou o AWS Tools for Windows PowerShell, use o parâmetro --Targets para as instâncias de destino, conforme mostrado no exemplo a seguir. Não use o parâmetro --InstanceID. O parâmetro --InstanceID é um parâmetro legado.

Para criar uma associação para atualizar automaticamente o SSM Agent

1. Instale e configure a AWS Command Line Interface (AWS CLI), caso ainda não o tenha feito.

   Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI.

2. Execute o comando a seguir para criar uma associação com instâncias como destinos com etiquetas do Amazon Elastic Compute Cloud (Amazon EC2). Substitua cada espaço reservado para recurso de exemplo por suas próprias informações. O parâmetro Schedule define um agendamento para executar a associação todos os domingos de manhã às 2h. (UTC).

   As associações do State Manager, não comportam todas as expressões cron e de taxa. Para obter mais informações sobre como criar expressões cron e rate para associações, consulte Referência: Expressões cron e rate para o 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 *)"

   Se você quiser, também poderá especificar várias instâncias de destino indicando os IDs de instâncias em uma lista separada por vírgulas.

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

   Você pode especificar a versão do SSM Agent para a qual deseja atualizar.

   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

   O sistema retorna informações como estas.

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

   O sistema tenta criar a associação na(s) instância(s) e aplicar imediatamente o estado. O status da associação mostra Pending.

3. Execute o comando a seguir para visualizar um status atualizado da associação que você acabou de criar.

   aws ssm list-associations

   Se suas instâncias não estiverem executando a versão mais recente do SSM Agent, o status mostrará Failed. Quando uma nova versão do SSM Agent é publicada, a associação instala automaticamente o novo agente e o status mostra Success.