Instalar e desinstalar o SSM Agent manualmente em instâncias do EC2 para macOS

Conecte-se à instância do macOS e execute as seguintes etapas para instalar o AWS Systems Manager Agent (SSM Agent): Realize essas etapas em cada instância que executará comandos usando o Systems Manager. Os comandos fornecidos neste procedimento também podem ser passados para instâncias do Amazon EC2 como scripts por meio de dados do usuário.

Para instalar o SSM Agent no macOS

1. Baixe o arquivo do instalador do agente para instâncias x86_64 usando o comando a seguir.

   No comando a seguir, substitua region por suas próprias informações. Para ver uma lista dos valores de região com suporte, consulte a coluna Region em Systems Manager service endpoints no Referência geral da Amazon Web Services.

   sudo wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/darwin_amd64/amazon-ssm-agent.pkg

   Para instâncias Apple silicon use o comando a seguir.

   sudo wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/darwin_arm64/amazon-ssm-agent.pkg

   Aqui está um exemplo.

   sudo wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/darwin_amd64/amazon-ssm-agent.pkg

2. Use o seguinte comando para fazer download e executar o instalador do SSM Agent.

   x86_64:

   sudo installer -pkg amazon-ssm-agent.pkg -target /

3. Verifique o status do agente.

   Para determinar se o SSM Agent está em execução, verifique o log do agente em /var/log/amazon/ssm/amazon-ssm-agent.log.

4. Execute o comando a seguir para iniciar o serviço se o log do agente indicar “amazon-ssm-agent is stopped”.

   sudo launchctl load -w /Library/LaunchDaemons/com.amazon.aws.ssm.plist && sudo launchctl start com.amazon.aws.ssm

Importante

Uma versão atualizada do SSM Agent é lançada sempre que novos recursos são adicionados ao Systems Manager ou sempre que atualizações forem feitas nos recursos existentes. Deixar de usar a versão mais recente do agente pode impedir que seu nó gerenciado use vários recursos do Systems Manager. Por isso, recomendamos automatizar o processo de manter o SSM Agent atualizado em suas máquinas. Para ter mais informações, consulte Automatizar atualizações do SSM Agent. Inscreva-se na página Notas de versão do SSM Agent no GitHub para receber notificações sobre atualizações do SSM Agent.

Desinstalar o SSM Agent de instâncias macOS

O macOS não oferece suporte de forma nativa à desinstalação dos arquivos PKG. Para desinstalar o AWS Systems Manager Agent (SSM Agent) de uma instância do Amazon Elastic Compute Cloud (Amazon EC2) para o macOS, use o script gerenciado pela AWS a partir do local a seguir.

https://github.com/aws/amazon-ssm-agent/blob/mainline/Tools/src/update/darwin/uninstall.sh