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á.
# Tutorial: Filtrar nomes de ramificação para solicitações pull a fim de iniciar o pipeline (tipo V2)
Neste tutorial, você criará um pipeline que se conecta ao seu GitHub repositório.com, onde a ação de origem é configurada para iniciar seu pipeline com uma configuração de gatilho que filtra as pull requests. Quando um evento de solicitação pull especificado ocorre para uma ramificação específica, o pipeline é iniciado. Este exemplo mostra como criar um pipeline que permite a filtragem de nomes de ramificações. Para ter mais informações sobre como trabalhar com gatilhos, consulte [Adicionar filtros para tipos de evento push e pull request (CLI)](pipelines-filter.md#pipelines-filter-cli). Para ter mais informações sobre como filtrar com padrões regex no formato glob, consulte [Trabalhar com padrões glob na sintaxe](syntax-glob.md).
**Importante**
Como parte da criação de um pipeline, um bucket de artefatos S3 fornecido pelo cliente será usado CodePipeline por for artefacts. (Este bucket não é o mesmo utilizado para uma ação de origem do S3.) Se o bucket de artefatos do S3 estiver em uma conta diferente da conta do seu pipeline, certifique-se de que o bucket de artefatos do S3 Contas da AWS seja de propriedade de quem é seguro e confiável.
Este tutorial se conecta ao GitHub domínio.com por meio do tipo de `CodeStarSourceConnection` ação.
**Topics**
+ [Pré-requisitos](#tutorials-github-featurebranches-prereq)
+ [Etapa 1: criar um pipeline para iniciar uma solicitação pull para ramificações especificadas](#tutorials-github-featurebranches-pipeline)
+ [Etapa 2: criar e mesclar uma pull request em GitHub .com para iniciar suas execuções de funil](#tutorials-github-featurebranches-pullrequest)
## Pré-requisitos
Antes de começar, é necessário fazer o seguinte:
+ Crie um GitHub repositório.com com sua conta GitHub .com.
+ Tenha suas GitHub credenciais prontas. Quando você usa o Console de gerenciamento da AWS para configurar uma conexão, você é solicitado a entrar com suas GitHub credenciais.
## Etapa 1: criar um pipeline para iniciar uma solicitação pull para ramificações especificadas
Nesta seção, você criará um pipeline com as seguintes ações:
+ Um estágio de origem com uma conexão com seu repositório e ação GitHub .com.
+ Um estágio de construção com uma ação de AWS CodeBuild construção.
**Criar um pipeline com o assistente**
1. Faça login no CodePipeline console em [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Na página **Welcome (Bem-vindo)**, **Getting started (Conceitos básicos)** ou **Pipelines**, selecione **Create pipeline (Criar pipeline)**.
1. Na página **Etapa 1: Escolher opção de criação**, em **Opções de criação**, selecione a opção **Criar pipeline personalizado**. Escolha **Próximo**.
1. Em **Etapa 2: Escolher as configurações do pipeline**, em **Nome do pipeline**, insira **MyFilterBranchesPipeline**.
1. Em **Tipo de pipeline**, mantenha a seleção padrão em **V2**. Os tipos de pipeline diferem em características e preços. Para obter mais informações, consulte [Tipos de pipeline](pipeline-types.md).
1. Em **Service role (Função do serviço)**, selecione **New service role (Nova função de serviço)**.
**nota**
Se você optar por usar sua função de CodePipeline serviço existente, certifique-se de ter adicionado a permissão do `codeconnections:UseConnection` IAM à sua política de função de serviço. Para obter instruções sobre a função de CodePipeline serviço, consulte [Adicionar permissões à função CodePipeline de serviço](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).
1. Em **Configurações avançadas** mantenha os padrões. Em **Artifact store** (Armazenamento de artefatos), selecione **Default location** (Local padrão) para usar o armazenamento de artefatos padrão, como o bucket de artefatos do Amazon S3 designado como padrão, para o pipeline na região que você selecionou.
**nota**
Este não é o bucket de origem para seu código-fonte. Este é o armazenamento de artefatos para o pipeline. Um armazenamento de artefatos separado, como um bucket do S3, é necessário para cada pipeline.
Escolha **Próximo**.
1. Na página **Etapa 3: Adicionar etapa de origem**, adicione uma etapa de origem:
1. Em **Provedor de origem**, escolha **GitHub (via GitHub aplicativo)**.
1. 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, consulte[GitHub conexões](connections-github.md).
1. Em **Nome do repositório**, escolha o nome do seu GitHub repositório.com.
1. Em **Tipo de gatilho**, escolha **Especificar filtro**.
Em **Tipo de evento**, escolha **Solicitação pull**. Selecione todos os eventos em solicitação pull para que sejam acionados ao criar, atualizar ou fechar as solicitações pull.
Em **Ramificações**, no campo **Incluir**, insira `main*`.
![\[Imagem mostrando a opção Incluir ramificações selecionada com um valor de main* para um gatilho com um tipo de evento de solicitação pull\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/pullreq-example-triggers-edit.png)
**Importante**
Os pipelines que começam com esse tipo de gatilho serão configurados para eventos WebhookV2 e não usarão o evento Webhook (detecção de alterações em todos os eventos push) para iniciar o pipeline.
Escolha **Próximo**.
1. Em **Etapa 4: Adicionar etapa de compilação**, em **Provedor de compilação**, escolha **AWS CodeBuild**. Permita que **Region (Região)** seja definida para a região do pipeline. Escolha ou crie o projeto de compilação conforme as instruções em [Tutorial: Usar tags do Git para iniciar o pipeline](tutorials-github-tags.md). Esta ação será usada neste tutorial apenas como o segundo estágio necessário para criar o pipeline.
1. Em **Etapa 5: Adicionar etapa de teste**, escolha **Ignorar etapa de teste** e aceite a mensagem de aviso escolhendo **Ignorar** novamente.
Escolha **Próximo**.
1. Na página **Etapa 6: Adicionar estágio de implantação**, escolha **Ignorar estágio de implantação** e, em seguida, aceite a mensagem de aviso escolhendo **Ignorar** novamente. Escolha **Próximo**.
1. Na **Etapa 7: Revisão**, escolha **Criar funil**.
## Etapa 2: criar e mesclar uma pull request em GitHub .com para iniciar suas execuções de funil
Nesta seção, você cria e mescla uma solicitação pull. Isso inicia o pipeline, com uma execução para solicitação pull aberta e uma execução para solicitação pull fechada.
**Como criar uma solicitação pull e iniciar o pipeline**
1. Em GitHub .com, crie uma pull request fazendo uma alteração no README.md em uma ramificação de recurso e gerando uma pull request para a ramificação. `main` Confirme a alteração com uma mensagem como `Update README.md for PR`.
1. O pipeline começa com a revisão de origem mostrando a mensagem de **Origem** da solicitação pull como **Atualizar README.md para PR**.
![\[Imagem exibindo a mensagem de origem da solicitação Pull com o seguinte texto: Update README.md for PR\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/pullreq-example.png)
1. Escolha **History (Histórico)**. No histórico de execução do pipeline, visualize os eventos de status de solicitação pull CREATED e MERGED que iniciaram as execuções do pipeline.
![\[Imagem mostrando o histórico de execução do pipeline que mostra os eventos de status de solicitação pull CREATED e MERGED que iniciaram as execuções do pipeline\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/pullreq-example-history.png)