Automatisieren Sie das Starten von Pipelines mithilfe von Triggern und Filtern

Für einen einzelnen Filtertyp, z. B. eine Pull-Anfrage, können Sie Filter kombinieren. Diese Filter verwenden eine AND-Operation, was bedeutet, dass nur eine vollständige Übereinstimmung die Pipeline startet. Das folgende Beispiel zeigt eine Git-Konfiguration für einen Push-Ereignistyp mit zwei verschiedenen Filtern (filePathsundbranches). Im folgenden Beispiel filePaths wird AND-verknüpft mit: branches

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

Mit der obigen Git-Konfiguration zeigt dieses Beispiel ein Ereignis, das die Pipeline-Ausführung startet, weil die AND-Operation erfolgreich ist. Mit anderen Worten, der Dateipfad common/app.js ist für den Filter enthalten, der die Pipeline als AND startet, auch wenn der refs/heads/feature/triggers angegebene Zweig keine Auswirkung hatte.

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

Das folgende Beispiel zeigt ein Ereignis für einen Trigger mit der obigen Konfiguration, der die Pipeline-Ausführung nicht startet, da der Zweig filtern kann, der Dateipfad jedoch nicht.

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

Innerhalb eines einzelnen Filters haben Ausschlüsse Vorrang vor Einschlüssen. Das folgende Beispiel zeigt eine Git-Konfiguration mit einem einzigen Filter (branches) innerhalb des Konfigurationsobjekts. Das heißt, wenn ein Branch einem Ausschlussmuster entspricht (feature-branchim Beispiel), wird die Pipeline nicht ausgelöst, auch wenn sie auch einem Include-Muster entspricht. Wenn das Include-Muster übereinstimmt und kein Ausschlussmuster übereinstimmt, z. B. für den main Branch, dann wird die Pipeline ausgelöst.

Für das folgende JSON-Beispiel:

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

Trigger-Konfigurationsobjekte, wie z. B. ein Trigger, der einen Push-Ereignistyp und einen Pull-Request-Ereignistyp enthält, verwenden eine OR-Operation zwischen den beiden Ereignistypen. Das folgende Beispiel zeigt eine Trigger-Konfiguration mit einem Push-Ereignistyp, bei dem der main Branch eingeschlossen ist, und einem Pull-Request-Ereignistyp, bei dem derselbe Branch main ausgeschlossen ist. Darüber hinaus ist beim Push-Ereignistyp ein Dateipfad LICENSE.txt ausgeschlossen und ein Dateipfad README.MD enthalten. Beim zweiten Ereignistyp startet eine Pull-Anfrage, die sich entweder Created auf Closed oder auf dem feature-branch Branch (eingeschlossen) befindet, die Pipeline, und die Pipeline startet nicht, wenn eine Pull-Anfrage in den main Zweigen feature-branch-2 oder geschlossen wird (ausgeschlossen). Innerhalb jedes Ereignistyps haben Ausschlüsse Vorrang vor Einschlüssen. Beispiel: Bei einem Pull-Request-Ereignis im feature-branch Branch (das in der Pull-Anfrage enthalten ist) schließt der Push-Ereignistyp den feature-branch Branch aus, sodass der Push die Pipeline nicht auslöst.

Für das folgende Beispiel

Die folgende Abbildung zeigt die Konfiguration.

Im Folgenden finden Sie ein JSON-Beispiel für die Konfiguration.

"triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "branches": {
                                "includes": [
                                    "main"
                                ],
                                "excludes": [
                                    "feature-branch",
                                    "feature-branch-2"
                                ]
                            },
                            "filePaths": {
                                "includes": [
                                    "README.md"
                                ],
                                "excludes": [
                                    "LICENSE.txt"
                                ]
                            }
                        }
                    ],
                    "pullRequest": [
                        {
                            "events": [
                                "CLOSED",
                                "OPEN"
                            ],
                            "branches": {
                                "includes": [
                                    "feature-branch"
                                ],
                                "excludes": [
                                    "feature-branch-2",
                                    "main"
                                ]
                            }
                        }
                    ]
                }
            }
        ]
    },

Die folgende Abbildung zeigt einen Push-Filtertyp, der angibt, dass nach dem Tag gefiltert werden soll release-1 (im Lieferumfang enthalten). Ein zweiter Push-Filtertyp wird hinzugefügt, der angibt, dass nach dem Zweig gefiltert werden soll main (im Lieferumfang enthalten) und bei einem Push zu den feature* Branches (ausgeschlossen) nicht gestartet werden soll.

Bei folgendem Beispiel:

Das folgende Beispiel für die Bearbeitungsseite zeigt die beiden Push-Filtertypen und ihre Konfiguration für Ein- und Ausschlüsse.

Das BranchName Standardfeld für die Aktionskonfiguration definiert einen einzelnen Zweig, der verwendet wird, wenn die Pipeline manuell gestartet wird, wohingegen Trigger mit Filtern für alle von Ihnen angegebenen Verzweigungen verwendet werden können.

Im Folgenden finden Sie das JSON-Beispiel für die Aktionskonfiguration, in der das BranchName Feld angezeigt wird.

{
                "name": "Source",
                "actions": [
                    {
                        "name": "Source",
                        "actionTypeId": {
                            "category": "Source",
                            "owner": "AWS",
                            "provider": "CodeStarSourceConnection",
                            "version": "1"
                        },
                        "runOrder": 1,
                        "configuration": {
                            "BranchName": "main",
                            "ConnectionArn": "ARN",
                            "DetectChanges": "false",
                            "FullRepositoryId": "owner-name/my-bitbucket-repo",
                            "OutputArtifactFormat": "CODE_ZIP"
                        },
                        "outputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "inputArtifacts": [],
                        "region": "us-west-2",
                        "namespace": "SourceVariables"
                    }
                ],

Das folgende Beispiel für eine Aktionsausgabe zeigt, dass der Standardzweig main verwendet wurde, als die Pipeline manuell gestartet wurde.

Die folgende Beispiel-Aktionsausgabe zeigt die Pull-Anfrage und den Branch, die für den Trigger verwendet wurden, wenn sie nach einer Pull-Anfrage gefiltert wurden.