¿Cómo puedo agregar una instancia de Lightsail a Systems Manager?

Breve descripción

Systems Manager no está disponible directamente para las instancias de Lightsail.

Puede usar una activación híbrida para añadir su instancia de Lightsail a Systems Manager. Para solucionar problemas de conexión de SSH, utilice el Administrador de sesiones para acceder a su instancia de Lightsail sin acceso de SSH. El Administrador de sesiones es una función de AWS Systems Manager.

Solución

Generación de un código y un ID de activación híbridos para Systems Manager

1. Abra la consola de AWS Systems Manager.
2. En el panel de navegación, en Administración de nodos, elija Activaciones híbridas.
3. Elija Crear activación. Utilice los parámetros siguientes:
   Descripción de la activación: introduzca una descripción.
   Límite de instancias: introduzca el número de instancias que desea registrar.
   Rol de IAM: seleccione Crear un rol de ejecución de comandos predeterminado del sistema con los permisos necesarios para crear un rol denominado AmazonEC2RunCommandRoleForManagedInstances automáticamente.
4. Elija Crear activación.

Se muestra un mensaje similar al siguiente:

«You have successfully created a new activation. Your activation code is listed below. Copy this code and keep it in a safe place as you will not be able to access it again.

Activation Code byjELxxxxxxD0jmSP

Activation ID 1d7103ea-xxxxxxxxxxxxxxxx52258ac0b4

You can now install amazon-ssm-agent and manage your instance using Run Command.»

Importante: Anote el código y el ID de activación del mensaje que ha recibido.

Agregación de una instancia de Lightsail en ejecución a Systems Manager

Use el siguiente procedimiento si tiene acceso de SSH a la instancia a través de la consola del navegador o mediante un cliente de SSH. Si no tiene acceso de SSH, consulte la sección Agregación de una instancia de Lightsail a Systems Manager en el momento del inicio.

Para añadir una instancia de Lightsail en ejecución a Systems Manager, siga estos pasos:

1. Inicie sesión en la instancia de Lightsail. Instale AWS Systems Manager Agent (SSM Agent):

   sudo mkdir /tmp/ssm
   sudo cd /tmp/ssm
   wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
   sudo dpkg -i amazon-ssm-agent.deb
   sudo systemctl restart amazon-ssm-agent
   sudo systemctl enable amazon-ssm-agent

   Nota: Estos comandos instalan SSM Agent en una instancia de Lightsail de Debian. Las instancias de Lightsail con tecnología Bitnami utilizan el sistema operativo Debian. Para instalar otros sistemas operativos, consulte Cómo instalar el agente SSM en nodos Linux híbridos.

2. Ejecute el siguiente comando para registrar la instancia en Systems Manager. Reemplace code por el código de activación e id por el ID de activación. Reemplace region por su región de AWS:

   sudo amazon-ssm-agent -register -y -id '1d7xxxxxxxxxxxx1a52258ac0b4' -code 'byjELGxxxxxxx0jmSP' -region 'ap-south-1'
   

3. Ejecute el siguiente comando para reiniciar SSM Agent:

   sudo systemctl restart amazon-ssm-agent

4. En la consola de AWS Systems Manager, elija Fleet Manager. Su instancia de Lightsail aparece con un ID con el prefijo mi-.

5. En Estado de ping del SSM Agent, compruebe si la instancia está en línea. Si lo está, selecciónela.

6. Elija Acciones de la instancia y, a continuación, Iniciar sesión.

Agregación de una instancia de Lightsail a Systems Manager en el momento del inicio

Si tiene problemas con la conexión de SSH, utilice el siguiente procedimiento. 

Para añadir una instancia de Lightsail a Systems Manager cuando se lance la instancia, envíe el código de activación en un script de datos de usuario:

1. Tome una instantánea de la instancia.

2. Lance una nueva instancia de Lightsail a partir de la instantánea.

3. Durante el inicio de la instancia, elija Añadir un script de lanzamiento.

4. Agregue el siguiente código al campo Script de lanzamiento.   Incluya el comando sudo amazon-ssm-agent -register con su ID de activación, el código de activación y la región de AWS:

   sudo mkdir /tmp/ssm
       sudo cd /tmp/ssm
       wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
       sudo dpkg -i amazon-ssm-agent.deb
       sudo systemctl enable amazon-ssm-agent
       sudo amazon-ssm-agent -register -y -id '1d7xxxxxxxxxxxx1a52258ac0b4' -code 'byjELGxxxxxxx0jmSP' -region 'ap-south-1'
       sudo systemctl restart amazon-ssm-agent

   Nota: Estos comandos instalan SSM Agent en una instancia de Lightsail de Debian. Las instancias de Lightsail con tecnología Bitnami utilizan el sistema operativo Debian. Para instalar otros sistemas operativos, consulte Cómo instalar el agente SSM en nodos Linux híbridos.

5. Complete el procedimiento que se describen en Agregación de una instancia de Lightsail en ejecución a Systems Manager para acceder a la instancia desde la consola de AWS Systems Manager.