Adicionar uma ação de compilação do CodeBuild a um pipeline (console do CodePipeline)

1. Faça login no AWS Management Console usando:

   • Sua conta raiz AWS. Isso não é recomendado. Para obter mais informações, consulte O usuário raiz da conta no Guia do usuário do .

   • Um usuário administrador na conta da AWS. Para obter mais informações, consulte Creating your first Conta da AWS root user and group no Guia do usuário.

   • Um usuário na conta da AWS com permissão para executar o seguinte conjunto mínimo de ações:

     codepipeline:*
     iam:ListRoles
     iam:PassRole
     s3:CreateBucket
     s3:GetBucketPolicy
     s3:GetObject
     s3:ListAllMyBuckets
     s3:ListBucket
     s3:PutBucketPolicy
     codecommit:ListBranches
     codecommit:ListRepositories
     codedeploy:GetApplication
     codedeploy:GetDeploymentGroup
     codedeploy:ListApplications
     codedeploy:ListDeploymentGroups
     elasticbeanstalk:DescribeApplications
     elasticbeanstalk:DescribeEnvironments
     lambda:GetFunctionConfiguration
     lambda:ListFunctions
     opsworks:DescribeStacks
     opsworks:DescribeApps
     opsworks:DescribeLayers

2. Abra o console do CodePipeline em https://console.aws.amazon.com/codesuite/codecommit/home.

3. No seletor de regiões AWS, selecione a região AWS onde o pipeline está localizado. Deve ser uma região onde o CodeBuild seja aceito. Para obter mais informações, consulte CodeBuild no Referência geral da Amazon Web Services.

4. Na página Pipelines, selecione o nome do pipeline.

5. Na página de detalhes do pipeline, na ação Source (Origem), selecione a dica de ferramenta. Anote o valor para Output artifact (Artefato de saída) (por exemplo, MyApp).

   nota

   Este procedimento mostra como adicionar uma ação de build em um estágio de build entre os estágios Source (Origem) e Beta (Beta). Se quiser adicionar a ação de build a outro lugar, escolha a dica de ferramenta sobre a ação próximo ao local onde você deseja adicionar a ação de build e anote o valor para Output artifact (Artefato de saída).

6. Escolha Editar.

7. Entre os estágios Source (Origem) e Beta, selecione Add stage (Adicionar estágio).

   nota

   Este procedimento mostra como adicionar um estágio de compilação entre os estágios Source (Origem) e Beta (Beta) ao pipeline. Para adicionar uma ação de compilação a um estágio existente, selecione Edit stage (Editar estágio) no estágio e avance para a etapa 8 deste procedimento. Para adicionar o estágio de compilação em outro local, selecione Add stage (Adicionar estágio) no local desejado.

   

8. Para Stage name (Nome do estágio), insira o nome do estágio de compilação (por exemplo, Build). Se escolher um nome diferente, use-o nas etapas deste procedimento.

9. Em vez do estágio selecionado, selecione Add action (Adicionar ação).

   nota

   Este procedimento mostra como acrescentar a ação de compilação em um estágio de compilação. Para adicionar a ação de compilação em outro local, selecione Add action (Adicionar ação) no local desejado. Talvez seja necessário selecionar primeiro Edit stage (Editar estágio) no estágio existente em que deseja adicionar a ação de compilação.

10. Em Edit action (Editar ação), em Action name (Nome da ação), insira um nome para a ação (por exemplo, CodeBuild). Se escolher um nome diferente, use-o nas etapas deste procedimento.

11. Para Provedor de ação, escolha CodeBuild.

12. Se você já tiver um projeto de compilação que deseja usar, em Nome do projeto, escolha o nome do projeto de compilação e avance para a próxima etapa deste procedimento.

    Se você precisar criar um projeto de compilação do CodeBuild, siga as instruções em Criar um projeto de compilação (console) e retorne a este procedimento.

    Se escolher um projeto de compilação existente, as configurações de artefato de saída da compilação já devem estar definidas (embora o CodePipeline as substitua). Para obter mais informações, consulte a descrição de Artifacts (Artefatos) em Criar um projeto de compilação (console) ou Alterar configurações de um projeto de compilação (console).

    Importante

    Se você habilitar webhooks para um projeto do CodeBuild e o projeto for usado como uma etapa de compilação no CodePipeline, duas compilações idênticas serão criadas para cada confirmação. Uma compilação é acionada por meio de webhooks e outra por meio do CodePipeline. Como o faturamento é por compilação, você é cobrado por ambas as compilações. Portanto, se você estiver usando o CodePipeline, será recomendável desabilitar os webhooks no CodeBuild. No console do CodeBuild, desmarque a caixa Webhook. Para obter mais informações, consulte Alterar configurações de um projeto de compilação (console).

13. Em Input artifacts (Artefatos de entrada), selecione o artefato de saída que você anotou anteriormente neste procedimento.

14. Em Output artifacts (Artefatos de saída), insira um nome para o artefato de saída (por exemplo, MyAppBuild).

15. Selecione Add action.

16. Escolha Save (Salvar) e selecione Save (Salvar) para salvar suas alterações no pipeline.

17. Selecione Release change.

18. Depois de o pipeline ser executado com sucesso, você pode obter o artefato de saída de build. Com o pipeline exibido no console do CodePipeline, na ação Compilar, selecione a dica de ferramenta. Anote o valor para Output artifact (por exemplo, MyAppBuild).

    nota

    Também é possível obter o artefato de saída da compilação selecionando o link Criar artefatos na página de detalhes da compilação, no console do CodeBuild. Para acessar essa página, consulte Visualizar detalhes de compilação (console) e avance para a etapa 31 deste procedimento.

19. Abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

20. Na lista de bucket, abra o bucket usado pelo pipeline. O nome do bucket deve seguir o formato codepipeline-region-ID-random-number. É possível usar a AWS CLI para executar o comando get-pipeline do CodePipeline para obter o nome do bucket:

    aws codepipeline get-pipeline --name my-pipeline-name

    Na saída, o objeto pipeline contém um objeto artifactStore, que contém um valor location com o nome do bucket.

21. Abra a pasta que corresponda ao nome de seu pipeline (dependendo do tamanho do nome do pipeline, o nome da pasta pode estar truncado) e abra a pasta correspondente ao valor de Output artifact (Artefato de entrada) que você anotou anteriormente neste procedimento.

22. Extraia o conteúdo do arquivo . Se houver vários arquivos na pasta, extraia o conteúdo do arquivo com o carimbo Last Modified mais recente. (Talvez você precise atribuir ao arquivo a extensão .zip, de maneira que possa trabalhar com ele no utilitário ZIP do sistema.) O artefato de saída de build está no conteúdo extraído do arquivo.

23. Se você instruiu o CodePipeline para implantar o artefato de saída da compilação, use as instruções do provedor de implantação para obter o artefato de saída da compilação nos resultados de implantação.