Tutorial: Criar um pipeline de quatro estágios

Para clonar a amostra e enviá-la para um repositório GitHub

1. Baixe o código de amostra do GitHub repositório ou clone os repositórios em seu computador local. Há dois pacotes de amostra:

   • Se você for implantar sua amostra em instâncias do Amazon Linux ou Ubuntu Server, escolha codepipeline-jenkins-aws-codedeploy_linux.zip. RHEL

   • Se você for implantar sua amostra em instâncias do Windows Server, escolha CodePipeline-Jenkins - _Windows.zip. AWSCodeDeploy

2. No repositório, selecione Fork para clonar a amostra do repositório em um repositório na sua conta do Github. Para obter mais informações, consulte a GitHubdocumentação.

1. Faça login no AWS Management Console e abra o IAM console em https://console.aws.amazon.com/iam/.

2. No IAM console, no painel de navegação, escolha Funções e, em seguida, escolha Criar função.

3. Em Select type of trusted entity (Selecionar o tipo de entidade confiável), escolha AWS service (Serviço da AWS). Em Escolha o serviço que usará essa função, escolha EC2. Em Selecione seu caso de uso, escolha EC2.

4. Selecione Next: Permissions (Próximo: permissões). Na página Attach permissions policies (Anexar políticas de permissões), selecione a política gerenciada AWSCodePipelineCustomActionAccess e escolha Next: Tags (Próximo: tags). Selecione Next: Review (Próximo: revisar).

5. Na página Revisar, em Nome da função, insira o nome da função a ser criada especificamente para a integração com o Jenkins (por exemplo, JenkinsAccess) e, em seguida, escolha Criar função.

Para instalar o Jenkins e o CodePipeline plug-in para Jenkins

1. Crie uma EC2 instância na qual você instalará o Jenkins e, na Etapa 3: Configurar detalhes da instância, certifique-se de escolher a função de instância que você criou (por exemplo, JenkinsAccess). Para obter mais informações sobre a criação de EC2 instâncias, consulte Iniciar uma EC2 instância da Amazon no Guia EC2 do usuário da Amazon.

   nota

   Se você já tem recursos do Jenkins que deseja usar, pode fazer isso, mas deve criar um IAM usuário especial, aplicar a política AWSCodePipelineCustomActionAccess gerenciada a esse usuário e, em seguida, configurar e usar as credenciais de acesso desse usuário no seu recurso do Jenkins. Se você quiser usar a interface do usuário do Jenkins para fornecer as credenciais, configure o Jenkins para permitir somente. HTTPS Para obter mais informações, consulte Solução de problemas CodePipeline.

2. Instalar Jenkins na instância do EC2. Para obter mais informações, consulte a documentação do Jenkins para instalar o Jenkins e iniciar e acessar o Jenkins, assim como details of integration with Jenkins em Integrações de produtos e serviços com CodePipeline.

3. Inicie o Jenkins e, na página inicial, selecione Gerenciar Jenkins.

4. Na página Gerenciar Jenkins, selecione Gerenciar plug-ins.

5. Selecione a guia Available (Disponível) e, na caixa de pesquisa Filter (Filtro), insira AWS CodePipeline. Escolha CodePipeline Plugin para Jenkins na lista e escolha Baixar agora e instalar após reiniciar.

6. Na página Instalar plug-ins/atualizações, selecione Reiniciar Jenkins quando a instalação estiver concluída e nenhum trabalho estiver em execução.

7. Selecione Voltar para o painel.

8. Na página principal, selecione Novo item.

9. Em Nome do item, insira um nome para o projeto Jenkins (por exemplo, MyDemoProject). Escolha Projeto Freestyle e, em seguida, escolha OK.

   nota

   Certifique-se de que o nome do seu projeto atenda aos requisitos do CodePipeline. Para obter mais informações, consulte Cotas em AWS CodePipeline.

10. Na página de configuração do projeto, selecione a caixa de seleção Executar construções simultâneas se necessário. Em Source Code Management (Gerenciamento de código-fonte), selecione AWS CodePipeline. Se você instalou o Jenkins em uma EC2 instância e configurou o AWS CLI com o perfil do IAM usuário que você criou para integração entre CodePipeline e o Jenkins, deixe todos os outros campos vazios.

11. Escolha Avançado e, em Provedor, insira um nome para o provedor da ação conforme ele aparecerá em CodePipeline (por exemplo, MyJenkinsProviderName). Certifique-se de que esse nome seja único e fácil de lembrar. Você o utilizará quando adicionar uma ação de construção para o pipeline mais adiante neste tutorial e novamente quando adicionar uma ação de teste.

    nota

    Esse nome de ação deve atender aos requisitos de nomenclatura para ações em CodePipeline. Para obter mais informações, consulte Cotas em AWS CodePipeline.

12. Em Criar acionadores, desmarque todas as caixas de seleção e selecione Enquete. SCM Em Schedule (Programação), insira cinco asteriscos separados por espaços, conforme a seguir:

    * * * * *

    Isso faz pesquisas a CodePipeline cada minuto.

13. Em Construir, selecione Adicionar etapa da construção. Escolha Executar shell (Amazon Linux ou Ubuntu Server) Executar comando em lote (Windows Server) e, em seguida, digite o seguinte: RHEL

    rake

    nota

    Verifique se o ambiente está configurado com as variáveis e as configurações necessárias para executar rake; caso contrário, a construção falhará.

14. Escolha Adicionar ação pós-compilação e, em seguida, escolha AWS CodePipeline Publisher. Selecione Adicionar, e em Criar pontos de saída, deixe o local em branco. Esta configuração é o padrão. Ela criará um arquivo compactado no final do processo de construção.

15. Selecione Salvar para salvar seu projeto Jenkins.

Para criar um processo de liberação CodePipeline automatizado

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

2. Se necessário, use o seletor de região para alterar a região para aquela em que os recursos do pipeline estão localizados. Por exemplo, se você criou recursos para o tutorial anterior em us-east-2, verifique se o seletor de região está definido como Leste dos EUA (Ohio).

   Para obter mais informações sobre as regiões e os endpoints disponíveis CodePipeline, consulte AWS CodePipeline endpoints e cotas.

3. Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).

4. Na página Step 1: Choose pipeline settings (Etapa 1: selecionar configurações do pipeline), em Pipeline name (Nome do pipeline), insira o nome do seu pipeline.

5. Em Tipo de pipeline, selecione V1 para os fins deste tutorial. Também é possível selecionar V2; no entanto, observe que os tipos de pipeline diferem em características e preços. Para obter mais informações, consulte Tipos de pipeline.

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

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

8. Na página Etapa 2: Adicionar estágio de origem, em Provedor de origem, escolha GitHub.

9. Em Conexão, escolha uma conexão existente ou crie uma nova. Para criar ou gerenciar uma conexão para sua ação GitHub de origem, consulteGitHub conexões.

10. Em Step 3: Add build stage (Etapa 3: adicionar estágio de compilação), escolha Add Jenkins (Adicionar Jenkins). Em Nome do provedor, insira o nome da ação que você forneceu no CodePipeline Plugin para Jenkins (por exemplo MyJenkinsProviderName). Esse nome deve corresponder exatamente ao nome no CodePipeline Plugin para Jenkins. Em Servidor URL, insira URL a EC2 instância em que o Jenkins está instalado. Em Nome do projeto, insira o nome do projeto que você criou no Jenkins, como MyDemoProjecte, em seguida, escolha Avançar.

11. Na Etapa 4: Adicionar estágio de implantação, reutilize o CodeDeploy aplicativo e o grupo de implantação que você criou. Tutorial: Criar um pipeline simples (bucket do S3) Em Deploy provider (Fornecedor de implantação), escolha CodeDeploy. Em Application name (Nome do aplicativo), insira CodePipelineDemoApplication ou selecione o botão de atualização e selecione o nome do aplicativo na lista. Em Deployment group (Grupo de implantação), insira CodePipelineDemoFleet ou selecione-o na lista e selecione Next (Próximo).

    nota

    Você pode usar seus próprios CodeDeploy recursos ou criar novos, mas poderá incorrer em custos adicionais.

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

13. O pipeline inicia automaticamente e executa a amostra através do pipeline. Você pode visualizar as mensagens de progresso, sucesso e falha à medida que o pipeline cria a amostra do Haml HTML e a implanta em uma página da Web em cada uma das EC2 instâncias da Amazon na implantação. CodeDeploy

Para verificar o endereço IP de uma instância onde você implantou seu código

1. Após a exibição do status Bem-sucedido para o pipeline, na área do status para o estágio Staging, selecione Detalhes.

2. Na seção Detalhes da implantação, em ID da instância, selecione a ID da instância de uma das instâncias implantadas com êxito.

3. Copie o endereço IP da instância (por exemplo, 192.168.0.4). Você usará esse endereço IP em seu teste Jenkins.

Para criar o projeto Jenkins

1. Na instância onde você instalou o Jenkins, abra Jenkins e, na página principal, selecione Novo item.

2. Em Nome do item, insira um nome para o projeto Jenkins (por exemplo, MyTestProject). Escolha Projeto Freestyle e, em seguida, escolha OK.

   nota

   Certifique-se de que o nome do seu projeto atenda aos CodePipeline requisitos. Para obter mais informações, consulte Cotas em AWS CodePipeline.

3. Na página de configuração do projeto, selecione a caixa de seleção Executar construções simultâneas se necessário. Em Source Code Management (Gerenciamento de código-fonte), selecione AWS CodePipeline. Se você instalou o Jenkins em uma EC2 instância e configurou o AWS CLI com o perfil do IAM usuário que você criou para integração entre CodePipeline e o Jenkins, deixe todos os outros campos vazios.

   Importante

   Se você estiver configurando um projeto Jenkins e ele não estiver instalado em uma EC2 instância da Amazon ou estiver instalado em uma EC2 instância que esteja executando um sistema operacional Windows, preencha os campos conforme exigido pelas configurações de porta e host proxy e forneça as credenciais do IAM usuário ou função que você configurou para integração entre Jenkins e. CodePipeline

4. Selecione Avançado e, em Categoria, selecione Testar.

5. Em Provedor, insira o mesmo nome que você usou para o projeto de construção (por exemplo, MyJenkinsProviderName). Você usará esse nome ao adicionar a ação de teste ao seu pipeline posteriormente neste tutorial.

   nota

   Esse nome deve atender aos requisitos de CodePipeline nomenclatura das ações. Para obter mais informações, consulte Cotas em AWS CodePipeline.

6. Em Criar acionadores, desmarque todas as caixas de seleção e selecione Enquete. SCM Em Schedule (Programação), insira cinco asteriscos separados por espaços, conforme a seguir:

   * * * * *

   Isso faz pesquisas a CodePipeline cada minuto.

7. Em Construir, selecione Adicionar etapa da construção. Se você estiver implantando em instâncias do Amazon Linux ou Ubuntu Server, escolha Execute shell. RHEL Em seguida, insira o seguinte, em que o endereço IP é o endereço da EC2 instância que você copiou anteriormente:

   TEST_IP_ADDRESS=192.168.0.4 rake test

   Se você estiver implantando em instâncias do Windows Server, escolha Executar comando em lote e digite o seguinte, em que o endereço IP é o endereço da EC2 instância que você copiou anteriormente:

   set TEST_IP_ADDRESS=192.168.0.4 rake test

   nota

   O teste assume uma porta padrão de 80. Se você deseja especificar uma porta diferente, adicione uma instrução de porta de teste, conforme a seguir:

   TEST_IP_ADDRESS=192.168.0.4 TEST_PORT=8000 rake test

8. Escolha Adicionar ação pós-compilação e, em seguida, escolha AWS CodePipeline Publisher. Não selecione Adicionar.

9. Selecione Salvar para salvar seu projeto Jenkins.

Para adicionar um estágio ao seu pipeline que inclui a ação de teste Jenkins

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

2. Em Nome, escolha o nome do pipeline que você criou MySecondPipeline.

3. Na página de detalhes do pipeline, selecione Editar.

4. Na página Edit (Editar), selecione + Stage (Estágio) para adicionar um estágio imediatamente após o estágio de compilação.

5. No campo de nome para o novo estágio, insira um nome (por exemplo, Testing) e escolha + Add action group (+ Adicionar grupo de ações).

6. Em Nome da ação, insira MyJenkinsTest-Action. Em Provedor de teste, escolha o nome do provedor que você especificou no Jenkins (por exemplo, MyJenkinsProviderName). Em Nome do projeto, insira o nome do projeto que você criou no Jenkins (por exemplo, MyTestProject). Em Artefatos de entrada, escolha o artefato da compilação do Jenkins cujo nome padrão é BuildArtifacte, em seguida, escolha Concluído.

   nota

   Como a ação de teste do Jenkins é executada no aplicativo criado na etapa de compilação do Jenkins, use o artefato de compilação para o artefato de entrada na ação de teste.

   Para obter mais informações sobre artefatos de entrada e saída e a estrutura de pipelines, consulte CodePipeline referência de estrutura de tubulação.

7. Na página Editar, selecione Salvar alterações do pipeline. Na caixa de diálogo da opção Salvar alterações do pipeline, selecione Salvar e continuar.

8. Embora o novo estágio tenha sido adicionado ao seu pipeline, um status de Ainda não executado é exibido para o estágio, pois nenhuma alteração acionou outra execução do pipeline. Para executar a amostra por meio do pipeline revisado, na página de detalhes do pipeline, selecione Lançar alteração.

   A visualização do pipeline exibe os estágios e ações em seu pipeline e o estado da revisão em execução através desses quatro estágios. O tempo necessário para que o pipeline seja executado por todos os estágios dependerá do tamanho dos artefatos, da complexidade de sua construção ações de teste, além de outros fatores.

Para limpar os recursos usados neste tutorial

1. Abra uma sessão de terminal em sua máquina Linux, macOS ou Unix local ou um prompt de comando em sua máquina Windows local e execute o comando delete-pipeline para excluir o pipeline que você criou. Em MySecondPipeline, insira o seguinte comando:

   aws codepipeline delete-pipeline --name "MySecondPipeline"

   Esse comando não retorna nada.

2. Para limpar seus CodeDeploy recursos, siga as instruções em Limpeza.

3. Para limpar os recursos da sua instância, exclua a EC2 instância em que você instalou o Jenkins. Para obter mais informações, consulte Limpeza da sua instância.

4. Se você não pretende criar mais pipelines ou usar CodePipeline novamente, exclua o bucket do Amazon S3 usado para armazenar artefatos para seu pipeline. Para excluir o bucket, siga as instruções em Excluir um bucket.

5. Se você não pretende usar a outros recursos para esse pipeline novamente, considere excluí-los, seguindo as orientações para esse recurso específico. Por exemplo, se você quiser excluir o GitHub repositório, siga as instruções em Excluindo um repositório no site. GitHub