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

Instalar o SSM Agent manualmente em instâncias do Amazon Linux 1

Importante

O Amazon Linux 1 chegou ao fim do ciclo de suporte padrão em 31 de dezembro de 2020 e atingiu o fim da vida útil em 31 de dezembro de 2023, conforme anunciado em Atualização sobre o fim da vida útil do Amazon Linux AMI no Blog de notícias da AWS. A AWS não fornece mais Amazon Machine Images (AMIs) para esse sistema operacional. No entanto, a AWS Systems Manager continua fornecendo suporte para instâncias existentes do Amazon Linux 1.

Este tópico fornece comandos para trabalhar com o SSM Agent em instâncias do Amazon Linux 1. Alguns desses comandos não são compatíveis com instâncias do Amazon Linux 2 e do Amazon Linux 2023. 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 2 ou Amazon Linux 2023, consulte Instalar o SSM Agent manualmente em instâncias do Amazon Linux 2 e do Amazon Linux 2023.

Na maioria dos casos, as Amazon Machine Images (AMIs) para Amazon Linux 1 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 for necessário reinstalar o agente manualmente no Amazon Linux 1, use as informações nesta página para obter ajuda.

Antes de começar

Antes de instalar o SSM Agent em uma instância do Amazon Linux 1, 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 1

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 1 usando comandos rápidos de copiar e colar
  1. Conecte à sua instância do Amazon Linux 1 usando o método preferido, 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 1.

    x86_64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
    x86
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/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 para arquitetura da sua instância para verificar se o agente está em execução.

    x86_64 e x86
    sudo status amazon-ssm-agent
    ARM64
    sudo systemctl status amazon-ssm-agent

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

    x86_64 e x86
    amazon-ssm-agent start/running, process 12345
    ARM64
    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--

    Na casos raros, o comando informa que o agente está instalado, mas não está em execução, conforme mostrado nos exemplos a seguir.

    x86_64 e x86
    amazon-ssm-agent stop/waiting
    ARM64
    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 correspondente à arquitetura da instância.

    x86_64 e x86
    sudo start amazon-ssm-agent
    ARM64
    sudo systemctl start amazon-ssm-agent

Criar comandos de instalação do agente personalizados para o Amazon Linux 1 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
x86
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_386/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_386/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