View a markdown version of this page

Trabalhando com o Amazon Elastic Compute Cloud - AWS Toolkit for VS Code
Pré-requisitosVisualizar instâncias do Amazon EC2 existentesIniciar uma instância do Amazon EC2Conectando o VS Code a uma instância do Amazon EC2Para encerrar uma instância do Amazon EC2Iniciar ou reiniciar uma instância do Amazon EC2Interromper uma instância do Amazon EC2Copiar ID da instânciaNome da cópiaCopiar ARN

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhando com o Amazon Elastic Compute Cloud

As seções a seguir descrevem como trabalhar com o Amazon Elastic Compute Cloud no AWS Toolkit for Visual Studio Code.

Pré-requisitos

Os recursos descritos neste tópico do guia do usuário foram testados em instâncias do Amazon EC2 com os seguintes sistemas operacionais:

  • Windows 2016+

    nota

    Este sistema operacional só funciona ao conectar um terminal VS Code. Não funciona ao conectar uma instância remota completa do VS Code. Para saber mais sobre terminais e instâncias remotas do VS Code, consulte os tópicos Introdução ao terminal e Desenvolvimento remoto do VS Code na documentação do VS Code.

  • Amazon Linux 2023

  • Ubuntu 22.04

É preciso ter um SSH instalado localmente para abrir uma conexão remota com uma instância do Amazon EC2. Porém, ele não é necessário para abrir um terminal para uma instância do Amazon EC2.

Seu perfil de instância do Amazon EC2 deve incluir as seguintes permissões AWS Identity and Access Management (IAM).


"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel",
"ssm:DescribeAssociation",
"ssm:ListAssociations",
"ssm:UpdateInstanceInformation
nota

As permissões necessárias estão incluídas na política AWS gerenciada a seguir.

  • AmazonSSMManagedInstanceCore

  • AmazonSSMManagedEC2InstanceDefaultPolicy

Visualizar instâncias do Amazon EC2 existentes

Para visualizar suas instâncias existentes do Amazon EC2 a partir do AWS kit de ferramentas, conclua as etapas a seguir.

  1. No AWS Toolkit, expanda o AWS Toolkit Explorer.

  2. Expanda a região que contém as instâncias do Amazon EC2 que você deseja visualizar.

  3. Expanda o título EC2 para exibir suas instâncias existentes do Amazon EC2.

Iniciar uma instância do Amazon EC2

Há três maneiras de criar uma nova instância do Amazon EC2 com o AWS Toolkit.

Cada fluxo de trabalho abre o assistente Iniciar uma instância no console da AWS . Para obter informações detalhadas sobre o lançamento de uma nova instância do Amazon EC2 a partir do assistente Iniciar uma instância, consulte o tópico Iniciar uma instância do EC2 usando o assistente de inicialização da instância no console no Guia do usuário do Amazon Elastic Compute Cloud. Para iniciar uma nova instância do Amazon EC2, conclua um dos procedimentos a seguir.

  1. No VS Code, abra a paleta de comandos pressionando command + shift + P (Windows: ctrl + shift + P).

  2. Na Paleta de comandos do VS Code, pesquise o comando AWS: Launch EC2 e selecione-o quando ele for preenchido na lista para abrir o prompt Launch EC2 instance Selecionar região no VS Code.

  3. No prompt Launch EC2 instance Select Region, escolha a região em que você deseja iniciar sua nova instância e confirme que deseja abrir o AWS console em seu navegador padrão.

  4. No AWS console do seu navegador padrão, conclua o processo de autenticação para prosseguir com o assistente Launch an instance.

  5. No assistente Iniciar uma instância, conclua as seções necessárias e escolha o botão Iniciar instância para iniciar sua nova instância do Amazon EC2.

  6. O AWS Explorer é atualizado para mostrar sua nova instância do Amazon EC2.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região na qual você deseja criar a nova instância do Amazon EC2.

  2. Expanda ou passe o mouse sobre o cabeçalho do EC2 e escolha o ícone + (Iniciar instância do EC2).

  3. Quando solicitado, confirme que você deseja abrir o AWS console em seu navegador padrão.

  4. No AWS console do seu navegador, conclua o processo de autenticação para prosseguir com o assistente Launch an instance.

  5. No assistente Iniciar uma instância, conclua as seções necessárias e escolha o botão Iniciar instância para iniciar sua nova instância do Amazon EC2.

  6. O AWS Explorer é atualizado para mostrar sua nova instância do Amazon EC2.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região na qual você deseja criar a nova instância do Amazon EC2.

  2. Right-click o título EC2 e, em seguida, escolha Launch EC2 instance.

  3. Quando solicitado, confirme que você deseja abrir o AWS console em seu navegador padrão.

  4. No AWS console do seu navegador, conclua o processo de autenticação para prosseguir com o assistente Launch an instance.

  5. No assistente Iniciar uma instância, conclua as seções necessárias e escolha o botão Iniciar instância para iniciar sua nova instância do Amazon EC2.

  6. O AWS Explorer é atualizado para mostrar sua nova instância do Amazon EC2.

Conectando o VS Code a uma instância do Amazon EC2

Há três maneiras de se conectar a uma instância do Amazon EC2 por meio do VS Code. Para conectar o VS Code à sua instância do EC2, conclua um dos procedimentos a seguir.

  1. No VS Code, abra a paleta de comandos pressionando command + shift + P (Windows: ctrl + shift + P)

  2. Na paleta de comandos do VS Code, pesquise o comando AWS: Connect VS Code to EC2 instance... e selecione-o quando ele for preenchido na lista para abrir o prompt Selecionar instância do EC2 no VS Code.

  3. No prompt Selecionar instância do EC2, escolha a região que contém a instância à qual você deseja se conectar e, em seguida, escolha a instância à qual deseja se conectar.

  4. O VS Code exibe o status enquanto a conexão estiver sendo criada.

  5. Uma nova janela se abre para exibir sua instância do Amazon EC2 quando a conexão for concluída.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 à qual você deseja se conectar.

  2. Passe o mouse sobre a instância do Amazon EC2 e escolha o ícone Connect VS Code to EC2 instance.

    nota

    Você também pode escolher o ícone (Conectar o VS Code à instância do EC2) no cabeçalho do serviço EC2 no AWS Explorer.

  3. O VS Code exibe o status enquanto a conexão estiver sendo criada.

  4. Uma nova janela se abre para exibir sua instância do Amazon EC2 quando a conexão for concluída.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 à qual você deseja se conectar.

  2. Right-click a instância do Amazon EC2 à qual você deseja se conectar e, em seguida, escolha Conectar o VS Code à instância do EC2.

    nota

    Você também pode clicar com o botão direito do mouse no título do serviço EC2 no AWS Explorer e escolher a instância Connect VS Code to EC2.

  3. O VS Code exibe o status enquanto a conexão estiver sendo criada.

  4. Uma nova janela se abre para exibir sua instância do Amazon EC2 quando a conexão for concluída.

Para encerrar uma instância do Amazon EC2

Há três maneiras de se conectar a uma instância do Amazon EC2 a partir do terminal VS Code.

  1. No VS Code, abra a paleta de comandos pressionando command + shift + P (Windows: ctrl + shift + P)

  2. Na Paleta de comandos do VS Code, pesquise o comando AWS:Open terminal to EC2 instance... e selecione-o quando ele for preenchido na lista para abrir o prompt Selecionar instância do EC2 no VS Code.

  3. No prompt Selecionar instância do EC2, escolha a região que contém a instância que você deseja abrir no terminal e, em seguida, escolha a instância.

  4. O VS Code exibe o status enquanto a conexão estiver sendo criada.

  5. O Terminal do VS Code é aberto para exibir sua nova sessão quando a conexão for concluída.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 à qual você deseja se conectar.

  2. Passe o mouse sobre a instância do Amazon EC2 e escolha o ícone Abrir terminal para a instância do EC2.

    nota

    Você também pode escolher o (Abrir terminal para instância EC2...) ícone do título do serviço EC2 no AWS Explorer.

  3. O VS Code exibe o status enquanto a conexão estiver sendo criada.

  4. O Terminal do VS Code é aberto para exibir sua nova sessão quando a conexão for concluída.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 que você deseja abrir no terminal do VS Code.

  2. Right-click a instância do Amazon EC2 que você deseja abrir no terminal e, em seguida, escolha Abrir terminal para instância EC2... .

    nota

    Você também pode clicar com o botão direito do mouse no título do serviço EC2 no AWS Explorer e escolher a instância Abrir terminal para EC2... .

  3. O VS Code exibe o status enquanto a conexão estiver sendo criada.

  4. O Terminal do VS Code é aberto para exibir sua nova sessão quando a conexão for concluída.

Iniciar ou reiniciar uma instância do Amazon EC2

Há três maneiras de iniciar ou reinicializar uma instância do Amazon EC2.

  1. No VS Code, abra a paleta de comandos pressionando command + shift + P (Windows: ctrl + shift + P).

  2. Na Paleta de comandos do VS Code, pesquise o comando AWS: Reboot EC2 instance e selecione-o quando ele for preenchido na lista para abrir o prompt Selecionar instância do EC2 no VS Code.

    nota

    Para iniciar uma instância que não está em execução, você precisa escolher o comando AWS: Start EC2 instance. O comando AWS: Reboot EC2 instance reinicializa somente as instâncias que estão em execução no momento.

  3. No prompt Selecionar instância do EC2, escolha a região que contém a instância que você deseja iniciar ou reinicializar.

  4. O VS Code exibe o status enquanto a instância está sendo reinicializada.

  5. O AWS Explorer é atualizado para mostrar que sua instância está em execução quando a reinicialização for concluída.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 que você deseja iniciar ou reinicializar.

  2. Passe o mouse sobre a instância do Amazon EC2 e escolha o ícone Reinicializar instância do EC2.

    nota

    Se a instância for interrompida, a única opção será o ícone Iniciar instância do EC2

  3. O VS Code exibe o status enquanto a instância está sendo reinicializada.

  4. O AWS Explorer é atualizado para mostrar que sua instância está em execução quando a reinicialização for concluída.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 que você deseja iniciar ou reinicializar.

  2. Right-click a instância do Amazon EC2 à qual você deseja se conectar e, em seguida, escolha Reinicializar instância do EC2.

    nota

    Se a instância for interrompida, a única opção será Iniciar instância do EC2.

  3. O VS Code exibe o status enquanto a instância está sendo reinicializada.

  4. O AWS Explorer é atualizado para mostrar que sua instância está em execução quando a reinicialização for concluída.

Interromper uma instância do Amazon EC2

Há três maneiras de interromper uma instância do Amazon EC2.

  1. No VS Code, abra a paleta de comandos pressionando command + shift + P (Windows: ctrl + shift + P).

  2. Na Paleta de comandos do VS Code, pesquise o comando AWS: Stop EC2 instance e selecione-o quando ele for preenchido na lista para abrir o prompt Selecionar instância do EC2 no VS Code.

  3. No prompt Selecionar instância do EC2, escolha a região que contém a instância que você deseja interromper.

  4. O VS Code exibe o status enquanto a instância está parando.

  5. O AWS Explorer é atualizado para mostrar que sua instância está interrompida.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 que você deseja interromper.

  2. Passe o mouse sobre a instância do Amazon EC2 e escolha o ícone Parar instância do EC2.

  3. O VS Code exibe o status enquanto a instância está parando.

  4. O AWS Explorer é atualizado para mostrar que sua instância foi interrompida.

  1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a instância do Amazon EC2 que você deseja interromper.

  2. Right-click a instância do Amazon EC2 à qual você deseja se conectar e, em seguida, escolha Reinicializar instância do EC2.

  3. O VS Code exibe o status enquanto a instância está parando.

  4. O AWS Explorer é atualizado para mostrar que sua instância foi interrompida.

Copiar ID da instância

Para copiar um ID de instância, conclua as etapas a seguir.

  1. Right-click a instância da qual você deseja copiar o ID.

  2. Selecione Copiar ID de instância.

  3. O ID da instância é copiado para sua área de transferência local.

Nome da cópia

Para copiar um nome de instância, conclua as etapas a seguir.

  1. Right-click a instância da qual você deseja copiar o nome.

  2. Escolha Copiar nome da instância.

  3. O nome da instância é copiado para sua área de transferência local.

Copiar ARN

Para copiar um ARN de instância, conclua as etapas a seguir.

  1. Right-click a instância da qual você deseja copiar o ARN.

  2. Escolha Copiar ARN da instância.

  3. O ARN da instância é copiado para a área de transferência local.