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.

Filtrer les déclencheurs sur les requêtes push ou pull de code

Vous pouvez configurer des filtres pour les déclencheurs de pipeline afin de lancer l'exécution du pipeline pour différents événements Git, tels que le push de balises ou de branches, la modification de chemins de fichiers spécifiques, l'ouverture d'une pull request dans une branche spécifique, etc. Vous pouvez utiliser la AWS CodePipeline console ou les update-pipeline commandes create-pipeline et du AWS CLI pour configurer les filtres des déclencheurs.

Vous pouvez définir des filtres pour les types de déclencheurs suivants :

La définition du pipeline vous permet de combiner différents filtres au sein d'une même configuration de déclencheur push. Pour plus de détails sur la définition du pipeline, voirDéclencher le filtrage dans le pipeline JSON (CLI). Les combinaisons valides sont les suivantes :

Vous spécifiez les types de filtres comme suit :

Le tableau suivant fournit des options de filtre valides pour chaque type d'événement. Le tableau indique également quelles configurations de déclencheur sont définies par défaut sur true ou false pour la détection automatique des modifications dans la configuration de l'action.

Pour le filtrage, les modèles d'expressions régulières au format global sont pris en charge, comme indiqué dansUtilisation de modèles globulaires dans la syntaxe.

Considérations relatives aux filtres déclencheurs

Les considérations suivantes s'appliquent lors de l'utilisation de déclencheurs.

Exemples de filtres déclencheurs

Dans le cas d'une configuration Git avec des filtres pour les types d'événements push et pull request, les filtres spécifiés peuvent entrer en conflit les uns avec les autres. Vous trouverez ci-dessous des exemples de combinaisons de filtres valides pour les événements de requêtes push et pull.

Vous pouvez combiner des filtres au sein d'un même objet de configuration, et ces filtres utiliseront une AND opération, ce qui signifie que seule une correspondance complète démarrera le pipeline. L'exemple suivant montre une configuration Git avec deux filtres différents (filePathsetbranches) dans « l'objet de configuration » et non un seul filtre. Dans l'exemple suivant, filePaths sera AND écrit avec branches :

{
  "filePaths": {
    "includes": ["common/**/*.js"]
  },
  "branches": {
    "includes": ["feature/**"]
  }
}

Avec la configuration Git ci-dessus, cet exemple montre un événement qui lancera l'exécution du pipeline en cas de réussite de l'ANDopération.

{
  "ref": "refs/heads/feature/triggers",
  ...
  "commits": [
    {
      ...
      "modified": [
        "common/app.js"
      ]
      ...
    }
  ]
}

Cet exemple montre un événement qui ne démarrera pas l'exécution du pipeline car la branche est capable de filtrer, mais pas le chemin du fichier.

{
   "ref": "refs/heads/feature/triggers",
  ...
  "commits": [
    {
      ...
      "modified": [
        "src/Main.java"
      ]
      ...
    }
  ]
}

Dans le même temps, les objets de configuration du déclencheur au sein du tableau push utilisent une opération OR. Cela vous permet de configurer plusieurs déclencheurs pour démarrer l'exécution du même pipeline. L'exemple suivant montre une configuration Git avec un seul filtre (branches) dans l'objet de configuration. Les Excludes opérations Includes et seront exécutées en mode OR, ce qui signifie que si une branche correspond à un modèle d'exclusion (comme feature-branch dans l'exemple), le pipeline ne sera pas déclenché à moins qu'une inclusion ne corresponde également. Si le modèle d'inclusion correspond, par exemple pour la main branche, le pipeline sera déclenché.

{
  "branches": {
      "Includes": [
          "main"
      ],
      "Excludes": [
          "feature-branch"
      ]
   }

Pour obtenir la liste des définitions de champs de la JSON structure, consultezDéclencher le filtrage dans le pipeline JSON (CLI).