Búsqueda de AMIs con SSM Agent preinstalado - AWS Systems Manager
Verificación del estado de SSM Agent

Búsqueda de AMIs con SSM Agent preinstalado

AWS Systems Manager Agent (SSM Agent) viene preinstalado en algunos Amazon Machine Images (AMIs) proporcionados por AWS y por terceros de confianza.

Por ejemplo, cuando lanza una instancia de Amazon Elastic Compute Cloud (Amazon EC2), creada desde una AMI con uno de los siguientes sistemas operativos, es probable que se dé cuenta de que SSM Agent ya está instalado:

  • AlmaLinux

  • Base AMI de Amazon Linux 1 con fecha de 09/2017 y posterior

  • Amazon Linux 2

  • AMIs básicas optimizadas para ECS de Amazon Linux 2

  • Amazon Linux 2023 (AL2023)

  • AMIs de Amazon Linux optimizada para Amazon EKS

  • macOS 10.14.x (Mojave), 10.15.x (Catalina), 11.x (Big Sur), 12.x (Monterey), 13.x (Ventura), and 14.x (Sonoma)

  • SUSE Linux Enterprise Server (SLES) 12 y 15

  • Ubuntu Server 16.04, 18.04, 20.04 y 22.04

  • Windows Server AMIs 2008-2012 R2 publicadas en noviembre de 2016 o posteriormente

  • Windows Server 2016, 2019 y 2022 (no se incluyen las versiones Nano)

nota

Es posible que la versión del SSM Agent preinstalada en una AMI no sea la última disponible. Como práctica recomendada, recomendamos utilizar siempre la versión más reciente disponible del SSM Agent en los nodos administrados. Para obtener más información sobre la automatización de las actualizaciones del SSM Agent, consulte Automatización de las actualizaciones de SSM Agent.

SSM Agent puede estar preinstalado en las AMIs administradas por AWS que no estén en esta lista. Esto generalmente indica que el sistema operativo (SO) no es totalmente compatible con todas las capacidades de Systems Manager.

Puede que SSM Agent también esté preinstalado en AMIs encontradas en AWS Marketplace o en el repositorio de AMIs de la comunidad; sin embargo, AWS no admite esas AMIs.

Verificación del estado de SSM Agent

Dependiendo de cuándo se inicializó, es posible que una instancia creada a partir de una AMI de la lista anterior no tenga SSM Agent preinstalado. También es posible que una instancia tenga el agente preinstalado, pero el agente no se esté ejecutando. Por lo tanto, le recomendamos que verifique el estado de SSM Agent antes de intentar usar Systems Manager en una instancia por primera vez.

Siga este procedimiento para verificar que SSM Agent está instalado y en ejecución en una instancia. Si descubre que el agente no está instalado, puede instalarlo de manera manual en instancias de Linux, macOS y Windows Server.

Para verificar la instalación de SSM Agent en una instancia

  1. Después de lanzar una instancia, espere unos minutos para que se inicie.

  2. Conéctese a la instancia mediante el método que prefiera. Por ejemplo, puede usar SSH para conectarse a instancias de Linux o usar el escritorio remoto para conectarse a instancias de Windows Server.

  3. Ejecute el comando correspondiente al tipo de sistema operativo de la instancia para comprobar el estado de SSM Agent.

    Sistema operativo Comando
    Amazon Linux 1 sudo status amazon-ssm-agent
    Amazon Linux 2 y Amazon Linux 2023 sudo systemctl status amazon-ssm-agent
    macOS No hay ningún comando para comprobar el estado del SSM Agent en macOS. Puede comprobar el estado si localiza y evalúa el archivo de registro del agente /var/log/amazon/ssm/amazon-ssm-agent.log.
    SUSE Linux Enterprise Server sudo systemctl status amazon-ssm-agent
    Ubuntu Server (32 bits) sudo status amazon-ssm-agent
    Ubuntu Server (64 bits - Deb) sudo systemctl status amazon-ssm-agent
    Ubuntu Server (64 bits - Snap) sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
    Windows Server Get-Service AmazonSSMAgent
    sugerencia

    Para ver los comandos con los que se puede comprobar el estado de SSM Agent en todos los tipos de sistemas operativos admitidos por Systems Manager, consulte Verificación del estado de SSM Agent e inicio del agente.

  4. Evalúe el resultado del comando para conocer el estado de SSM Agent.

    Estado: instalado y en ejecución

    En la mayoría de los casos, el resultado del comando indica de que el agente está instalado y se está ejecutando.

    En el siguiente ejemplo se muestra que SSM Agent está instalado y se está ejecutando en una instancia de Amazon Linux 2.

    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--

    En el siguiente ejemplo se muestra que SSM Agent está instalado y se está ejecutando en una instancia de Windows Server.

    Status   Name               DisplayName
------   ----               -----------
Running  AmazonSSMAgent     Amazon SSM Agent
    Estado: instalado, pero no en ejecución

    En algunos casos, el resultado del comando indica de que el agente está instalado, pero que no se está ejecutando.

    En el siguiente ejemplo se muestra que SSM Agent está instalado, pero que no se está ejecutando en una instancia de Amazon Linux 2.

    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--

    En el siguiente ejemplo se muestra que SSM Agent está instalado, pero que no se está ejecutando en una instancia de Windows Server.

    Status   Name               DisplayName
------   ----               -----------
Stopped  AmazonSSMAgent     Amazon SSM Agent

    Si el agente está instalado, pero no se está ejecutando, actívelo de manera manual mediante el comando correspondiente al tipo de sistema operativo de su instancia.

    Sistema operativo Comando
    Amazon Linux 1 sudo start amazon-ssm-agent
    Amazon Linux 2 y Amazon Linux 2023

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent
    macOS

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

    sudo launchctl start com.amazon.aws.ssm
    SUSE Linux Enterprise Server

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent
    Ubuntu Server (32 bits)

    sudo start amazon-ssm-agent
    Ubuntu Server (64 bits - Deb)

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent
    Ubuntu Server (64 bits - Snap) sudo snap start amazon-ssm-agent
    Windows Server

    Ejecute el siguiente comando en PowerShell.

    Start-Service AmazonSSMAgent
    Estado: No instalado

    En algunos casos, el resultado del comando indica que el agente no está instalado.

    En el siguiente ejemplo se muestra que SSM Agent no está instalado en una instancia de Amazon Linux 2.

    Unit amazon-ssm-agent.service could not be found.

    En el siguiente ejemplo se muestra que SSM Agent no está instalado en una instancia de Windows Server.

    Get-Service : Cannot find any service with service name 'AmazonSSMAgent'.
--truncated--

    Si el agente no está instalado, puede instalarlo manualmente mediante el procedimiento correspondiente al tipo de sistema operativo: