Usar o AWS Cloud9 com a AWS CodeStar

Você pode usar o AWS Cloud9 para fazer alterações no código e desenvolver software em um projeto do AWS CodeStar. O AWS Cloud9 é um IDE online, que você acessa no navegador da web. O IDE oferece uma experiência de edição de código completa com suporte para várias linguagens de programação e depuradores de tempo de execução, bem como um terminal integrado. Em segundo plano, uma instância do Amazon EC2 hospeda um ambiente de desenvolvimento do AWS Cloud9. Esse ambiente fornece o IDE do AWS Cloud9 e o acesso aos arquivos de código do projeto do AWS CodeStar. Para obter mais informações, consulte o Guia do usuário do AWS Cloud9.

Você pode usar o console do AWS CodeStar ou o console do AWS Cloud9 para criar ambientes de desenvolvimento do AWS Cloud9 para projetos que armazenam o código no CodeCommit. Para projetos do AWS CodeStar que armazenam o código no GitHub, você só pode usar o console do AWS Cloud9. Este tópico descreve como usar ambos os consoles.

Para usar o AWS Cloud9, você precisa:

• Um usuário do IAM que tenha sido adicionado como membro da equipe a um projeto do AWS CodeStar.

• Se o projeto do AWS CodeStar armazena seu código-fonte no CodeCommit, as credenciais do AWS para o usuário do IAM.

Criar um ambiente do AWS Cloud9 para um projeto

Siga estas etapas para criar um ambiente de desenvolvimento do AWS Cloud9 para um projeto do AWS CodeStar.

1. Siga as etapas em Criar um projeto se deseja criar um novo projeto.

2. Abra o projeto no console do AWS CodeStar. Na barra de navegação, escolha IDE. Escolha Criar ambiente e use as etapas a seguir.

   Importante

   Se o projeto estiver em uma região do AWS onde o AWS Cloud9 não for compatível, você não verá opções do AWS Cloud9 na aba IDE na barra de navegação. No entanto, você pode usar o console do AWS Cloud9 para criar um ambiente de desenvolvimento, abrir o novo ambiente e conectá-lo ao repositório do AWS CodeCommit do projeto. Ignore as etapas a seguir e consulte Criar um ambiente, Abrir um ambiente e Exemplo do AWS CodeCommit no Guia do usuário do AWS Cloud9. Para obter a lista das regiões da AWS compatíveis, consulte AWS Cloud9 no Referência geral da Amazon Web Services.

Em Criar ambiente do AWS Cloud9, personalize os padrões do projeto.

1. Para alterar o tipo padrão de instância do Amazon EC2 para hospedar o ambiente, para Instance type (tipo de instância), selecione o tipo de instância.

2. O AWS Cloud9 usa a Amazon Virtual Private Cloud (Amazon VPC) em sua conta do AWS para se comunicar com a instância. Dependendo de como o Amazon VPC está configurado na conta do AWS, execute uma das ações a seguir.

   A conta tem uma VPC com, pelo menos, uma sub-rede nessa VPC?	A VPC que deseja que o AWS Cloud9 use é a VPC padrão da conta?	A VPC possui uma única sub-rede?	Faça o seguinte
   Não	—	—	Se não houver nenhuma VPC, crie uma. Expanda Network settings (Configurações de rede). Em Network (VPC) (Rede [VPC]), escolha Create VPC (Criar VPC) e siga as instruções na página. Para obter mais informações, consulte Criar um Amazon VPC para o AWS Cloud9 no Guia do usuário do AWS Cloud9. Se existe uma VPC mas não há sub-rede, crie uma. Expanda Network settings (Configurações de rede). Em Network (VPC) (Rede [VPC]), escolha Create subnet (Criar sub-rede) e siga as instruções. Para obter mais informações, consulte Criar uma sub-rede para o AWS Cloud9 no Guia do usuário AWS Cloud9.
   Sim	Sim	Sim	Avance diretamente para a etapa 4 deste procedimento. (O AWS Cloud9 usa a VPC padrão com a única sub-rede.)
   Sim	Sim	Não	Em Subnet (Sub-rede), selecione a sub-rede que você deseja que o AWS Cloud9 use na VPC padrão pré-selecionada.
   Sim	Não	Yes ou No	Em Network (VPC) (Rede (VPC)), selecione a VPC que deseja que o AWS Cloud9 use. Em Subnet (Sub-rede), selecione a sub-rede que você deseja que o AWS Cloud9 use nessa VPC.

   Para obter mais informações, consulte Configurações do Amazon VPC para ambientes de desenvolvimento do AWS Cloud9 no Guia do usuário do AWS Cloud9.

3. Insira um nome de ambiente e, opcionalmente, adicione uma descrição do ambiente.

   nota

   Os nomes do ambiente devem ser exclusivos por usuário.

4. Para alterar o período padrão após o qual o AWS Cloud9 desliga o ambiente quando não foi usado, expanda Configurações econômicas e altere a configuração.

5. Selecione Create environment (Criar ambiente).

Para abrir o ambiente, consulte Abrir um ambiente do AWS Cloud9 para um projeto.

Você pode usar essas etapas para criar mais de um ambiente para um projeto. Por exemplo, convém usar um ambiente para trabalhar em uma parte do código e outro ambiente para trabalhar na mesma parte do código com configurações diferentes.

Abrir um ambiente do AWS Cloud9 para um projeto

Siga estas etapas para abrir um ambiente de desenvolvimento do AWS Cloud9 criado para um projeto do AWS CodeStar.

1. Com o projeto aberto no console do AWS CodeStar, na barra de navegação, escolha IDE.

   Importante

   Se o código-fonte do projeto estiver armazenado no GitHub, você não verá IDE na barra de navegação. No entanto, você pode usar o console do AWS Cloud9 para abrir um ambiente existente. Ignore o restante deste procedimento e consulte Abertura de um ambiente no Guia do usuário do AWS Cloud9 e Usar o GitHub com o AWS Cloud9.

2. Em Your AWS Cloud9 environments (Os ambientes do AC9) ou Shared AWS Cloud9 environments (Ambientes do AC9 compartilhados), escolha Open IDE (Abrir IDE) para o ambiente que você deseja abrir.

Você pode usar o IDE do AWS Cloud9 para iniciar o trabalho com código no repositório do AWS CodeCommit do projeto imediatamente. Para obter mais informações, consulte A janela do ambiente, O editor, as guias e os painéis e O terminal no Guia do usuário do AWS Cloud9 e Comandos do Git básicos no Guia do usuário do AWS CodeCommit.

Compartilhar um ambiente do AWS Cloud9 com um membro da equipe do projeto

Depois de criar um ambiente de desenvolvimento do AWS Cloud9 para um projeto do AWS CodeStar, você poderá convidar outros usuários na conta da AWS, inclusive membros da equipe do projeto, para acessar esse mesmo ambiente. Isso é especialmente útil na programação de pares, em que dois programadores aproveitam a codificação e dão orientações sobre o mesmo código por meio do compartilhamento de tela ou ainda sentados na mesma estação de trabalho. Os membros do ambiente podem usar o IDE do AWS Cloud9 compartilhado para ver alterações feitas no código de cada membro realçado no editor de códigos e para conversar por texto com outros membros durante a codificação.

Adicionar um membro da equipe a um projeto não permite automaticamente que esse membro participe de qualquer ambientes de desenvolvimento do AWS Cloud9 do projeto. Para convidar um membro da equipe do projeto para acessar um ambiente para um projeto, você precisa determinar a função de acesso do membro ambiente correta, aplicar políticas gerenciadas do AWS para o usuário e convidá-lo para o ambiente. Para obter mais informações, consulte Sobre funções de acesso de membro do ambiente e Convidar um usuário do IAM para o ambiente no Guia do usuário do AWS Cloud9.

Quando você convida um membro da equipe do projeto para acessar um ambiente de um projeto, o console do AWS CodeStar exibe o ambiente para esse membro da equipe. O ambiente é exibido na lista Ambientes compartilhados da guia IDE no console do AWS CodeStar do projeto. Para exibir essa lista, peça para o membro da equipe abrir o projeto no console e escolher IDE na barra de navegação.

Importante

Se o código-fonte do projeto estiver armazenado no GitHub, você não verá IDE na barra de navegação. No entanto, você pode usar o console do AWS Cloud9 para convidar outros usuários na conta da AWS, inclusive membros da equipe do projeto, para acessar um ambiente. Para isso, consulte Usar o GitHub com o AWS Cloud9 neste guia e consulte Sobre funções de acesso de membro do ambiente e Convidar um usuário do IAM para o ambiente no Guia do usuário do AWS Cloud9.

Você também pode convidar um usuário que não seja um membro da equipe do projeto para acessar um ambiente. Por exemplo, convém que um usuário trabalhe no código de um projeto, mas não tenha acesso a esse projeto. Para convidar esse tipo de usuário, consulte Sobre funções de acesso de membro do ambiente e Convidar um usuário do IAM para o ambiente no Guia do usuário do AWS Cloud9. Quando você convida um usuário que não seja um membro da equipe do projeto para acessar um ambiente de um projeto, esse usuário pode usar o console do AWS Cloud9 para acessar o ambiente. Para obter mais informações, consulte Abrir um ambiente no Guia do usuário do AWS Cloud9.

Excluir um ambiente do AWS Cloud9 de um projeto

Quando você exclui um projeto e todos os recursos da AWS do AWS CodeStar, todos os ambientes de desenvolvimento do AWS Cloud9 relacionados que foram criados com o console do AWS CodeStar também são excluídos e não podem ser recuperados. Você pode excluir um ambiente de desenvolvimento de um projeto sem excluir o projeto.

1. Com o projeto aberto no console do AWS CodeStar, na barra de navegação, escolha IDE.

   Importante

   Se o código-fonte do projeto estiver armazenado no GitHub, você não verá IDE na barra de navegação. Porém, você pode usar o console do AWS Cloud9 para excluir um ambiente de desenvolvimento. Ignore o restante deste procedimento e consulte Exclusão de um ambiente no Guia do usuário do AWS Cloud9.

2. Escolha o ambiente que você deseja excluir nos ambientes do Cloud9 e escolha Excluir

3. Insira delete para confirmar a exclusão para o ambiente de desenvolvimento e então selecione Excluir.

   Atenção

   Você não poderá recuperar um ambiente de desenvolvimento depois que ele tiver sido excluído. Todas as alterações de código não confirmadas no ambiente são perdidas.

Usar o GitHub com o AWS Cloud9

Para projetos do AWS CodeStar que tenham o código-fonte armazenado no GitHub, o console do AWS CodeStar não oferece suporte ao trabalho com ambientes de desenvolvimento do AWS Cloud9 diretamente. Porém, você pode usar o console do AWS Cloud9 para trabalhar com código-fonte em repositórios do GitHub.

1. Use o console do AWS Cloud9 para criar um ambiente de desenvolvimento do AWS Cloud9. Para obter mais informações, consulte Criação de um ambiente no Guia do usuário do AWS Cloud9.

2. Use o console do AWS Cloud9 para abrir o ambiente de desenvolvimento. Para obter mais informações, consulte Abertura de um ambiente no Guia do usuário do AWS Cloud9.

3. No IDE, use uma sessão de terminal para se conectar ao repositório do GitHub (um processo conhecido como a clonagem). Se uma sessão de terminal não estiver em execução, na barra de menus no IDE, escolha Window, New Terminal (Janela, novo terminal). Para usar os comandos para clonar o repositório do GitHub, consulte Clonar um repositório no site de Ajuda do GitHub.

   Para navegar até a página principal do repositório do GitHub, com o projeto aberto no console do AWS CodeStar, na barra de navegação lateral, escolha Code (Código).

4. Use a janela Environment (Ambiente) e as guias do editor no IDE para exibir, alterar e salvar o código. Para obter mais informações, consulte A janela de ambiente e O editor, as guias e os painéis no Guia do usuário do AWS Cloud9.

5. Use o Git na sessão de terminal no IDE para enviar alterações feitas no código para o repositório e obter alterações feitas no código periodicamente de outros do repositório. Para obter mais informações, consulte Enviar um repositório remoto e Buscar um repositório remoto no site de Ajuda do GitHub. Para obter comandos do Git, consulte Git Cheatsheet no site de Ajuda do GitHub.

   nota

   Para evitar que o Git solicite suas credenciais de login do GitHub sempre que enviar ou receber código do repositório, você pode usar um assistente de credenciais. Para obter mais informações, consulte Armazenar em cache a senha do GitHub no Git no site de Ajuda do GitHub.

Recursos adicionais

Para obter mais informações sobre como usar o AWS Cloud9, consulte o seguinte no Guia do usuário do AWS Cloud9:

• Tutorial

• Trabalhar com ambientes

• Trabalhar com a IDE

• Amostras