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 EC2 instâncias da Amazon 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 obter informações adicionais sobre terminais e instâncias remotas do VS Code, consulte os tópicos [Introdução ao terminal](https://code.visualstudio.com/docs/terminal/getting-started) e [Desenvolvimento remoto do VS Code](https://code.visualstudio.com/docs/remote/remote-overview) na documentação do VS Code.
+ Amazon Linux 2023
+ Ubuntu 22.04
Um **SSH** instalado localmente é necessário para abrir uma conexão remota com uma EC2 instância da Amazon, mas não é necessário para abrir um terminal para uma EC2 instância da Amazon.
Seu perfil de EC2 instância da Amazon 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`
## Visualizando EC2 instâncias existentes da Amazon
Para visualizar suas EC2 instâncias existentes da Amazon a partir do AWS Toolkit, conclua as etapas a seguir.
1. No AWS Toolkit, expanda o AWS Toolkit Explorer.
1. Expanda a região que contém as EC2 instâncias da Amazon que você deseja visualizar.
1. Expanda o **EC2**título para exibir suas EC2 instâncias existentes da Amazon.
## Lançamento de uma nova EC2 instância da Amazon
Há três maneiras de criar uma nova EC2 instância da Amazon 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 EC2 instância da Amazon a partir do assistente **Launch an instance**[, consulte o tópico Launch EC2 instance using the launch instance wizard no console do](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ec2-launch-instance-wizard.html) *Amazon Elastic Compute Cloud* User Guide. Para iniciar uma nova EC2 instância da Amazon, conclua um dos procedimentos a seguir.
### Lançamento de uma nova EC2 instância da Amazon a partir da Paleta de Comandos do VS Code
1. No VS Code, abra a paleta de comandos pressionando **command \+ shift \+ P (Windows: ctrl \+ shift \+ P)**.
1. Na Paleta de comandos do VS Code, pesquise o **AWS: Launch EC2** comando e selecione-o quando ele for preenchido na lista para abrir o prompt de **seleção de região** da EC2 instância do Launch no VS Code.
1. No prompt Launch EC2 instance **Select Region**, escolha a região na qual você deseja iniciar sua nova instância e confirme que deseja abrir o AWS console em seu navegador da web padrão.
1. No AWS console do seu navegador da Web padrão, conclua o processo de autenticação para prosseguir com o assistente **Iniciar uma instância**.
1. No assistente **Iniciar uma instância**, conclua as seções necessárias e escolha o botão **Iniciar instância** para iniciar sua nova EC2 instância da Amazon.
1. O AWS Explorer é atualizado para mostrar sua nova EC2 instância da Amazon.
### Lançamento de uma nova EC2 instância da Amazon a partir do AWS Explorer
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região na qual você deseja criar a nova EC2 instância da Amazon.
1. Expanda ou passe o mouse sobre o **EC2**título e escolha o ícone **\+ (Iniciar EC2 instância)**.
1. Quando solicitado, confirme que você deseja abrir o AWS console em seu navegador padrão.
1. No AWS console do seu navegador da web, conclua o processo de autenticação para prosseguir com o assistente **Iniciar uma instância**.
1. No assistente **Iniciar uma instância**, conclua as seções necessárias e escolha o botão **Iniciar instância** para iniciar sua nova EC2 instância da Amazon.
1. O AWS Explorer é atualizado para mostrar sua nova EC2 instância da Amazon.
### Iniciando uma nova EC2 instância da Amazon a partir do menu de contexto (clique com o botão direito do mouse)
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região na qual você deseja criar a nova EC2 instância da Amazon.
1. Clique com o botão direito do mouse no **EC2**título e escolha **Launch EC2 instance**.
1. Quando solicitado, confirme que você deseja abrir o AWS console em seu navegador padrão.
1. No AWS console do seu navegador da web, conclua o processo de autenticação para prosseguir com o assistente **Iniciar uma instância**.
1. No assistente **Iniciar uma instância**, conclua as seções necessárias e escolha o botão **Iniciar instância** para iniciar sua nova EC2 instância da Amazon.
1. O AWS Explorer é atualizado para mostrar sua nova EC2 instância da Amazon.
## Conectando o VS Code a uma EC2 instância da Amazon
Há três maneiras de se conectar a uma EC2 instância da Amazon a partir do VS Code. Para conectar o VS Code à sua EC2 instância, conclua um dos procedimentos a seguir.
### Conectando o VS Code a uma EC2 instância da Amazon a partir da Paleta de Comandos
1. No VS Code, abra a paleta de comandos pressionando **command \+ shift \+ P (Windows: ctrl \+ shift \+ P)**
1. Na Paleta de comandos do VS Code, pesquise o **AWS: Connect VS Code to EC2 instance...** comando e selecione-o quando ele for preenchido na lista para abrir o prompt **Selecionar EC2 instância** no VS Code.
1. No prompt **Selecionar EC2 instância**, 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.
1. O VS Code exibe o status enquanto a conexão estiver sendo criada.
1. Uma nova janela é aberta para exibir sua EC2 instância da Amazon quando a conexão for concluída.
### Conectando o VS Code a uma EC2 instância da Amazon a partir do AWS Explorer.
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon à qual você deseja se conectar.
1. Passe o mouse sobre a EC2 instância da Amazon e escolha o ícone **(Connect VS Code à EC2 instância)**.
**nota**
Você também pode escolher o ícone **(Connect VS Code à EC2 instância)** no cabeçalho do **EC2**serviço no AWS Explorer.
1. O VS Code exibe o status enquanto a conexão estiver sendo criada.
1. Uma nova janela é aberta para exibir sua EC2 instância da Amazon quando a conexão for concluída.
### Conectando o VS Code a uma EC2 instância da Amazon a partir do menu do botão direito
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon à qual você deseja se conectar.
1. Clique com o botão direito do mouse na EC2 instância da Amazon à qual você deseja se conectar e escolha **Connect VS Code à EC2 instância**.
**nota**
Você também pode clicar com o botão direito do mouse no cabeçalho do **EC2**serviço no AWS Explorer e escolher **Connect VS Code à EC2 instância**.
1. O VS Code exibe o status enquanto a conexão estiver sendo criada.
1. Uma nova janela é aberta para exibir sua EC2 instância da Amazon quando a conexão for concluída.
## Abrindo um terminal para uma EC2 instância da Amazon.
Há três maneiras de se conectar a uma EC2 instância da Amazon a partir do terminal VS Code.
### Conectando o VS Code a uma EC2 instância da Amazon a partir da Paleta de Comandos
1. No VS Code, abra a paleta de comandos pressionando **command \+ shift \+ P (Windows: ctrl \+ shift \+ P)**
1. Na Paleta de comandos do VS Code, pesquise o **AWS:Open terminal to EC2 instance...** comando e selecione-o quando ele for preenchido na lista para abrir o prompt **Selecionar EC2 instância** no VS Code.
1. No prompt **Selecionar EC2 instância**, escolha a região que contém a instância que você deseja abrir no terminal e, em seguida, escolha a instância.
1. O VS Code exibe o status enquanto a conexão estiver sendo criada.
1. O Terminal do VS Code é aberto para exibir sua nova sessão quando a conexão for concluída.
### Abrindo uma EC2 instância da Amazon no terminal do VS Code a partir do AWS Explorer.
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon à qual você deseja se conectar.
1. Passe o mouse sobre a EC2 instância da Amazon e escolha **(Abrir terminal para EC2 instância...)** ícone.
**nota**
Você também pode escolher a opção **(Abrir terminal para EC2 instância...)** ícone do título do **EC2**serviço no AWS Explorer.
1. O VS Code exibe o status enquanto a conexão estiver sendo criada.
1. O Terminal do VS Code é aberto para exibir sua nova sessão quando a conexão for concluída.
### Abrindo uma EC2 instância da Amazon no terminal do VS Code a partir do menu do botão direito
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon que você deseja abrir no terminal do VS Code.
1. Clique com o botão direito do mouse na EC2 instância da Amazon que você deseja abrir no terminal e escolha **Abrir terminal para EC2 instância**... .
**nota**
Você também pode clicar com o botão direito do mouse no cabeçalho do **EC2**serviço no AWS Explorer e escolher a opção **Abrir terminal para EC2 instanciar**... .
1. O VS Code exibe o status enquanto a conexão estiver sendo criada.
1. O Terminal do VS Code é aberto para exibir sua nova sessão quando a conexão for concluída.
## Iniciando ou reiniciando uma instância da Amazon EC2
Há três maneiras de iniciar ou reinicializar uma EC2 instância da Amazon.
### Reinicializando uma EC2 instância da Amazon a partir da Paleta de Comandos
1. No VS Code, abra a paleta de comandos pressionando **command \+ shift \+ P (Windows: ctrl \+ shift \+ P)**.
1. Na Paleta de comandos do VS Code, pesquise o **AWS: Reboot EC2 instance** comando e selecione-o quando ele for preenchido na lista para abrir o prompt **Selecionar EC2 instância** 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.
1. No prompt **Selecionar EC2 instância**, escolha a região que contém a instância que você deseja iniciar ou reinicializar.
1. O VS Code exibe o status enquanto a instância está sendo reinicializada.
1. O AWS Explorer é atualizado para mostrar que sua instância está em execução quando a reinicialização é concluída.
### Iniciando ou reiniciando uma EC2 instância da Amazon a partir do Explorer AWS
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon que você deseja iniciar ou reinicializar.
1. Passe o mouse sobre a EC2 instância da Amazon e escolha o ícone **(Reinicializar EC2 instância)**.
**nota**
Se a instância for interrompida, as únicas opções serão o ícone **(Iniciar EC2 instância)**
1. O VS Code exibe o status enquanto a instância está sendo reinicializada.
1. O AWS Explorer é atualizado para mostrar que sua instância está em execução quando a reinicialização é concluída.
### Iniciando ou reiniciando uma EC2 instância da Amazon usando o menu do botão direito
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon que você deseja iniciar ou reinicializar.
1. Clique com o botão direito do mouse na EC2 instância da Amazon à qual você deseja se conectar e escolha **Reinicializar EC2 ** instância.
**nota**
Se a instância for interrompida, as únicas opções serão a ** EC2 instância inicial**.
1. O VS Code exibe o status enquanto a instância está sendo reinicializada.
1. O AWS Explorer é atualizado para mostrar que sua instância está em execução quando a reinicialização é concluída.
## Interrompendo uma EC2 instância da Amazon
Há três maneiras de interromper uma EC2 instância da Amazon.
### Interrompendo uma EC2 instância da Amazon na paleta de comando
1. No VS Code, abra a paleta de comandos pressionando **command \+ shift \+ P (Windows: ctrl \+ shift \+ P)**.
1. Na Paleta de comandos do VS Code, pesquise o **AWS: Stop EC2 instance** comando e selecione-o quando ele for preenchido na lista para abrir o prompt **Selecionar EC2 instância** no VS Code.
1. No prompt **Selecionar EC2 instância**, escolha a região que contém a instância que você deseja interromper.
1. O VS Code exibe o status enquanto a instância está parando.
1. O AWS Explorer é atualizado para mostrar que sua instância está parada.
### Interrompendo uma EC2 instância da Amazon a partir do AWS Explorer
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon que você deseja interromper.
1. Passe o mouse sobre a EC2 instância da Amazon e escolha o ícone **(Parar EC2 instância)**.
1. O VS Code exibe o status enquanto a instância está parando.
1. O AWS Explorer é atualizado para mostrar que sua instância foi interrompida.
### Parando uma EC2 instância da Amazon no menu do botão direito
1. Expanda o AWS Toolkit Explorer e, em seguida, expanda a região que contém a EC2 instância da Amazon que você deseja interromper.
1. Clique com o botão direito do mouse na EC2 instância da Amazon à qual você deseja se conectar e escolha **Reinicializar EC2 ** instância.
1. O VS Code exibe o status enquanto a instância está parando.
1. 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. Clique com o botão direito do mouse na instância da qual você deseja copiar o ID.
1. Selecione **Copiar ID de instância**.
1. 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. Clique com o botão direito do mouse na instância da qual você deseja copiar o nome.
1. Escolha **Copiar nome da instância**.
1. 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. Clique com o botão direito do mouse na instância da qual você deseja copiar o ARN.
1. Escolha **Copiar ARN da instância**.
1. O ARN da instância é copiado para a área de transferência local.