Instalar o SSM Agent manualmente em instâncias do Amazon Linux 2 e do Amazon Linux 2023 - AWS Systems Manager

Instalar o SSM Agent manualmente em instâncias do Amazon Linux 2 e do Amazon Linux 2023

Importante

Este tópico fornece comandos para trabalhar com o SSM Agent em instâncias do Amazon Linux 2 e do Amazon Linux 2023. Alguns desses comandos não são compatíveis com instâncias do Amazon Linux 1. Antes de continuar, verifique se você está visualizando o tópico correto para seu tipo de instância. Para executar comandos nas instâncias do Amazon Linux 1, consulte Instalar o SSM Agent manualmente em instâncias do Amazon Linux 1.

Na maioria dos casos, as Amazon Machine Images (AMIs) para Amazon Linux 2 e Amazon Linux 2023 fornecidas pela AWS têm o AWS Systems Manager Agent (SSM Agent) pré-instalado por padrão. Para ter mais informações, consulte Encontrar AMIs com o SSM Agent pré-instalado.

Se o SSM Agent não estiver pré-instalado em uma nova instância do Amazon Linux 2 ou do Amazon Linux 2023, ou se for necessário reinstalar o agente manualmente, use as informações desta página para obter ajuda.

Antes de começar

Antes de instalar o SSM Agent em uma instância do Amazon Linux 2 e do Amazon Linux 2023, observe o seguinte:

  • Para obter informações importantes aplicáveis à instalação do SSM Agent em todos os sistemas operacionais baseados em Linux, consulte Instalar e desinstalar o SSM Agent manualmente em instâncias do EC2 para Linux.

  • Se você usar um comando yum para atualizar o SSM Agent em um nó gerenciado após o agente ter sido instalado ou atualizado usando o documento SSM AWS-UpdateSSMAgent, você poderá ver a seguinte mensagem: “Warning: RPMDB altered outside of yum." (Aviso: RPMDB alterado fora do yum). Essa mensagem é esperada e pode ser ignorada com segurança.

Comandos de instalação rápida do SSM Agent no Amazon Linux 2 ou Amazon Linux 2023

Use as etapas a seguir para instalar o SSM Agent manualmente em uma única instância. Este procedimento usa arquivos de instalação disponíveis globalmente.

Para instalar o SSM Agent no Amazon Linux 2 ou no Amazon Linux 2023 usando comandos rápidos de copiar e colar
  1. Conecte à sua instância do Amazon Linux 2 ou do Amazon Linux 2023 usando o método de sua preferência, como SSH.

  2. Copie o comando correspondente à arquitetura da instância e execute-o na instância.

    nota

    Mesmo que os URLs nos comandos a seguir incluam um diretório ec2-downloads-windows, estes são os arquivos de instalação global corretos para o Amazon Linux 2 e Amazon Linux 2023.

    x86_64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
    ARM64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
  3. (Recomendado) Execute o comando a seguir para verificar se o agente está em execução.

    sudo systemctl status amazon-ssm-agent

    Na maioria dos casos, o comando informa que o agente está em execução, conforme mostrado no exemplo a seguir.

    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: active (running) since Wed 2021-10-20 19:09:29 UTC; 4min 6s ago
                --truncated--

    Em casos raros, o comando informa que o agente está instalado, mas não está em execução, conforme mostrado no exemplo a seguir.

    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: inactive (dead) since Wed 2021-10-20 22:16:41 UTC; 18s ago
                --truncated--

    Para ativar o agente nesses casos, execute o comando a seguir.

    sudo systemctl start amazon-ssm-agent

Criar comandos de instalação do agente personalizados para Amazon Linux 2 ou Amazon Linux 2023 em sua região

Para instalar o SSM Agent em várias instâncias usando um script ou modelo, recomendamos usar arquivos de instalação armazenados no Região da AWS em que você está trabalhando.

Para os comandos a seguir, fornecemos exemplos que usam um bucket do S3 acessível ao público na região Leste dos EUA (Ohio) (us-east-2).

dica

Também é possível substituir um URL global no procedimento Comandos de instalação rápida do SSM Agent no Amazon Linux 1 descrito anteriormente neste tópico por um URL regional personalizado construído por você.

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.

x86_64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm

Veja o exemplo a seguir.

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
ARM64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_arm64/amazon-ssm-agent.rpm

Veja o exemplo a seguir.

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_arm64/amazon-ssm-agent.rpm