View a markdown version of this page

Tutoriel : Filtrer les noms de branches pour les pull requests afin de démarrer votre pipeline (type V2) - AWS CodePipeline
Conditions préalablesÉtape 1 : Création d'un pipeline à démarrer lors d'une demande d'extraction pour des branches spécifiéesÉtape 2 : Créez et fusionnez une pull request GitHub.com pour démarrer les exécutions de votre pipeline

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 : Filtrer les noms de branches pour les pull requests afin de démarrer votre pipeline (type V2)

Dans ce didacticiel, vous allez créer un pipeline qui se connecte à votre GitHub.com référentiel où l'action source est configurée pour démarrer votre pipeline avec une configuration de déclenchement qui filtre les demandes d'extraction. Lorsqu'un événement de demande d'extraction 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, consultezAjouter des filtres pour les types d'événements de requêtes push et pull (CLI). Pour plus d'informations sur le filtrage à l'aide de modèles regex au format glob, consultez. Utilisation de modèles globulaires dans la syntaxe

Important

Dans le cadre de la création d'un pipeline, un compartiment d'artefacts S3 fourni par le client sera utilisé par CodePipeline les artefacts. (Ce compartiment 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 Comptes AWS à une société sûre et fiable.

Ce didacticiel se connecte GitHub.com via le type CodeStarSourceConnection d'action.

Conditions préalables

Avant de commencer, vous devez exécuter les opérations suivantes :

  • Créez un GitHub.com référentiel avec votre GitHub.com compte.

  • Préparez vos GitHub informations d'identification. Lorsque vous utilisez le Console de gestion AWS 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 demande d'extraction pour des branches spécifiées

Dans cette section, vous créez un pipeline avec les actions suivantes :

  • Stage source avec connexion à votre GitHub.com référentiel et à votre action.

  • Une étape 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/.

  2. Sur la page Bienvenue, Démarrez ou Pipelines, choisissez Créer un pipeline.

  3. Sur la page Étape 1 : Choisissez l'option de création, sous Options de création, choisissez l'option Créer un pipeline personnalisé. Choisissez Suivant.

  4. À l'étape 2 : choisissez les paramètres du pipeline, dans Nom du pipeline, entrezMyFilterBranchesPipeline.

  5. Dans Type de pipeline, conservez la sélection par défaut sur V2. Les types de pipelines diffèrent en termes de caractéristiques et de prix. Pour de plus amples informations, veuillez consulter Types de canalisations.

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

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

  8. Sur la page Étape 3 : Ajouter une étape source, ajoutez une étape source :

    1. Dans Source provider, choisissez GitHub (via GitHub App).

    2. 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, consultezGitHub connexions.

    3. Dans Nom du référentiel, choisissez le nom de votre référentiel GitHub.com.

    4. 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 demande d'extraction afin que l'événement se produise pour les demandes d'extraction créées, mises à jour ou fermées.

      Sous Branches, dans le champ Inclure, saisissezmain*.

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

  9. À l'étape 4 : Ajouter une étape de construction, dans Build provider, 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é dansTutoriel : Utiliser les balises Git pour démarrer votre pipeline. Cette action ne sera utilisée dans ce didacticiel que comme deuxième étape nécessaire à la création de votre pipeline.

  10. À l'étape 5 : Ajouter une phase de test, choisissez Ignorer la phase de test, puis acceptez le message d'avertissement en choisissant de nouveau Ignorer.

    Choisissez Suivant.

  11. 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 de nouveau Ignorer. Choisissez Suivant.

  12. À l'étape 7 : Révision, choisissez Créer un pipeline.

Étape 2 : Créez et fusionnez une pull request 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 demande d'extraction ouverte et une exécution pour la demande d'extraction fermée.

Pour créer une pull request et démarrer votre pipeline

  1. Dans GitHub.com, créez une demande d'extraction en modifiant la README.md branche d'une fonctionnalité et en soumettant une demande d'extraction à la main branche. Validez la modification avec un message tel queUpdate README.md for PR.

  2. Le pipeline commence par la révision de la source affichant le message source pour la pull request sous la forme Update README.md for PR.

    Image montrant le message source de la Pull request avec le texte suivant : Update README.md for PR

  3. Choisissez History (Historique). Dans l'historique des exécutions du pipeline, consultez les événements d'état des demandes d'extraction CREATED et MERGED qui ont déclenché les exécutions du pipeline.

    Image montrant l'historique des exécutions du pipeline qui montre les événements d'état des demandes d'extraction CREATED et MERGED qui ont démarré les exécutions du pipeline