Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Trigger für Code-Push- oder Pull-Anfragen filtern

Sie können Filter für Pipeline-Trigger so konfigurieren, dass Pipeline-Ausführungen für verschiedene Git-Ereignisse gestartet werden, z. B. Tag- oder Branch-Push, Änderungen an bestimmten Dateipfaden, eine Pull-Anfrage, die in einem bestimmten Branch geöffnet wird, usw. Sie können die AWS CodePipeline Konsole oder die update-pipeline Befehle create-pipeline und in der verwenden, AWS CLI um die Filter der Trigger zu konfigurieren.

Sie können Filter für die folgenden Triggertypen angeben:

Die Pipeline-Definition ermöglicht es Ihnen, verschiedene Filter innerhalb derselben Push-Trigger-Konfiguration zu kombinieren. Einzelheiten zur Pipeline-Definition finden Sie unterLöst die Filterung in der Pipeline aus JSON (CLI). Gültige Kombinationen sind:

Sie geben Filtertypen wie folgt an:

Die folgende Tabelle enthält gültige Filteroptionen für jeden Ereignistyp. Die Tabelle zeigt auch, welche Triggerkonfigurationen für die automatische Erkennung von Änderungen in der Aktionskonfiguration standardmäßig auf „true“ oder „false“ gesetzt sind.

Für die Filterung werden Muster regulärer Ausdrücke im Glob-Format unterstützt, wie unter beschrieben. Arbeiten mit Glob-Mustern in der Syntax

Überlegungen zu Triggerfiltern

Die folgenden Überlegungen gelten für die Verwendung von Triggern.

Beispiele für Triggerfilter

Bei einer Git-Konfiguration mit Filtern für Push- und Pull-Request-Ereignistypen können die angegebenen Filter miteinander in Konflikt geraten. Im Folgenden finden Sie Beispiele für gültige Filterkombinationen für Push- und Pull-Request-Ereignisse.

Sie können Filter in einem einzigen Konfigurationsobjekt kombinieren, und diese Filter verwenden eine AND Operation, was bedeutet, dass nur eine vollständige Übereinstimmung die Pipeline startet. Das folgende Beispiel zeigt eine Git-Konfiguration mit zwei verschiedenen Filtern (filePathsundbranches) innerhalb des „Konfigurationsobjekts“ und nicht mit einem einzigen Filter. Im folgenden Beispiel filePaths wird es wie folgt AND zusammengefaßt: branches

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

Bei der obigen Git-Konfiguration zeigt dieses Beispiel ein Ereignis, das die Pipeline-Ausführung startet, weil der AND Vorgang erfolgreich ist.

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

Dieses Beispiel zeigt ein Ereignis, das die Pipeline-Ausführung nicht startet, weil der Branch filtern kann, der Dateipfad jedoch nicht.

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

Gleichzeitig verwenden Trigger-Konfigurationsobjekte innerhalb des Push-Arrays eine OR-Operation. Auf diese Weise können Sie mehrere Trigger konfigurieren, um die Ausführung für dieselbe Pipeline zu starten. Das folgende Beispiel zeigt eine Git-Konfiguration mit einem einzigen Filter (branches) innerhalb des Konfigurationsobjekts. Die Excludes Operationen Includes und werden mit OR verknüpft, was bedeutet, dass, wenn ein Branch einem Ausschlussmuster entspricht (wie feature-branch im Beispiel), die Pipeline nicht ausgelöst wird, es sei denn, ein Include stimmt ebenfalls überein. Wenn das Include-Muster übereinstimmt, z. B. für den main Branch, wird die Pipeline ausgelöst.

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

Eine Liste der Felddefinitionen in der JSON Struktur finden Sie unterLöst die Filterung in der Pipeline aus JSON (CLI).