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

Descrição breve

O AWS Systems Manager não está disponível diretamente para instâncias do Lightsail. No entanto, você pode adicionar sua instância do Lightsail ao Systems Manager usando uma ativação híbrida. Você também pode usar o AWS Systems Manager Session Manager para acessar sua instância do Lightsail sem acesso SSH. Isso pode ser usado para solucionar problemas de conexão SSH.

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ós, escolha Ativações híbridas.

3.    Selecione Criar ativação e, em seguida, use os seguintes parâmetros para a nova ativação híbrida:

Descrição da ativação: insira qualquer descrição.

Limite de instâncias: insira o número de instâncias que você precisa registrar usando este código.

Função do IAM: escolha Criar uma função de execução de comando padrão do sistema que tenha as permissões necessárias. Isso cria automaticamente uma função chamada AmazonEC2RunCommandRoleForManagedInstances.

Todos os outros campos são opcionais.

4.    Selecione Criar ativação. Você recebe uma mensagem semelhante a esta.

Importante: registre o código de ativação e o ID de ativação. Exemplos disso são mostrados no exemplo a seguir:

“Você criou com sucesso uma nova ativação. Seu código de ativação está listado abaixo. Copie o código e guarde-o em um local seguro, pois você não poderá acessá-lo novamente.

Código de ativação byjELxxxxxxD0jmSP

ID de ativação: 1d7103ea-xxxxxxxxxxxxxxxx52258ac0b4

Agora você pode instalar o amazon-ssm-agent e gerenciar sua instância usando Run Command.”

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

Observação: o método funciona quando você tem acesso SSH à instância por meio do console do navegador ou por meio de um cliente SSH, como o PuTTY/Terminal. Se você não tiver acesso, consulte a seção a seguir Adicionando uma instância do Lightsail ao Systems Manager durante a execução.

1.    Faça login na instância do Lightsail e instale o AWS Systems Manager Agent (SSM Agent). Os comandos a seguir instalam o Agente SSM em uma Instância do Debian Lightsail. Para obter instruções de instalação para outras versões do sistema operacional, consulte Instalar o Agente SSM para um ambiente híbrido (Linux).

Observação: As instâncias do Lightsail com tecnologia Bitnami usam o sistema operacional Debian.

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

2.    Após a conclusão da instalação, registre a instância no Systems Manager usando o comando a seguir e reinicie o agente. No exemplo de comando a seguir, substitua o código de ativação, o ID e a Região.

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

3.    No console do AWS Systems Manager, selecione Fleet Manager. Sua Instância do Lightsail aparece com um ID prefixado com “mi-”. Em Status de ping do SSM Agent, verifique se a instância está online.

4.    Se a instância estiver online, selecione a instância, selecione Ações da instância e escolha Iniciar sessão. Agora você pode acessar a instância como uma instância gerenciada normal.

Adição de uma instância do Lightsail ao Systems Manager durante a execução

Você pode usar o método para uma instância com problemas de conexão SSH. Para solucionar problemas de uma instância, primeiro tire um snapshot da instância e, em seguida, execute uma nova instância do Lightsail a partir do snapshot.

Para adicionar uma instância do Lightsail ao Systems Manager quando a instância for iniciada, envie o código de ativação usando um script de dados do usuário. Esse processo é semelhante à adição de dados do usuário ao executar uma instância do Amazon Elastic Compute Cloud (Amazon EC2).

1.    Ao iniciar uma nova instância ou executar uma instância a partir de um snapshot, selecione Adicionar script de execução.

2.    Adicione o código a seguir ao campo Launch script. Os comandos a seguir instalam o SSM Agent em uma instância do Debian Lightsail.

Para obter instruções de instalação para outras versões do sistema operacional, consulte Instalar o SSM Agent para um ambiente híbrido. Verifique e confirme a inclusão do comando sudo amazon-ssm-agent-register com o ID de ativação, o código de ativação e a região corretos no script de inicialização.

Observação: As instâncias do Lightsail com tecnologia Bitnami usam o sistema operacional Debian.

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

2.     Depois que a instância for iniciada, acesse-a no console do AWS Systems Manager usando as mesmas etapas da seção anterior.

---