As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Crie um pipeline que use CodeBuild (CodePipeline console) Use o procedimento a seguir para criar um pipeline usado CodeBuild para criar e implantar seu código-fonte. Para criar um pipeline que somente teste o código-fonte: + Use o seguinte procedimento para criar o pipeline e, então, exclua do pipeline os estágios Build e Beta. Depois use o procedimento [Adicionar uma ação CodeBuild de teste a um pipeline (CodePipeline console)](how-to-create-pipeline-add-test.md) neste tópico para adicionar ao pipeline uma ação de teste que use CodeBuild. + Use um dos outros procedimentos neste tópico para criar o pipeline e, depois, use o procedimento [Adicionar uma ação CodeBuild de teste a um pipeline (CodePipeline console)](how-to-create-pipeline-add-test.md) neste tópico para adicionar ao pipeline uma ação de teste que use CodeBuild. **Para usar o assistente de criação de pipeline CodePipeline para criar um pipeline que usa CodeBuild** 1. Faça login no Console de gerenciamento da AWS usando: + Sua conta AWS root. Isso não é recomendado. Para obter mais informações, consulte [O usuário raiz da conta](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html) no *Guia do usuário do *. + Um usuário administrador em sua AWS conta. Para obter mais informações, consulte [Como criar seu primeiro usuário e grupo Conta da AWS raiz](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) no *Guia do usuário*. + Um usuário em sua AWS conta com permissão para usar 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 ``` 1. Abra o AWS CodePipeline console em [https://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home). 1. No seletor de AWS região, escolha a AWS região em que os AWS recursos do seu projeto de construção estão localizados. Essa deve ser uma AWS região CodeBuild com suporte. Para ter mais informações, consulte [AWS CodeBuild](https://docs.aws.amazon.com/general/latest/gr/rande.html#codebuild_region) no *Referência geral da Amazon Web Services*. 1. Crie um pipeline. Se uma página de CodePipeline informações for exibida, escolha **Criar pipeline**. Se uma página **All Pipelines (Todos os pipelines)** for exibida, selecione **Create pipeline (Criar pipeline)**. 1. Na página **Step 1: Choose pipeline settings (Etapa 1: selecionar as configurações do pipeline)**, em **Pipeline name (Nome do pipeline)**, insira o nome do pipeline (por exemplo, **CodeBuildDemoPipeline**). Se você escolher um nome diferente, certifique-se de usá-lo durante todo este procedimento. 1. Em **Role name (Nome da função)**, siga um dos seguintes procedimentos: Selecione **New service role (Nova função de serviço)**, e em **Role Name (Nome da função)**, insira o nome para a nova função de serviço. Selecione **Existing service role (Função de serviço existente)** e depois selecione a função de serviço do CodePipeline criada ou identificada como parte dos pré-requisitos deste tópico. 1. Em **Artifact store (Armazenamento de artefatos)**, siga um dos seguintes procedimentos: + Escolha o **local padrão** para usar o armazenamento de artefatos padrão, como o bucket de artefatos S3 designado como padrão, para seu pipeline na AWS região que você selecionou para seu pipeline. + Escolha um **local personalizado** se você já tiver um armazenamento de artefatos criado por você, como um bucket de artefatos do S3, na mesma AWS região do seu pipeline. **nota** Este não é o bucket de origem para o código-fonte do pipeline. Este é o armazenamento de artefatos para o pipeline. Um armazenamento de artefatos separado, como um bucket do S3, é necessário para cada pipeline, na mesma AWS região do pipeline. 1. Escolha **Próximo**. 1. Na página **Step 2: Add source stage (Etapa 2: adicionar estágio de origem)**, para **Source provider (Fornecedor de origem)**, faça um dos seguintes procedimentos: + Se o código-fonte estiver armazenado no bucket do S3, escolha **Amazon S3**. Em **Bucket**, selecione o bucket do S3 que contenha o código-fonte. Em **S3 object key (Chave do objeto do S3)**, insira o nome do arquivo o contém o código-fonte (por exemplo `file-name.zip`). Escolha **Próximo**. + Se seu código-fonte estiver armazenado em um AWS CodeCommit repositório, escolha **CodeCommit**. Para **Repository name (Nome do repositório)**, escolha o nome do repositório que contém o código-fonte. Em **Branch name (Nome da ramificação)**, escolha o nome da ramificação que contenha a versão do código-fonte que você deseja compilar. Escolha **Próximo**. + Se seu código-fonte estiver armazenado em um GitHub repositório, escolha **GitHub**. Escolha **Connect GitHub to** e siga as instruções para se autenticar com GitHub. Para **Repository (Repositório)**, escolha o nome do repositório que contém o código-fonte. Em **Branch (Ramificação)**, escolha o nome da ramificação que contenha a versão do código-fonte que você deseja compilar. Escolha **Próximo**. 1. Na página **Step 3: Add build stage (Etapa 3: adicionar estágio de compilação)**, em **Build provider (Provedor de compilação)**, escolha **CodeBuild**. 1. 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 novo projeto de CodeBuild compilação, siga as instruções [Criar um projeto de compilação (console)](create-project.md#create-project-console) e retorne a esse procedimento. Se você escolher um projeto de construção existente, ele deverá ter configurações de artefato de saída de construção já definidas (mesmo que as CodePipeline substitua). Para obter mais informações, consulte [Alterar configurações de um projeto de compilação (console)](change-project.md#change-project-console). **Importante** Se você habilitar webhooks para um CodeBuild projeto e o projeto for usado como uma etapa de compilação 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 CodePipeline, recomendamos que você desative os webhooks em. CodeBuild No console do AWS CodeBuild desmarque a caixa de **Webhook**. Para obter mais informações, consulte [Alterar configurações de um projeto de compilação (console)](change-project.md#change-project-console). 1. Na página **Step 4: Add deploy stage (Etapa 4: adicionar estágio de implantação)**, faça o seguinte: + Se você não deseja implantar o artefato de saída da compilação, selecione **Skip (Avançar)** e confirme essa opção quando solicitado. + Se quiser implantar o artefato de saída da compilação, em **Deploy provider (Provedor de implantação)**, selecione um provedor de implantação e especifique as configurações quando solicitadas. Escolha **Próximo**. 1. Na página ** Review (Revisar)**, revise suas escolhas e, em seguida, selecione **Create pipeline (Criar pipeline)**. 1. Depois de o pipeline ser executado com sucesso, você pode obter o artefato de saída de build. Com o pipeline exibido no CodePipeline console, na ação **Criar**, escolha a dica de ferramenta. Anote o valor do **artefato de saída** (por exemplo, **MyAppBuild**). **nota** Você também pode obter o artefato de saída da compilação escolhendo o link **Construir artefatos** na página de detalhes da compilação no CodeBuild console. Para exibir essa página, despreze as etapas restantes deste procedimento e consulte [Visualizar detalhes de compilação (console)](view-build-details.md#view-build-details-console). 1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Na lista de bucket, abra o bucket usado pelo pipeline. O nome do bucket deve seguir o formato `codepipeline-region-ID-random-number`. Você pode usar o AWS CLI para executar o CodePipeline **get-pipeline** comando para obter o nome do bucket, onde *my-pipeline-name* está o nome de exibição do seu pipeline: ``` 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. 1. 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 saída)** que você anotou anteriormente. 1. Extraia o conteúdo do arquivo. Se houver vários arquivos na pasta, extraia o conteúdo do arquivo com o carimbo **Última modificação** 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 compilação está no conteúdo extraído do arquivo. 1. Se você tiver instruído CodePipeline a implantar o artefato de saída de compilação, use as instruções do provedor de implantação para acessar o artefato de saída de compilação nos destinos de implantação.