Tutorial: Criar um projeto com um repositório de origem do GitHub

Com o AWS CodeStar, você pode configurar seu repositório para criar, revisar e mesclar pull requests com sua equipe de projeto.

Neste tutorial, você cria um projeto com um exemplo de código-fonte do aplicativo web em um repositório do GitHub, um pipeline que implanta suas alterações e instâncias do EC2 em que seu aplicativo está hospedado na nuvem. Depois que seu projeto for criado, este tutorial mostra como criar e mesclar uma pull request do GitHub que faz uma alteração na página inicial do seu aplicativo web.

Etapa 1: Criar o projeto e criar seu repositório do GitHub

Nesta etapa, use o console para criar seu projeto e criar uma conexão com seu novo repositório do GitHub. Para acessar seu repositório do GitHub, você cria um recurso de conexão que o AWS CodeStar usa para gerenciar a autorização com o GitHub. Quando o projeto é criado, seus recursos adicionais são provisionados para você.

1. Faça login no AWS Management Console e então abra o console do AWS CodeStar em https://console.aws.amazon.com/codestar/.

2. Escolha a região da AWS onde você deseja criar o projeto e seus recursos.

3. Na página AWS CodeStar, escolha Criar um projeto.

4. Na página Escolha um modelo de projeto, marque as caixas de seleção Aplicativo Web, Node.js e Amazon EC2. Em seguida, escolha entre os modelos disponíveis para esse conjunto de opções.

   Para obter mais informações, consulte Modelos de projetos do AWS CodeStar.

5. Escolha Next (Próximo).

6. Em Project name (Nome do projeto), digite o nome do projeto (por exemplo, MyTeamProject). Se você escolher outro nome, certifique-se de usá-lo durante todo este tutorial.

7. Em Repositório do projeto, escolha GitHub.

8. Se você escolheu o GitHub, precisará escolher ou criar um recurso de conexão. Se você tiver uma conexão existente, escolha-a no campo de pesquisa. Caso contrário, você criará uma nova conexão aqui. Escolha Conectar-se ao GitHub.

   A página Criar uma conexão é exibida.

   nota

   Para criar uma conexão, você deve ter uma conta do GitHub. Se você estiver criando uma conexão para uma organização, você deve ser o proprietário da organização.

   

   1. Em Criar conexão do App GitHub, em Nome da conexão, insira um nome para sua conexão. Escolha Conectar-se ao GitHub.

      A página de Conectar ao GitHub exibe e mostra o campo Apps do GitHub

   2. Em GitHub apps (Aplicações do GitHub), escolha uma instalação de aplicação ou Install a new app (Instalar uma nova aplicação) para criar uma.

      nota

      Você instala uma aplicação para todas as suas conexões com um provedor específico. Se você já instalou a aplicação AWS Connector para GitHub, selecione-a e ignore esta etapa.

   3. Na página de instalação do Connect para GitHub, selecione a conta na qual deseja instalar a aplicação.

      nota

      Se você instalou a aplicação anteriormente, poderá escolher Configure (Configurar) para prosseguir para uma página de modificação para a instalação da aplicação ou usar o botão Back (Voltar) para retornar ao console.

   4. Se a página Confirme a senha para continuar for exibida, digite sua senha do GitHub e escolha Entrar.

   5. Na página Instalar o AWS Connector para GitHub, mantenha os valores padrão e selecione Instalar.

   6. Na página Conectar ao GitHub o ID de instalação da sua nova instalação é exibido em Aplicativos do GitHub.

      Depois que a conexão for criada com sucesso, na página de criação do projeto do CodeStar, a mensagem Pronto para conectar é exibida.

      nota

      É possível visualizar sua conexão em Configurações no console do Developer Tools. Para obter mais informações, consulte o tópico de Conceitos básicos sobre conexões.

      

   7. Em Proprietário do repositório, escolha a organização do GitHub ou a conta do GitHub pessoal.

   8. Para Repository name (Nome do repositório), aceite o nome do repositório do GitHub padrão ou digite um outro.

   9. Escolha Público ou Privado.

      nota

      Se você desejar usar o AWS Cloud9 como ambiente de desenvolvimento, será necessário selecionar um repositório público.

   10. (Opcional) Em Repository description (Descrição do repositório), digite uma descrição para o repositório do GitHub.

9. Configure suas instâncias do Amazon EC2 na Configuração do Amazon EC2 se seu projeto estiver implantado em instâncias do Amazon EC2 e você quiser fazer alterações. Por exemplo, você pode escolher entre os tipos de instância disponíveis para o projeto.

   Em Par de chaves, escolha o par de chaves do Amazon EC2 que você criou em Etapa 4: criar um par de chaves do Amazon EC2 para projetos do AWS CodeStar. Selecione Eu reconheço que tenho acesso ao arquivo de chave privada.

10. Escolha Next (Próximo).

11. Analise os recursos e os detalhes da configuração.

12. Escolha Avançar ou Criar projeto. (A opção exibida depende do modelo do projeto.)

    Aguarde alguns minutos enquanto seu projeto é criado.

13. Depois que seu projeto for criado, escolha Exibir aplicativo para visualizar seu aplicativo web.

Etapa 2: exibir seu código-fonte

Nesta etapa, você visualiza seu código-fonte e as ferramentas que você pode usar para seu repositório de origem.

1. Na barra de navegação de seu projeto, escolha Repositório.

   Para ver uma lista de commits no GitHub, escolha Exibir commits. Isso abre seu histórico de commits no GitHub.

   Para ver os problemas, escolha a guia Problemas do seu projeto. Para criar um novo problema no GitHub, escolha Criar problema no GitHub. Isso abre o formulário de problema do repositório no GitHub.

2. Na guia Repositório, escolha o link em Nome do repositório e o repositório do seu projeto será aberto em uma nova guia ou janela. Esse repositório contém o código-fonte do seu projeto.

Etapa 3: Criar uma pull request do GitHub

Nesta etapa, você faz uma pequena alteração no código-fonte e cria uma pull request.

1. No GitHub, crie uma nova ramificação de atributos no seu repositório. Escolha o campo suspenso da ramificação principal e insira uma nova ramificação no campo chamado feature-branch. Escolha Criar nova ramificação. A ramificação é criada e verificada para você.

2. No GitHub, faça uma alteração na ramificação feature-branch. Abra a pasta pública e abra o arquivo index.html.

3. No console AWS CodeStar, em Pull requests, para criar uma pull request no GitHub, escolha Criar pull request. Isso abre o formulário de problema do repositório no GitHub. No GitHub, selecione o ícone de lápis para editar o arquivo.

   Depois de Congratulations!, adicione a string Well done, <name>! e substitua <name> pelo seu nome. Escolha Commit changes (Confirmar alterações). A alteração está comprometida com sua ramificação de atributos.

4. No console do AWS CodeStar, escolha seu projeto. Escolha a guia Repositório. Em Solicitações pull, escolha Criar solicitação pull.

   O formulário é aberto no GitHub. Deixe o galho principal no galho base. Em Comparar com, escolha sua ramificação de atributos. Exiba a diferença.

5. No GitHub, escolha Create pull request. Uma pull request chamada Update index.html é criada.

6. No console do AWS CodeStar, visualize o novo pull request. Escolha Mesclar alterações para confirmar as alterações no repositório e mesclar a pull request com a ramificação principal do seu repositório.

7. Retorne ao projeto em AWS CodeStar e confira a página do Pipeline. Você agora deverá ver a implantação do pipeline.

8. Depois que seu projeto for criado, escolha Exibir aplicativo para visualizar seu aplicativo web.