AWS Systems Manager
Guia do usuário

Iniciar uma sessão

Você pode usar o console do AWS Systems Manager, a AWS CLI ou o SSH para iniciar uma sessão.

Iniciar uma sessão (console)

Você pode usar o console do AWS Systems Manager para iniciar uma sessão com uma instância na sua conta.

Para iniciar uma sessão (console)

  1. Abrir o console do AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, selecione Session Manager.

    -ou-

    Se a página inicial do AWS Systems Manager for aberta primeiro, selecione o ícone do menu ( ) para abrir o painel de navegação e escolha Session Manager no painel de navegação.

  3. Selecione Start session (Iniciar sessão).

  4. Na lista Target instances (Instâncias de destino), escolha o botão de opção à esquerda da instância à qual você deseja se conectar.

    Se uma instância que você deseja se conectar não estiver na lista, ou estiver listada, mas uma mensagem de erro informar "A instância que você selecionou não está configurada para usar Session Manager",consulte Instância não disponível ou não configurada para Session Manager para seguir as etapas de solução de problemas.

  5. Selecione Start session (Iniciar sessão).

Depois que a conexão é feita, você pode executar os comandos bash (Linux) ou PowerShell (Windows) como faria com qualquer outro tipo de conexão.

Iniciar uma sessão (AWS CLI)

Para iniciar uma sessão usando a AWS CLI, execute o seguinte comando:

nota

To use the AWS CLI to run session commands, the Session Manager plugin must also be installed on your local machine. For information, see (Opcional) Instalação do Session Manager Plugin para AWS CLI.

aws ssm start-session --target instance-id

instance-id representa o ID de uma instância configurada para uso com AWS Systems Manager e sua capacidade Session Manager. Por exemplo: i-02573cafcfEXAMPLE.

Para obter informações sobre outras opções que você pode usar com o comando start-session, consulte start-session no AWS Systems Manager section of the AWS CLI Command Reference.

Iniciar uma sessão (SSH)

Para iniciar uma sessão usando SSH, execute o seguinte comando:

nota

Para iniciar uma sessão usando SSH, sua instância de destino deve ser configurada para oferecer suporte a conexões SSH. Para obter mais informações, consulte (Opcional) Habilitar conexões SSH por meio do Session Manager.

ssh -i /path/my-key-pair.pem username@instance-id

/path/my-key-pair.pem representa o caminho para o certificado Privacy Enhanced Mail (PEM - E-mails reforçados para privacidade).

username@instance-id representa o nome do usuário que você usa para conectar-se à instância e o ID da instância. Por exemplo: JaneDoe@i-02573cafcfEXAMPLE.

dica

Ao iniciar uma sessão usando SSH, você pode copiar arquivos locais na instância de destino usando o seguinte formato de comando.

scp -i /path/my-key-pair.pem /path/SampleFile.txt username@instance-id:~

Para obter informações sobre outras opções que você pode usar com o comando start-session, consulte start-session no AWS Systems Manager section of the AWS CLI Command Reference.

Iniciar uma sessão (encaminhamento de portas)

Para iniciar uma sessão de encaminhamento de portas, execute o seguinte comando na CLI:

nota

Para usar a CLI da AWS para executar comandos de sessão, o Session Manager plugin também deve ser instalado em sua máquina local. Para obter mais informações, consulte (Opcional) Instalação do Session Manager Plugin para AWS CLI.

aws ssm start-session --target instance-id --document-name AWS-StartPortForwardingSession --parameters '{"portNumber":["80"], "localPortNumber":["56789"]}'

instance-id representa o ID de uma instância configurada para uso com AWS Systems Manager e sua capacidade Session Manager. Por exemplo: i-02573cafcfEXAMPLE.

portNumber representa a porta remota na instância para a qual o tráfego deve ser redirecionado. Por exemplo: 3389 Se esse parâmetro não for especificado, o Session Manager assumirá 80 como a porta remota padrão.

localPortNumber representa a porta local no cliente para a qual o tráfego deve ser redirecionado. Por exemplo: 56789.

Para obter informações sobre outras opções que você pode usar com o comando start-session, consulte start-session no AWS Systems Manager section of the AWS CLI Command Reference.

Iniciar uma sessão (comandos interativos)

Para iniciar uma sessão de comandos interativos, execute o seguinte comando:

nota

Para usar a CLI da AWS para executar comandos de sessão, o Session Manager plugin também deve ser instalado em sua máquina local. Para obter mais informações, consulte (Opcional) Instalação do Session Manager Plugin para AWS CLI.

aws ssm start-session --target instance-id --document-name TestInteractiveCommandSessionDocument --parameters '{"logpath":["/var/log/amazon/ssm/amazon-ssm-agent.log"]}'

instance-id representa o ID de uma instância configurada para uso com AWS Systems Manager e sua capacidade Session Manager. Por exemplo: i-02573cafcfEXAMPLE.

Para obter informações sobre outras opções que você pode usar com o comando start-session, consulte start-session no AWS Systems Manager section of the AWS CLI Command Reference.

Conteúdo relacionado

Port Forwarding Using AWS Systems Manager Session Manager no Blog de notícias da AWS.