Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Tutoriel : Filtrez les noms de branches pour les pull requests permettant de démarrer votre pipeline (type V2)
Dans ce didacticiel, vous allez créer un pipeline qui se connecte à votre dépôt GitHub .com où l'action source est configurée pour démarrer votre pipeline avec une configuration de déclenchement qui filtre les pull requests. Lorsqu'un événement de pull request spécifié se produit pour une branche spécifiée, votre pipeline démarre. Cet exemple montre comment créer un pipeline qui permet de filtrer les noms de branches. Pour plus d'informations sur l'utilisation des déclencheurs, consultez[Ajouter des filtres pour les types d'événements de type push et pull request (CLI)](pipelines-filter.md#pipelines-filter-cli). Pour plus d'informations sur le filtrage à l'aide de modèles regex au format global, consultez. [Utilisation de modèles globulaires dans la syntaxe](syntax-glob.md)
**Important**
Dans le cadre de la création d'un pipeline, un compartiment d'artefacts S3 fourni par le client sera utilisé CodePipeline pour les artefacts. (Ceci est différent du compartiment utilisé pour une action source S3.) Si le compartiment d'artefacts S3 se trouve dans un compte différent de celui de votre pipeline, assurez-vous que le compartiment d'artefacts S3 appartient à cette personne sûre et Comptes AWS qu'elle sera fiable.
Ce didacticiel permet de se connecter à GitHub .com via le type `CodeStarSourceConnection` d'action.
**Topics**
+ [Conditions préalables](#tutorials-github-featurebranches-prereq)
+ [Étape 1 : Création d'un pipeline à démarrer lors d'une pull request pour les branches spécifiées](#tutorials-github-featurebranches-pipeline)
+ [Étape 2 : créer et fusionner une pull request dans GitHub .com pour démarrer les exécutions de votre pipeline](#tutorials-github-featurebranches-pullrequest)
## Conditions préalables
Avant de commencer, vous devez exécuter les opérations suivantes :
+ Créez un dépôt GitHub .com avec votre compte GitHub .com.
+ Préparez vos GitHub informations d'identification. Lorsque vous utilisez le AWS Management Console pour établir une connexion, il vous est demandé de vous connecter avec vos GitHub informations d'identification.
## Étape 1 : Création d'un pipeline à démarrer lors d'une pull request pour les branches spécifiées
Dans cette section, vous créez un pipeline avec les actions suivantes :
+ Un stage source avec une connexion à votre référentiel GitHub .com et une action.
+ Une phase de construction avec une action de AWS CodeBuild construction.
**Pour créer un pipeline avec l'assistant**
1. Connectez-vous à la CodePipeline console à l'adresse [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Sur la page **Bienvenue**, **Démarrez** ou **Pipelines**, choisissez **Créer un pipeline**.
1. Sur la page **Étape 1 : Choisir une option de création**, sous **Options de création**, choisissez l'option **Créer un pipeline personnalisé**. Choisissez **Suivant**.
1. À **l'étape 2 : Choisissez les paramètres du pipeline**, dans **Nom du pipeline**, entrez**MyFilterBranchesPipeline**.
1. Dans **Type de pipeline**, conservez la sélection par défaut à **V2**. Les types de pipelines diffèrent en termes de caractéristiques et de prix. Pour de plus amples informations, veuillez consulter [Types de pipelines](pipeline-types.md).
1. Dans **Service role (Rôle de service)**, choisissez **New service role (Nouveau rôle de service)**.
**Note**
Si vous choisissez plutôt d'utiliser votre rôle de CodePipeline service existant, assurez-vous d'avoir ajouté l'autorisation `codeconnections:UseConnection` IAM à votre politique de rôle de service. Pour obtenir des instructions relatives au rôle de CodePipeline service, voir [Ajouter des autorisations au rôle CodePipeline de service](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).
1. Sous **Paramètres avancés**, conservez les valeurs par défaut. Dans le **magasin d'artefacts** choisissez **Default location (Emplacement par défaut)** pour utiliser le magasin d'artefacts par défaut, tel que le compartiment d'artefacts Amazon S3 désigné par défaut, pour votre pipeline dans la région que vous avez sélectionnée pour ce dernier.
**Note**
Il ne s'agit pas du compartiment source de votre code source. Il s'agit du magasin d'artefacts pour votre pipeline. Un magasin d'artefacts distinct, tel qu'un compartiment S3, est nécessaire pour chaque pipeline.
Choisissez **Suivant**.
1. Sur la page **Étape 3 : Ajouter un stage source**, ajoutez un stage source :
1. Dans **Source provider**, sélectionnez **GitHub (via GitHub App)**.
1. Sous **Connexion**, choisissez une connexion existante ou créez-en une nouvelle. Pour créer ou gérer une connexion pour votre action GitHub source, consultez[GitHub connexions](connections-github.md).
1. Dans **Nom du référentiel**, choisissez le nom de votre dépôt GitHub .com.
1. Sous **Type de déclencheur**, choisissez **Spécifier le filtre**.
Sous **Type d'événement**, choisissez **Pull request**. Sélectionnez tous les événements sous pull request afin que l'événement se produise pour les pull requests créées, mises à jour ou fermées.
Sous **Branches**, dans le champ **Inclure**, entrez`main*`.
![\[Image montrant l'option Inclure les branches sélectionnée avec une valeur de main* pour un déclencheur avec un type d'événement de type Pull request\]](http://docs.aws.amazon.com/fr_fr/codepipeline/latest/userguide/images/pullreq-example-triggers-edit.png)
**Important**
Les pipelines qui commencent par ce type de déclencheur seront configurés pour les événements WebHookV2 et n'utiliseront pas l'événement Webhook (détection des modifications sur tous les événements push) pour démarrer le pipeline.
Choisissez **Suivant**.
1. À **l'étape 4 : Ajouter une phase de construction**, dans **Fournisseur de** génération, choisissez **AWS CodeBuild**. Acceptez la région du pipeline comme **Région** par défaut. Choisissez ou créez le projet de construction comme indiqué dans[Tutoriel : utilisez les balises Git pour démarrer votre pipeline](tutorials-github-tags.md). Cette action ne sera utilisée dans ce didacticiel que comme deuxième étape nécessaire à la création de votre pipeline.
1. À **l'étape 5 : Ajouter une phase de test**, choisissez **Ignorer l'étape de test**, puis acceptez le message d'avertissement en choisissant à nouveau **Ignorer**.
Choisissez **Suivant**.
1. Sur la page **Étape 6 : Ajouter une phase de déploiement**, choisissez **Ignorer l'étape de déploiement**, puis acceptez le message d'avertissement en choisissant à nouveau **Ignorer**. Choisissez **Suivant**.
1. À **l'étape 7 : Révision**, choisissez **Créer un pipeline**.
## Étape 2 : créer et fusionner une pull request dans GitHub .com pour démarrer les exécutions de votre pipeline
Dans cette section, vous allez créer et fusionner une pull request. Cela démarre votre pipeline, avec une exécution pour la pull request ouverte et une exécution pour la pull request fermée.
**Pour créer une pull request et démarrer votre pipeline**
1. Dans GitHub .com, créez une pull request en modifiant le fichier README.md sur une branche de fonctionnalité et en soumettant une pull request à la branche. `main` Validez la modification avec un message tel que`Update README.md for PR`.
1. Le pipeline commence par la révision de la source affichant le message **source** de la pull request sous la forme **Update README.md** for PR.
![\[Image montrant le message source de la requête Pull avec le texte suivant : Update README.md for PR\]](http://docs.aws.amazon.com/fr_fr/codepipeline/latest/userguide/images/pullreq-example.png)
1. Choisissez **History (Historique**). Dans l'historique des exécutions du pipeline, consultez les événements d'état des pull request CREATED et MERGED qui ont déclenché les exécutions du pipeline.
![\[Image montrant l'historique d'exécution du pipeline qui montre les événements d'état des pull request CREATED et MERGED qui ont lancé les exécutions du pipeline\]](http://docs.aws.amazon.com/fr_fr/codepipeline/latest/userguide/images/pullreq-example-history.png)