Como adiciono uma instância do Lightsail ao Systems Manager?

Breve descrição

O Systems Manager não está disponível diretamente para instâncias do Lightsail.

Você pode usar uma ativação híbrida para adicionar sua instância do Lightsail ao Systems Manager. Para solucionar problemas de conexão SSH, use o Gerenciador de Sessões para acessar sua instância do Lightsail sem acesso SSH. Session Manager é um recurso do AWS Systems Manager.

Resolução

Gere um código de ativação híbrido e um ID para o Systems Manager

1. Abra o console do AWS Systems Manager.
2. No painel de navegação, em Gerenciamento de nó, selecione Ativações híbridas.
3. Selecione Criar ativação. Use os seguintes parâmetros:
   Descrição da ativação: insira uma descrição.
   Limite de instância: insira o número de instâncias que você deseja registrar.
   Perfil do IAM: selecione Criar uma função de execução de comando padrão do sistema que tenha as permissões necessárias para criar automaticamente uma função chamada AmazonEC2RunCommandRoleForManagedInstances.
4. Selecione Criar ativação.

Você recebe uma mensagem semelhante à seguinte:

"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 o Código de Ativação e o ID de Ativação da mensagem que você recebe.

Adicione uma instância do Lightsail em execução ao Systems Manager

Use o procedimento a seguir se você tiver acesso SSH à instância por meio do console do navegador ou por meio de um cliente SSH. Se não tiver acesso SSH, consulte a seção Adicionar uma instância do Lightsail ao Systems Manager na inicialização.

Para adicionar uma instância do Lightsail em execução ao Systems Manager, conclua as etapas a seguir:

1. Faça login na instância do Lightsail. Instale o 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

   Observação: esses comandos instalam o SSM Agent em uma instância do Debian Lightsail. As instâncias do Lightsail com tecnologia Bitnami usam o sistema operacional Debian. Para instalar outros sistemas operacionais, consulte Como instalar o Agente SSM em nós Linux híbridos.

2. Execute o comando a seguir para registrar a instância no Systems Manager. Substitua code pelo seu código de ativação e id pelo seu ID de ativação. Substitua region pela sua Região da AWS:

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

3. Execute o comando a seguir para reiniciar o SSM Agent:

   sudo systemctl restart amazon-ssm-agent

4. No console do AWS Systems Manager, selecione Fleet Manager. Sua instância do Lightsail aparece com um ID prefixado com mi-.

5. Em Status de ping do SSM Agent, verifique se a instância está on-line. Se a instância estiver on-line, selecione a instância.

6. Selecione Ações da instância e, em seguida, selecione Iniciar sessão.

Adicione uma instância do Lightsail ao Systems Manager na inicialização

Se você tiver problemas de conexão SSH, use o procedimento a seguir.

Para adicionar uma instância do Lightsail ao Systems Manager quando a instância for iniciada, envie o código de ativação por meio de um script de dados do usuário:

1. Tire um snapshot da instância.

2. Inicie uma nova instância do Lightsail a partir do snapshot.

3. Durante a execução da instância, selecione Adicionar script de execução.

4. Adicione o código a seguir ao campo Script de execução.   Inclua o comando sudo amazon-ssm-agent -register com seu ID de ativação, código de ativação e região da 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

   Observação: esses comandos instalam o SSM Agent em uma instância do Debian Lightsail. As instâncias do Lightsail com tecnologia Bitnami usam o sistema operacional Debian. Para instalar outros sistemas operacionais, consulte Como instalar o Agente SSM em nós Linux híbridos.

5. Conclua o procedimento em Adicionar uma instância do Lightsail em execução ao Systems Manager para acessar a instância a partir do console do AWS Systems Manager.