Tutorial: criar um pipeline simples (CodeCommitrepositório)

Para criar um CodeCommit repositório

1. Abra o CodeCommit console em https://console.aws.amazon.com/codecommit/.

2. No seletor de região, escolha Região da AWS onde você deseja criar o repositório e o pipeline. Para obter mais informações, consulte Regiões da AWS e endpoints.

3. Na página Repositories (Repositórios), selecione Create repository (Criar repositório).

4. Na página Create repository (Criar repositório), em Repository name (Nome do repositório), insira um nome para o repositório (por exemplo MyDemoRepo).

5. Escolha Criar.

Como configurar um repositório local

Nesta etapa, você configura um repositório local para se conectar ao seu CodeCommit repositório remoto.

1. Com seu novo repositório aberto no console, escolha Clonar URL no canto superior direito da página e, em seguida, escolha Clonar. SSH O endereço para clonar o repositório Git é copiado na área de transferência.

2. No terminal ou na linha de comando, navegue até um diretório local onde você deseja que seu repositório local seja armazenado. Neste tutorial, usamos /tmp.

3. Execute o comando a seguir para clonar o repositório, substituindo o SSH endereço pelo que você copiou na etapa anterior. Esse comando cria um diretório chamado MyDemoRepo. Copie um aplicativo de exemplo nesse diretório.

   git clone ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/MyDemoRepo

1. Depois, faça download de um exemplo e salve-o em uma pasta ou um diretório no computador local.

   1. Escolha uma das seguintes opções. Selecione SampleApp_Linux.zip se deseja seguir as etapas deste tutorial para instâncias do Linux.

      • Se você quiser implantar em instâncias Amazon Linux usando CodeDeploy, baixe o aplicativo de amostra aqui: SampleApp_Linux.zip.

      • Se você quiser implantar em instâncias do Windows Server usando CodeDeploy, baixe o aplicativo de amostra aqui: SampleApp_Windows.zip.

      O aplicativo de amostra contém os seguintes arquivos para implantação com CodeDeploy:

      • appspec.yml— O arquivo de especificação do aplicativo (AppSpecarquivo) é um arquivo YAMLformatado usado pelo CodeDeploy para gerenciar uma implantação. Para obter mais informações sobre o AppSpec arquivo, consulte Referência CodeDeploy AppSpec do arquivo no Guia AWS CodeDeploy do usuário.

      • index.html: o arquivo de índice contém a página inicial da aplicação de exemplo implantada.

      • LICENSE.txt: o arquivo de licença contém informações de licença da aplicação de exemplo.

      • Arquivos para scripts: a aplicação de exemplo usa scripts para gravar arquivos de texto em um local na instância. Um arquivo é gravado para cada um dos vários eventos do ciclo de vida da CodeDeploy implantação da seguinte forma:

        • Pasta scripts (somente exemplo do Linux): a pasta contém os seguintes scripts de shell para instalar dependências e iniciar e interromper a aplicação de exemplo para a implantação automatizada: install_dependencies, start_server e stop_server.

        • (Somente exemplo do Windows) before-install.bat: um script em lote para o evento de ciclo de vida de implantação BeforeInstall, que será executado para remover os arquivos antigos gravados durante implantações anteriores deste exemplo e criar um local na instância onde os novos arquivos serão gravados.

   2. Faça download do arquivo compactado.

2. Descompacte os arquivos do SampleApp_Linux.zip no diretório local que você criou anteriormente (por exemplo, /tmp/MyDemoRepo ouc:\temp\MyDemoRepo).

   Certifique-se de alocar os arquivos diretamente em seu repositório local. Não inclua uma pasta SampleApp_Linux. Na máquina Linux, macOS ou Unix local, por exemplo, a hierarquia de arquivos e diretórios deve ser semelhante a:

   /tmp
      └-- MyDemoRepo
          │-- appspec.yml
          │-- index.html
          │-- LICENSE.txt
          └-- scripts
              │-- install_dependencies
              │-- start_server
              └-- stop_server

3. Para fazer upload dos arquivos para o repositório, use um dos métodos a seguir.

   1. Para usar o CodeCommit console para carregar seus arquivos:

      1. Abra o CodeCommit console e escolha seu repositório na lista Repositórios.

      2. Selecione Add file (Adicionar arquivo) e clique em Upload file (Carregar arquivo).

      3. Selecione Choose file (Escolher arquivo) e procure o arquivo. Para adicionar um arquivo em uma pasta, selecione Criar arquivo e, depois, insira o nome da pasta com o nome do arquivo, como scripts/install_dependencies. Cole o conteúdo do arquivo no novo arquivo.

         Informe seu nome de usuário e endereço de e-mail para confirmar a alteração.

         Escolha Commit changes (Confirmar alterações).

      4. Repita esta etapa para cada arquivo.

         O conteúdo do repositório deve ter a seguinte aparência:

         
                │-- appspec.yml
                │-- index.html
                │-- LICENSE.txt
                └-- scripts
                    │-- install_dependencies
                    │-- start_server
                    └-- stop_server

   2. Para usar os comandos do git para fazer upload dos arquivos:

      1. Altere diretórios para o seu repositório local:

         (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
         (For Windows) cd c:\temp\MyDemoRepo

      2. Execute o seguinte comando para organizar todos os seus arquivos de uma só vez:

         git add -A

      3. Execute o seguinte comando para confirmar os arquivos com uma mensagem de confirmação:

         git commit -m "Add sample application files"

      4. Execute o comando a seguir para enviar os arquivos do seu repositório local para o seu CodeCommit repositório:

         git push

4. Os arquivos que você baixou e adicionou ao seu repositório local agora foram adicionados à main ramificação do seu CodeCommit MyDemoRepo repositório e estão prontos para serem incluídos em um pipeline.

Como criar uma função de instância

1. Abra o IAM console em https://console.aws.amazon.com/iam/).

2. No painel do console, escolha Roles (Funções).

3. Selecione Criar função.

4. Em Selecionar tipo de entidade confiável, selecione AWS service (Serviço da AWS). Em Escolha um caso de uso, selecione EC2. Em Selecione seu caso de uso, escolha EC2. Selecione Next: Permissions (Próximo: permissões).

5. Procure e selecione a política chamada AmazonEC2RoleforAWSCodeDeploy.

6. Procure e selecione a política chamada AmazonSSMManagedInstanceCore. Escolha Próximo: etiquetas.

7. Selecione Next: Review (Próximo: revisar). Forneça um nome para a função (por exemplo, EC2InstanceRole).

   nota

   Anote o nome da função para a próxima etapa. Escolha essa função ao criar a instância.

   Selecione Criar função.

Como iniciar uma instância

1. Abra o EC2 console da Amazon em https://console.aws.amazon.com/ec2/.

2. Na navegação lateral, escolha Instâncias e selecione Executar instâncias na parte superior da página.

3. Em Nome, insira MyCodePipelineDemo. Isso atribui à instância uma tag Chave de Name e uma tag Valor de MyCodePipelineDemo. Posteriormente, você cria um CodeDeploy aplicativo que implanta o aplicativo de amostra nessa instância. CodeDeployseleciona instâncias a serem implantadas com base nas tags.

4. Em Imagens do aplicativo e do sistema operacional (Amazon Machine Image), localize a AMI opção Amazon Linux com o AWS logotipo e verifique se ela está selecionada. (Isso AMI é descrito como Amazon Linux 2 AMI (HVM) e é rotulado como “Qualificado para o nível gratuito”.)

5. Em Tipo de instância, selecione o tipo t2.micro elegível para o nível gratuito como configuração de hardware para a instância.

6. Na seção Par de chaves (login), selecione um par de chaves ou crie um.

   Também é possível selecionar Prosseguir sem um par de chaves.

   nota

   Para os fins deste tutorial, é possível prosseguir sem um par de chaves. Para se conectar SSH às suas instâncias, crie ou use um key pair.

7. Em Configurações de rede, faça o seguinte:

   Em Atribuir IP público automaticamente, verifique se o status é Habilitado.

   • Ao lado de Assign a security group (Atribuir um grupo de segurança), selecione Create a new security group (Criar novo grupo de segurança).

   • Na linha para SSH, em Tipo de origem, escolha Meu IP.

   • Escolha Adicionar grupo de segurança HTTP, escolha e, em Tipo de origem, escolha Meu IP.

8. Expanda Advanced details (Detalhes avançados). No perfil da IAM instância, escolha a IAM função que você criou no procedimento anterior (por exemplo,EC2InstanceRole).

9. Em Resumo, em Número de instâncias, insira 1.

10. Escolha Iniciar instância.

11. É possível visualizar o status da ativação na página Instâncias. Ao executar uma instância, seu estado inicial é pending. Depois que a instância é iniciada, seu estado muda para running e ela recebe um DNS nome público. (Se a DNS coluna Público não for exibida, escolha o ícone Mostrar/Ocultar e selecione Público DNS.)

Para criar uma função CodeDeploy de serviço

1. Abra o IAM console em https://console.aws.amazon.com/iam/).

2. No painel do console, escolha Roles (Funções).

3. Selecione Criar função.

4. Em Selecionar entidade confiável, escolha AWS service (Serviço da AWS). Em Use case (Caso de uso), escolha CodeDeploy. CodeDeployEscolha entre as opções listadas. Escolha Próximo. A política gerenciada AWSCodeDeployRole já está anexada à função.

5. Escolha Próximo.

6. Insira um nome para a função (por exemplo, CodeDeployRole) e escolha Create role (Criar função).

Para criar um aplicativo no CodeDeploy

1. Abra o CodeDeploy console em https://console.aws.amazon.com/codedeploy.

2. Se a página Aplicações não for exibida, no menu, selecione Aplicações.

3. Escolha Criar aplicativo.

4. Em Nome do aplicativo, insira MyDemoApplication.

5. Em Compute Platform, escolha EC2/On-premises.

6. Selecione Create application (Criar aplicativo).

Para criar um grupo de implantação no CodeDeploy

Um grupo de implantação é um recurso que define configurações relacionadas à implantação, como em quais instâncias implantar e com que rapidez implantá-las.

1. Na página que mostra o aplicativo, selecione Create deployment group (Criar grupo de implantação).

2. Em Nome do grupo de implantação, insira MyDemoDeploymentGroup.

3. Em Função de serviço, escolha a função ARN de serviço que você criou anteriormente (por exemplo,arn:aws:iam::account_ID:role/CodeDeployRole).

4. Em Deployment type (Tipo de implantação), selecione In-place (No local).

5. Em Configuração do ambiente, escolha Amazon EC2 Instances. No campo, Chave, insira Name. No campo Valor, insira o nome usado para marcar a instância (por exemplo, MyCodePipelineDemo).

6. Em Configuração do agente com AWS Systems Manager, escolha Agora e agende atualizações. Isso vai instalar o agente na instância. A instância Linux já está configurada com o SSM agente e agora será atualizada com o CodeDeploy agente.

7. Em Deployment configuration (Configuração de implantação), selecione CodeDeployDefault.OneAtaTime.

8. Em Balanceador de carga, verifique se Habilitar balanceamento de carga não está selecionado. Você não precisa configurar um load balancer ou escolher um grupo de destino para este exemplo.

9. Selecione Criar grupo de implantação.

Para criar um CodePipeline pipeline

1. Faça login no AWS Management Console e abra o CodePipeline console em http://console.aws.amazon.com/codesuite/codepipeline/home.

   Abra o CodePipeline console em https://console.aws.amazon.com/codepipeline/.

2. Selecione Criar pipeline.

3. Em Step 1: Choose pipeline settings (Etapa 1: selecionar as configurações do pipeline), em Pipeline name (Nome do pipeline), insira MyFirstPipeline.

4. Em Tipo de pipeline, escolha V2. Para obter mais informações, consulte Tipos de pipeline. Escolha Próximo.

5. Em Função de serviço, escolha Nova função de serviço para permitir CodePipeline a criação de uma função de serviço emIAM.

6. Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).

7. Na Etapa 2: Adicionar estágio de origem, em Provedor de origem, escolha CodeCommit. Em Nome do repositório, escolha o nome do CodeCommit repositório em que você criou. Etapa 1: criar um CodeCommit repositório Em Branch name (Nome da ramificação), escolha main e, depois, selecione Next step (Próxima etapa).

   Depois de selecionar o nome do repositório e a ramificação, uma mensagem exibe a regra Amazon CloudWatch Events a ser criada para esse pipeline.

   Em Change detection options (Alterar opções de detecção), deixe os valores padrão. Isso permite CodePipeline usar o Amazon CloudWatch Events para detectar alterações em seu repositório de origem.

   Escolha Próximo.

8. Em Step 3: Add build stage (Etapa 3: Adicionar estágio de construção), selecione Skip build stage (Pular estágio de compilação) e aceite a mensagem de aviso ao clicar novamente em Skip (Pular). Escolha Próximo.

   nota

   Neste tutorial, você está implantando um código que não requer um serviço de compilação, portanto, ignore esta etapa. No entanto, se seu código-fonte precisar ser criado antes de ser implantado nas instâncias, você poderá configurá-lo CodeBuildnesta etapa.

9. Na Etapa 4: Adicionar estágio de implantação, em Provedor de implantação, escolha CodeDeploy. Em Application name (Nome do aplicativo), escolha MyDemoApplication. Em Deployment group (Grupo de implantação), escolha MyDemoDeploymentGroup e, depois, selecione Next step (Próxima etapa).

10. Em Etapa 5: Revisar, revise as informações e, então selecione Criar pipeline.

11. O pipeline começa a ser executado depois de ser criado. Ele baixa o código do seu CodeCommit repositório e cria uma CodeDeploy implantação na sua EC2 instância. Você pode visualizar o progresso e as mensagens de sucesso e falha à medida que a CodePipeline amostra implanta a página da web na EC2 instância da Amazon na CodeDeploy implantação.

    

Para verificar se o seu pipeline foi executado com êxito

1. Visualize o progresso inicial do pipeline. O status de cada estágio muda de No executions yet (Ainda não executado) para In Progress (Em andamento) e, então, para Succeeded (Bem-sucedido) ou Failed (Falhou). O pipeline deve concluir a primeira execução dentro de alguns minutos.

2. Depois que Succeeded for exibido para o status do pipeline, na área de status do estágio Implantação, escolha CodeDeploy. Isso abre o CodeDeploy console. Se Succeeded (Bem-sucedido) não for exibido, consulte Solução de problemas CodePipeline.

3. Na guia Implantações, selecione o ID de implantação. Na página da implantação, em Eventos de ciclo de vida da implantação, selecione o ID da instância. Isso abre o console do EC2.

4. Na guia Descrição, em Público DNS, copie o endereço (por exemplo,ec2-192-0-2-1.us-west-2.compute.amazonaws.com) e cole-o na barra de endereço do seu navegador da web.

   A página da web é exibida para o aplicativo de amostra que você baixou e enviou para o seu CodeCommit repositório.

1. Altere diretórios para o seu repositório local:

   (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
   (For Windows) cd c:\temp\MyDemoRepo

2. Use um editor de texto para modificar o arquivo index.html:

   (For Linux or Unix)gedit index.html
   (For OS X)open –e index.html
   (For Windows)notepad index.html

3. Revise o conteúdo do arquivo index.html para alterar a cor do plano de fundo e parte do texto na página da web e depois salve o arquivo.

   <!DOCTYPE html>
   <html>
   <head>
     <title>Updated Sample Deployment</title>
     <style>
       body {
         color: #000000;
         background-color: #CCFFCC;
         font-family: Arial, sans-serif;  
         font-size:14px;
       }
           
       h1 {
         font-size: 250%;
         font-weight: normal;
         margin-bottom: 0;
       }
       
       h2 {
         font-size: 175%;
         font-weight: normal;
         margin-bottom: 0;
       }
     </style>
   </head>
   <body>
     <div align="center"><h1>Updated Sample Deployment</h1></div>
     <div align="center"><h2>This application was updated using CodePipeline, CodeCommit, and CodeDeploy.</h2></div>
     <div align="center">
       <p>Learn more:</p> 
       <p><a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/">CodePipeline User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codecommit/latest/userguide/">CodeCommit User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codedeploy/latest/userguide/">CodeDeploy User Guide</a></p>
     </div>
   </body>
   </html>

4. Confirme e envie suas alterações para seu CodeCommit repositório executando os seguintes comandos, um por vez:

   git commit -am "Updated sample application files"

   git push

Como verificar se seu pipeline foi executado com êxito

1. Visualize o progresso inicial do pipeline. O status de cada estágio muda de No executions yet (Ainda não executado) para In Progress (Em andamento) e, então, para Succeeded (Bem-sucedido) ou Failed (Falhou). A execução do pipeline deve ser concluída em alguns minutos.

2. Depois que Succeeded (Bem-sucedido) for exibido para o status da ação, atualize a página de demonstração acessada anteriormente no navegador.

   A página da web atualizada é exibida.

Para limpar os recursos usados neste tutorial

1. Para limpar seus CodePipeline recursos, siga as instruções em Excluir um pipeline em AWS CodePipeline.

2. Para limpar seus CodeDeploy recursos, siga as instruções em Clean Up Deployment Walkthrough Resources.

3. Para excluir o CodeCommit repositório, siga as instruções em Excluir um CodeCommit repositório.