Pré-requisitos Etapa 1: Criar um ambiente Etapa 2: Tour básico Etapa 3: Limpeza Informações relacionadas

Começando com AWS Cloud9

Use este tutorial para começar AWS Cloud9. Você pode usar AWS Cloud9 console ou AWS Command Line Interface (AWS CLI) para usar o AWS Cloud9 IDE. Neste tutorial, você aprenderá como configurar um ambiente de AWS Cloud9 desenvolvimento e, em seguida, usar o AWS Cloud9 IDE para codificar, executar e depurar seu primeiro aplicativo. Para obter mais informações sobre AWS Cloud9, consulte O que é AWS Cloud9.

Para saber mais sobre o AWS Cloud9 IDE, consulteVisita guiada pelo AWS Cloud9 IDE.

Este tutorial leva aproximadamente uma hora para ser concluído.

Atenção

A conclusão deste tutorial pode resultar em cobranças em sua AWS conta. Isso inclui possíveis cobranças pelo Amazon EC2. Para obter mais informações, consulte Preço do Amazon EC2.

Pré-requisitos

Para concluir este tutorial com êxito, primeiro é necessário concluir as etapas em Conf AWS Cloud9 iguração.

Etapa 1: Criar um ambiente

Nesta etapa, você pode usar o AWS Cloud9 console ou o AWS CLI para criar um ambiente de AWS Cloud9 desenvolvimento.

nota

Se você já tiver criado o ambiente que deseja usar para este tutorial, abra esse ambiente e avance para Etapa 2: Tour básico pelo IDE.

Em AWS Cloud9, um ambiente ou ambiente de desenvolvimento está em algum lugar onde você armazena os arquivos do seu projeto de desenvolvimento e executa as ferramentas para desenvolver seus aplicativos. Neste tutorial, você criará um ambiente do EC2 e trabalhará com os arquivos e as ferramentas nesse ambiente.

Create an EC2 Environment with the console

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/.
- 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.
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 Cloud9no Referência geral da AWS.
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.

Se você já tem AWS Cloud9 ambientes, o botão é mostrado da seguinte forma.
Na página Create environment (Criar ambiente), em Name (Nome), digite um nome para o ambiente.
Em Descrição, insira algo sobre seu ambiente. Para este tutorial, use This environment is for the AWS Cloud9 tutorial.
Em Environment type (Tipo de ambiente), selecione New EC2 instance (Nova instância do EC2):
- New EC2 instance (Nova instância do EC2): executa uma instância do Amazon EC2 à qual o AWS Cloud9 pode se conectar diretamente por SSH. Você pode usar o Systems Manager para interagir com novas instâncias do Amazon EC2. Para obter mais informações, consulteAcessando instâncias EC2 sem entrada com AWS Systems Manager.
- Existing compute (Computação existente): executa uma instância existente do Amazon EC2 que exige detalhes de login SSH para os quais a instância do Amazon EC2 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 instância do Amazon EC2 usando a computação existente.

Atenção
Criar uma instância do Amazon EC2 para seu ambiente pode gerar cobranças em sua Conta da AWS pelo Amazon EC2. Não há custo adicional para usar o Systems Manager para gerenciar conexões com sua instância do EC2.
No painel New EC2 instance (Nova instância do EC2) para Instance type (Tipo de instância), mantenha a opção padrão. Essa opção pode ter menos RAM e menos CPUs v. No entanto, essa quantidade de memória é suficiente para este tutorial.

Atenção
Escolher tipos de instância com mais RAM e v CPUs pode resultar em cobranças adicionais Conta da AWS para o Amazon EC2.
Em Plataforma, escolha o tipo de instância do Amazon EC2 que você deseja: Amazon Linux 2023, Amazon Linux 2 ou Ubuntu 22.04 LTS. AWS Cloud9 cria a instância e, em seguida, conecta o ambiente a ela.

Importante
Recomendamos que você escolha a opção Amazon Linux 2023 para o ambiente do EC2. 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 ter mais informações, consulte a AL2023 página.
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 instância do Amazon EC2 do ambiente.

Atenção
A escolha de um período maior pode gerar cobranças maiores em sua Conta da AWS.
No painel Network settings (Configurações de rede), selecione como seu ambiente é acessado entre as duas opções a seguir:
- AWS System 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.
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 recém-criada do Amazon EC2. 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 automaticamente a VPC padrão com sua única sub-rede na mesma Conta da AWS região do novo ambiente.

Você encontrará mais informações sobre opções de da Amazon VPC em Criar um ambiente EC2 com o console e em .Configurações de VPC para ambientes de desenvolvimento AWS Cloud9
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 instância do Amazon EC2 e os grupos de segurança do Amazon EC2. Para saber mais sobre tags, consulte Controlar o acesso usando tags de AWS recursos no Guia do usuário do IAM e informações avançadas 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 nas informações avançadas sobre tags.
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.

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 .

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. 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 no Guia do usuário do Amazon EC2 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.

Create an EC2 environment with the AWS CLI

Instale e configure o AWS CLI, caso ainda não tenha feito isso. Para fazer isso, consulte os seguintes tópicos no Manual do usuário do AWS Command Line Interface :
- Instalar a AWS Command Line Interface
- Configuração rápida
Você pode configurar as credenciais de AWS CLI uso para uma das seguintes opções:
- O usuário do IAM criado no Configurando a equipe para AWS Cloud9.
- Um administrador do IAM em sua AWS conta, se você estiver trabalhando regularmente com AWS Cloud9 recursos para vários usuários em toda a conta. Se você não conseguir configurá-lo AWS CLI como administrador do IAM, consulte o administrador AWS da sua conta. Para obter mais informações, consulte Criar o primeiro usuário e grupo administrador do IAM no Manual do usuário do IAM.
- Um usuário root da AWS conta, mas somente se você sempre for o único a usar sua própria AWS conta e não precisar compartilhar seus ambientes com mais ninguém. Não recomendamos essa opção, pois não é uma prática recomendada AWS de segurança. Para obter mais informações, consulte Criação, desabilitação e exclusão de chaves de acesso para a conta da AWS no Referência geral da Amazon Web Services.
- Para outras opções, consulte o administrador da sua AWS conta ou o instrutor da sala de aula.
No AWS Cloud9 comando a seguir, forneça um valor para --region --subnet-id e. Depois, execute o comando e anote o valor "environmentId" para limpeza posterior.
```
aws cloud9 create-environment-ec2 --name my-demo-environment --description "This environment is for the AWS Cloud9 tutorial." --instance-type t2.micro --image-id resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64 --region MY-REGION --connection-type CONNECT_SSM --subnet-id subnet-12a3456b
```
No comando anterior:
- --name representa o nome do ambiente. Neste tutorial, usamos o nome my-demo-environment.
- --description representa uma descrição opcional para o ambiente.
- --instance-type representa o tipo de instância do Amazon EC2 que o AWS Cloud9 inicializará e conectará ao novo ambiente. Este exemplo especifica t2.micro qual tem RAM e v relativamente baixos CPUs e é suficiente para este tutorial. Especificar tipos de instância com mais RAM e v CPUs pode resultar em cobranças adicionais em sua AWS conta do Amazon EC2. Para ver uma lista dos tipos de instância disponíveis, consulte o assistente de criação de ambiente no AWS Cloud9 console.
- --image-id especifica o identificador da imagem de máquina da Amazon (AMI) usado para criar a instância do EC2. Para escolher uma AMI para a instância, você deve especificar um alias de AMI válido ou um caminho válido do AWS Systems Manager (SSM). No exemplo acima, um caminho SSM para uma AMI do Amazon Linux 2 é especificado.
  
  Para obter mais informações, consulte create-environment-ec2 na Referência de AWS CLI Comandos.
- --regionrepresenta o ID da AWS região na AWS Cloud9 qual criar o ambiente. Para obter uma lista das AWS regiões disponíveis, consulte AWS Cloud9no Referência geral da Amazon Web Services.
- --connection-type CONNECT_SSMespecifica que AWS Cloud9 se conecta à sua instância do Amazon EC2 por meio do Systems Manager. Esta opção garante que nenhum tráfego de entrada para a instância seja permitido. Para obter mais informações, consulte Acessando instâncias EC2 sem entrada com AWS Systems Manager.
  
  nota
  Ao usar essa opção, você precisa criar a função de serviço AWSCloud9SSMAccessRole e o AWSCloud9SSMInstanceProfile, se ainda não foram criados. Para obter mais informações, consulte Gerenciando perfis de instância para Systems Manager com o AWS CLI.
- --subnet-idrepresenta a sub-rede que você deseja AWS Cloud9 usar. Substitua subnet-12a3456b pelo ID da sub-rede de uma Amazon Virtual Private Cloud (VPC), que deve ser compatível com o AWS Cloud9. Para obter mais informações, consulte Criar uma VPC e outros recursos de VPC em Configurações de VPC para ambientes de desenvolvimento AWS Cloud9.
- AWS Cloud9 desliga a instância do Amazon EC2 para o ambiente depois que todas as instâncias do navegador da web conectadas ao IDE do ambiente tiverem sido fechadas. Para configurar esse período, adicione --automatic-stop-time-minutes e o número de minutos. Um período de tempo mais curto pode resultar em menos cobranças em sua AWS conta. Da mesma forma, um período mais longo pode resultar em mais cobranças.
- Por padrão, a entidade que chama esse comando possui o ambiente. Para alterar isso, adicione --owner-id e o nome de recurso da Amazon (ARN) da entidade proprietária.
Depois de executar esse comando com êxito, abra o AWS Cloud9 IDE para o ambiente recém-criado. Para fazer isso, consulte Abrindo um ambiente em AWS Cloud9. Em seguida, retorne a este tópico e continue Etapa 2: Tour básico pelo IDE para aprender como usar o AWS Cloud9 IDE para trabalhar com seu novo ambiente.

Se você tentar abrir o ambiente, mas AWS Cloud9 não exibir o IDE após pelo menos cinco minutos, pode haver um problema com seu navegador da Web, suas permissões de AWS acesso, a instância ou a VPC associada. Para obter as possíveis correções, consulte Não é possível abrir um ambiente.

Etapa 2: Tour básico pelo IDE

Esta parte do tutorial apresenta algumas das maneiras pelas quais você pode usar o AWS Cloud9 IDE para criar e testar aplicativos.

É possível usar uma janela do editor para criar e editar código.
É possível usar uma janela do terminal ou uma janela Configuração de execução para executar seu código sem depurá-lo.
Use a janela Depurador para depurar o código.

Execute essas três tarefas usando JavaScript o mecanismo Node.js. Para obter instruções sobre como usar outras linguagens de programação, consulte Tutoriais para AWS Cloud9.

Prepare seu ambiente

A maioria das ferramentas que você precisa para executar e depurar o JavaScript código já está instalada para você. No entanto, é necessário um pacote Node.js adicional para este tutorial. Instale-o da maneira indicada a seguir.

Na barra de menu na parte superior do AWS Cloud9 IDE, escolha Janela, Novo terminal ou use uma janela de terminal existente.
Na janela do terminal, que é uma das guias na parte inferior do IDE, insira o seguinte:
```
npm install readline-sync
```
Verifique se o resultado é semelhante ao indicado a seguir. Se as mensagens npm WARN também forem exibidas, você poderá ignorá-las.
```
+ readline-sync@1.4.10
added 1 package from 1 contributor and audited 5 packages in 0.565s
found 0 vulnerabilities
```

Escrever código

Comece escrevendo alguns códigos.

Na barra de menus, selecione Arquivo, Novo arquivo.

Adicione o seguinte JavaScript ao novo arquivo.


var readline = require('readline-sync');
var i = 10;
var input;

console.log("Hello Cloud9!");
console.log("i is " + i);

do {
    input = readline.question("Enter a number (or 'q' to quit): ");
    if (input === 'q') {
        console.log('OK, exiting.')
    }
    else{
        i += Number(input);
        console.log("i is now " + i);
    }
} while (input != 'q');

console.log("Goodbye!");

Selecione Arquivo, Salvar e salve o arquivo como hello-cloud9.js.

Execute o código

Depois, é possível executar o código.

Dependendo da linguagem de programação que você estiver usando, o código poderá ser executado de várias maneiras. Este tutorial usa JavaScript, que você pode executar usando uma janela de terminal ou uma janela de configuração de execução.

Para executar o código usando uma janela Run Configuration (Executar configuração)

Na barra de menus, selecione Executar, Configurações de execução, Nova configuração de execução.
Na nova janela Configuração da execução (uma das guias na parte inferior do IDE), insira hello-cloud9.js no campo Comando e selecione Executar.
O prompt Run Configuration (Executar configuração) deve estar ativo. Depois, interaja com a aplicação inserindo um número no prompt.
Visualize a saída do código na janela Configuração de execução. É semelhante ao seguinte.

Execute o código em uma Configuração de execução.

Como executar o código usando uma janela do terminal

Vá para a janela do terminal usada anteriormente (ou abra uma nova).
Na janela do terminal, insira ls no prompt do terminal e verifique se o arquivo de código está na lista de arquivos.
Insira node hello-cloud9.js no prompt para iniciar a aplicação.
Interaja com a aplicação inserindo um número no prompt.
Visualize a saída do código na janela do terminal. É semelhante ao seguinte.

Depurar o código

Por fim, é possível depurar o código usando a janela Depurador.

Adicione um ponto de interrupção ao código na linha 10 (if (input === 'q')) escolhendo a margem ao lado da linha 10. Um círculo vermelho é exibido ao lado desse número de linha, da maneira indicada a seguir.
Abra a janela Debugger (Depurador) selecionando o botão Debugger (Depurador) no lado direito do IDE. Como alternativa, selecione Janela,Depurador na barra de menus.

Depois, coloque a variável input sob vigilância, selecionando Digite uma expressão aqui na seção Expressões de vigilância da janela Depurador.
Vá para a janela Configuração de execução usada anteriormente para executar o código. Escolha Executar.

Como alternativa, você pode abrir uma nova janela Run Configuration (Executar configuração) e começar a executar o código. Faça isso selecionando Run (Executar), Run With (Executar com), Node.js na barra de menus.
Insira um número no prompt Configuração de execução e verifique se o código é pausado na linha 10. A janela Debugger (Depurador) mostra o valor inserido em Watch Expressions (Expressões de observação).
Na janela Debugger (Depurador), selecione Resume (Retomar). Esse é o ícone da seta azul destacado no screenshot anterior.
Selecione Interromper na janela Configuração de execução para interromper o depurador.

Etapa 3: Limpeza

Para evitar cobranças Conta da AWS contínuas relacionadas a este tutorial, exclua o ambiente.

Atenção

Não é possível restaurar o ambiente depois de excluí-lo.

Delete the Environment by using the AWS Cloud9 console

Para abrir o painel, na barra de menus no IDE, escolha AWS Cloud9, Go To Your Dashboard (Ir para o painel).
Execute um destes procedimentos:
- Escolha o título dentro do my-demo-environmentcartão e, em seguida, escolha Excluir.
- Selecione o my-demo-environmentcartão e escolha Excluir.
Na caixa de diálogo Delete (Excluir), insira Delete e selecione Delete (Excluir). A operação de exclusão levará alguns minutos.

nota

Se você seguiu exatamente este tutorial, o ambiente era um EC2 e o AWS Cloud9 também encerrou a instância do Amazon EC2 que estava conectada a esse ambiente.

No entanto, se você usou um ambiente SSH em vez de seguir o tutorial e esse ambiente estava conectado a uma instância do Amazon EC2 AWS Cloud9 , essa instância não será encerrada. Se você não encerrar essa instância posteriormente, Conta da AWS poderá continuar a ter cobranças contínuas pelo Amazon EC2 relacionadas a essa instância.

Delete the Environment with the AWS CLI

Execute o AWS Cloud9 delete-environment comando, especificando o ID do ambiente a ser excluído.
```
aws cloud9 delete-environment --region MY-REGION --environment-id 12a34567b8cd9012345ef67abcd890e1
```
No comando anterior, MY-REGION substitua pela AWS região na qual o ambiente foi criado e 12a34567b8cd9012345ef67abcd890e1 pelo ID do ambiente a ser excluído.

Se você não salvou o ID ao criar o ambiente, o ID pode ser encontrado usando o AWS Cloud9 console. Selecione o nome do ambiente no console do e localize a última parte do Environment ARN (ARN do ambiente).
Se você criou uma Amazon VPC para este tutorial e não precisa mais dela, exclua a VPC usando o console da Amazon VPC em /vpc. https://console.aws.amazon.com

Informações relacionadas

Veja a seguir informações adicionais sobre Introdução ao AWS Cloud9 Console.

Ao criar um ambiente EC2, o ambiente não contém código de exemplo por padrão. Para criar um ambiente com código de exemplo, consulte o tópico a seguir:
- Trabalhando com instâncias do Amazon Lightsail no IDE AWS Cloud9
Enquanto o ambiente de AWS Cloud9 desenvolvimento está sendo criado, você é direcionado AWS Cloud9 a criar uma instância do Amazon EC2. AWS Cloud9 criou a instância e, em seguida, conectou o ambiente a ela. Também é possível usar uma instância de computação em nuvem existente ou seu próprio servidor, que é chamado de ambiente SSH. Para obter mais informações, consulte Criando um ambiente em AWS Cloud9.

Próximas etapas opcionais

Explore qualquer um ou todos os tópicos a seguir para continuar se familiarizando AWS Cloud9.

Tarefa	Consulte este tópico
Saiba mais sobre o que é possível fazer com um ambiente.	Trabalhando com ambientes em AWS Cloud9
Experimente outras linguagens de computador.	Tutoriais para AWS Cloud9
Saiba mais sobre o AWS Cloud9 IDE.	Visita guiada pelo AWS Cloud9 IDE no Como trabalhar com o IDE
Convide outras pessoas para usar o novo ambiente em tempo real e com suporte para conversa por texto.	Trabalhando com ambiente compartilhado em AWS Cloud9
Crie ambientes SSH. Esses são ambientes que usam instâncias de computação em nuvem ou servidores que você cria, em vez de uma instância do Amazon EC2 que o AWS Cloud9 cria para você.	Criando um ambiente em AWS Cloud9 e Requisitos de host do ambiente SSH
Crie, execute e depure código em AWS Lambda funções e aplicativos sem servidor usando o Toolkit. AWS	Trabalhando com AWS Lambda funções usando o AWS Toolkit
Use AWS Cloud9 com o Amazon Lightsail.	Trabalhando com instâncias do Amazon Lightsail no IDE AWS Cloud9
Use AWS Cloud9 com AWS CodePipeline.	Trabalhando com AWS CodePipeline no AWS Cloud9 IDE
Use AWS Cloud9 com o AWS CLI, o, AWS CloudShell AWS CodeCommit, o AWS Cloud Development Kit (AWS CDK) ou o Amazon DynamoDB e o Node.js, o Python ou outras linguagens de programação. GitHub	Tutoriais para AWS Cloud9
Trabalhe com código para aplicações de robótica inteligente em AWS RoboMaker.	Desenvolvendo com AWS Cloud9 o Guia do AWS RoboMaker Desenvolvedor

Para obter ajuda AWS Cloud9 da comunidade, consulte o Fórum de AWS Cloud9 discussão. (Quando você entra neste fórum, AWS pode ser necessário fazer login.)

Para obter ajuda AWS Cloud9 diretamente de AWS, consulte as opções de suporte na página AWS Support.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Exemplos de políticas gerenciadas pelo cliente para equipes que usam AWS Cloud9

Como trabalhar com ambientes

Começando com AWS Cloud9

Atenção

Pré-requisitos

Etapa 1: Criar um ambiente

nota

nota

Atenção

Atenção

Importante

Atenção

Atenção

nota

nota

nota

Etapa 2: Tour básico pelo IDE

Prepare seu ambiente

Escrever código

Execute o código

Para executar o código usando uma janela Run Configuration (Executar configuração)

Como executar o código usando uma janela do terminal

Depurar o código

Etapa 3: Limpeza

Atenção

nota

Informações relacionadas