

 AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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á.

# Criando um EC2 ambiente
<a name="create-environment-main"></a>

Nesse procedimento, AWS Cloud9 cria um EC2 ambiente e uma nova EC2 instância da Amazon e conecta o ambiente a essa instância. AWS Cloud9 gerencia o ciclo de vida dessa instância, incluindo iniciar, interromper e reiniciar a instância conforme necessário. Se você em algum momento excluir o ambiente, o AWS Cloud9 encerrará automaticamente essa instância.

Você pode criar um ambiente de AWS Cloud9 EC2 desenvolvimento no [AWS Cloud9 console](#create-environment-console) ou com [código](#create-environment-code).

**nota**  
A conclusão deste procedimento pode resultar em cobranças para seu Conta da AWS. Isso inclui possíveis cobranças para a Amazon EC2. Para obter mais informações, consulte [Amazon EC2 Pricing](https://aws.amazon.com/ec2/pricing/). 

**Atenção**  
Existe um problema de compatibilidade com AWS Cloud9 o controle AWS Control Tower proativo [CT. EC2.PR.8](https://docs.aws.amazon.com/controltower/latest/userguide/ec2-rules.html#ct-ec2-pr-8-description). Se esse controle estiver ativado, você não poderá criar um EC2 ambiente no AWS Cloud9. Para obter mais informações sobre esse problema, consulte [Solução de problemas AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html#control-tower-rule).

## Pré-requisitos
<a name="create-env-ec2-prereq"></a>

Conclua as etapas [Conf AWS Cloud9 iguração](setting-up.md) para poder entrar no AWS Cloud9 console e criar ambientes.

## Crie um EC2 ambiente com o console
<a name="create-environment-console"></a>

1. Faça login no AWS Cloud9 console:
   + Se você é o único que usa seu Conta da AWS ou é um usuário do IAM em um único Conta da AWS, acesse [https://console.aws.amazon.com/cloud9/](https://console.aws.amazon.com/cloud9/).
   + Se sua organização usa Centro de Identidade do AWS IAM, peça instruções de login ao Conta da AWS administrador.
   + Se você for um aluno em uma sala de aula, peça ao instrutor para obter instruções de login.

1. Depois de entrar no AWS Cloud9 console, na barra de navegação superior, escolha um Região da AWS para criar o ambiente. Para obter uma lista dos disponíveis Regiões da AWS, consulte [AWS Cloud9](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloud9_region)no *Referência geral da AWS*.  
![\[AWS Seletor de região no console AWS Cloud9\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/images/consolas_region_new_UX.png)

1. Selecione o botão **Create environment** (Criar o ambiente) em um dos locais exibidos.

   Se você ainda não tem AWS Cloud9 ambientes, o botão é exibido em uma página de boas-vindas.  
![\[Página de boas-vindas no AWS Cloud9 console\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/images/create_welcome_env_new_UX.png)

   Se você já tem AWS Cloud9 ambientes, o botão é mostrado da seguinte forma.  
![\[Criar botão de ambiente no AWS Cloud9 console\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/images/console_create_env_new_UX.png)

1. Na página **Create environment** (Criar ambiente), em **Name** (Nome), digite um nome para o ambiente.

1. Para adicionar uma descrição ao ambiente, digite-a em **Description** (Descrição).

1. Em **Tipo de ambiente**, escolha **Nova EC2 instância** para criar um EC2 ambiente Amazon:
   + **Nova EC2 instância** — lança uma nova EC2 instância da Amazon que AWS Cloud9 pode se conectar diretamente via SSH. Você pode usar o Systems Manager para interagir com novas EC2 instâncias da Amazon. Para obter mais informações, consulte[Acessando instâncias EC2 sem entrada com AWS Systems Manager](ec2-ssm.md). 
   + **Computação existente — Lança** uma EC2 instância existente da Amazon que exige detalhes de login SSH para os quais a EC2 instância da Amazon deve ter uma regra de grupo de segurança de entrada.
     + Se você selecionar a opção **Existing compute** (Computação existente), um perfil de serviço será criado automaticamente. Você pode ver o nome do perfil de serviço em uma nota na parte inferior da tela de configuração. 
**nota**  
O desligamento automático não estará disponível para AWS Cloud9 ambientes criados usando uma EC2 instância da Amazon usando a computação existente.
**Atenção**  
Criar uma EC2 instância da Amazon para seu ambiente pode resultar em possíveis cobranças Conta da AWS para você pela Amazon EC2. Não há custo adicional para usar o Systems Manager para gerenciar conexões com sua EC2 instância.

1. Em **Tipo de instância**, escolha um tipo de instância com a quantidade de RAM e v CPUs que você acha que precisa para os tipos de tarefas que deseja realizar.
**Atenção**  
Escolher tipos de instância com mais RAM e v CPUs pode resultar em cobranças adicionais Conta da AWS para a Amazon EC2. Para obter informações sobre qual tipo de instância é adequado para sua carga de trabalho, consulte a página [Tipo de EC2 instância da Amazon](https://aws.amazon.com/ec2/instance-types/).

1. Em **Plataforma**, escolha o tipo de EC2 instância da Amazon que você deseja: **Amazon Linux 2023**, **Amazon Linux 2** ou **Ubuntu 22.04 LTS**. AWS Cloud9 cria a instância e depois conecta o ambiente a ela.
**Importante**  
Recomendamos que você escolha a opção **Amazon Linux 2023** para seu EC2 ambiente. Além de fornecer um ambiente de runtime seguro, estável e de alto desempenho, a AMI do Amazon Linux 2023 inclui suporte de longo prazo até 2024.  
Para obter mais informações, consulte a [página AL2 023](https://aws.amazon.com/linux/amazon-linux-2023/).

1. Selecione um período para **Timeout** (Tempo limite). Essa opção determina por quanto tempo o AWS Cloud9 fica inativa antes da hibernação automática. Quando todas as instâncias do navegador da Web conectadas ao IDE do ambiente são fechadas, AWS Cloud9 aguarda a quantidade de tempo especificada e, em seguida, desliga a EC2 instância da Amazon para o ambiente. 
**Atenção**  
A escolha de um período maior pode gerar cobranças maiores em sua Conta da AWS.

1. No painel **Network settings** (Configurações de rede), selecione como seu ambiente é acessado entre as duas opções a seguir:
   + **AWS Systems Manager (SSM)** — Esse método acessa o ambiente usando SSM sem abrir portas de entrada.
   + **Secure Shell (SSH)**: esse método acessa o ambiente usando SSH e requer portas de entrada abertas.

1. <a name="create-environment-vpc-step"></a>Escolha **Configurações de VPC** para exibir a Amazon Virtual Private Cloud e a sub-rede para seu ambiente. AWS Cloud9 usa a Amazon Virtual Private Cloud (Amazon VPC) para se comunicar com a instância Amazon EC2 recém-criada. Para este tutorial, recomendamos que você não altere as configurações padrão pré-selecionadas. Com as configurações padrão, AWS Cloud9 tenta usar a VPC padrão com sua única sub-rede na mesma Conta da AWS região do novo ambiente. Dependendo de como a Amazon VPC estiver configurada, siga um dos seguintes conjuntos de instruções.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/create-environment-main.html)
**Importante**  
Se você selecionou **Existing compute** (Computação existente) como o tipo de ambiente, você poderá iniciar a instância em uma sub-rede pública ou privada.  
**Sub-rede pública**: anexe um gateway da Internet à sub-rede para permitir que o SSM Agent da instância se comunique com o Systems Manager.
**Sub-rede privada**: crie um gateway NAT para permitir que a instância se comunique com a Internet e outros Serviços da AWS.
Atualmente, você não pode usar [credenciais temporárias AWS gerenciadas](security-iam.md#auth-and-access-control-temporary-managed-credentials) para permitir que o EC2 ambiente acesse e AWS service (Serviço da AWS) em nome de uma AWS entidade, como um usuário do IAM.  
 Para obter mais informações sobre como configurar sub-redes, consulte [Configurações de VPC para ambientes de desenvolvimento AWS Cloud9](vpc-settings.md).  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/create-environment-main.html)

   Para obter mais informações sobre essas opções, consulte [Configurações de VPC para ambientes de desenvolvimento AWS Cloud9](vpc-settings.md).

1. Adicione até 50 tags fornecendo uma **Key** (Chave) e um **Value** (Valor) para cada tag. Faça isso selecionando **Add new tag** (Adicionar nova tag). As tags são anexadas ao AWS Cloud9 ambiente como tags de recursos e propagadas para os seguintes recursos subjacentes: a CloudFormation pilha, a EC2 instância da Amazon e os grupos de EC2 segurança da Amazon. Para saber mais sobre tags, consulte [Controlar o acesso usando tags de AWS recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *[Guia do usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/)* e [informações avançadas](tags.md) neste guia.
**Atenção**  
Se você atualizar essas tags depois de criá-las, as alterações não serão propagadas para os recursos subjacentes. Para obter mais informações, consulte [Propagar atualizações de tags nos recursos subjacentes](tags.md#tags-propagate) nas informações avançadas sobre [tags](tags.md).

1. Selecione **Create** (Criar) para criar seu ambiente e, depois, você será redirecionado para a página inicial. Se a conta for criada com sucesso, uma barra flash verde aparecerá na parte superior do AWS Cloud9 console. Você pode selecionar o novo ambiente e escolher **Open in Cloud9** (Abrir no Cloud9) para iniciar o IDE.  
![\[AWS Cloud9 Seletor IDE no console AWS Cloud9\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/images/cloud9-ide-open.png)

   Se a conta não for criada, uma barra vermelha aparecerá na parte superior do AWS Cloud9 console. Talvez haja um problema com o navegador da Web, com as permissões de acesso da AWS , com a instância ou a rede associada. Você pode encontrar informações sobre as possíveis correções na seção [Solução de problemas no AWS Cloud9 .](troubleshooting.md#troubleshooting-env-loading)
**nota**  
AWS Cloud9 suporta ambos IMDSv1 IMDSv2 e. Recomendamos a adoção IMDSv2 , pois fornece um nível aprimorado de segurança em comparação IMDSv1 com. Para obter mais informações sobre os benefícios do IMDSv2, consulte o [Blog AWS de segurança](https://aws.amazon.com/blogs/security/defense-in-depth-open-firewalls-reverse-proxies-ssrf-vulnerabilities-ec2-instance-metadata-service/). Para obter informações sobre como fazer a transição IMDSv2 de IMDSv1, consulte [Transição para o uso do Instance Metadata Service versão 2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-metadata-transition-to-version-2.html) no *Guia do EC2 usuário da Amazon para instâncias Linux*.
**nota**  
Se seu ambiente estiver usando um proxy para acessar a Internet, você deverá fornecer detalhes do proxy para que ele AWS Cloud9 possa instalar dependências. Para obter mais informações, consulte [Falha ao instalar as dependências](troubleshooting.md#proxy-failed-dependencies).

## Criar um ambiente com código
<a name="create-environment-code"></a>

Para usar o código para criar um EC2 ambiente em AWS Cloud9, chame a operação de AWS Cloud9 criação de EC2 ambiente, da seguinte forma.


****  

|  |  | 
| --- |--- |
|  AWS CLI  |   [create-environment-ec2](https://docs.aws.amazon.com/cli/latest/reference/cloud9/create-environment-ec2.html)   | 
|  AWS SDK para C\$1\$1  |   [CreateEnvironmentEC2Solicitação](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_create_environment_e_c2_request.html), [CreateEnvironmentEC2Resultado](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_create_environment_e_c2_result.html)   | 
|  AWS SDK para Go  |   [CreateEnvironmentEC2](https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.CreateEnvironmentEC2), [CreateEnvironmentEC2Solicitação](https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.CreateEnvironmentEC2Request), [CreateEnvironmentEC2WithContext](https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.CreateEnvironmentEC2WithContext)   | 
|  AWS SDK para Java  |   CreateEnvironmentEC2Solicitação, CreateEnvironment EC2 Resultado   | 
|  AWS SDK para JavaScript  |   [Criar ambiente EC2](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#createEnvironmentEC2-property)   | 
|  AWS SDK para .NET  |   [CreateEnvironmentEC2Solicitação](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TCreateEnvironmentEC2Request.html), [CreateEnvironmentEC2resposta](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TCreateEnvironmentEC2Response.html)   | 
|  AWS SDK para PHP  |   [Criar ambiente EC2](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#createenvironmentec2)   | 
|  AWS SDK para Python (Boto)  |   [create\$1environment\$1ec2](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/cloud9.html#Cloud9.Client.create_environment_ec2)   | 
|  AWS SDK para Ruby  |   [create\$1environment\$1ec2](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#create_environment_ec2-instance_method)   | 
|  AWS Tools for Windows PowerShell  |   [New-C9EnvironmentEC2](https://docs.aws.amazon.com/powershell/latest/reference/items/New-C9EnvironmentEC2.html)   | 
|  AWS Cloud9 API  |   [CreateEnvironmentEC2](https://docs.aws.amazon.com/cloud9/latest/APIReference/API_CreateEnvironmentEC2.html)   | 

**nota**  
Se seu ambiente estiver usando um proxy para acessar a Internet, você deverá fornecer detalhes do proxy para que ele AWS Cloud9 possa instalar dependências. Para obter mais informações, consulte [Falha ao instalar as dependências](troubleshooting.md#proxy-failed-dependencies).