使用触发器和筛选功能自动启动管道

对于单一筛选条件类型，例如拉取请求，您可以组合筛选条件，这些筛选条件将使用 AND 运算，这意味着只有完全匹配才会启动管道。下面的示例显示了推送事件类型的 Git 配置，它有两个不同的筛选条件（filePaths 和 branches）。在下面的示例中，filePaths 与 branches 之间是 AND 运算：

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

在上述 Git 配置下，此示例显示了一个事件，该事件会因 AND 运算成功而启动管道执行。换句话说，该筛选条件包含文件路径 common/app.js，即使指定的 refs/heads/feature/triggers 分支没有影响，它也会以 AND 启动管道。

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

以下示例展示了一个具有上述配置的触发器事件，该事件不会启动管道执行，因为分支能够进行筛选，但文件路径无法筛选。

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

触发器筛选条件（例如单个拉取请求事件类型中的分支）在包含和排除之间使用 AND 运算。这样就可以配置多个触发器来启动同一管道的执行。以下示例显示了一个触发器配置，推送事件的配置对象中只有一个筛选条件类型（branches）。Includes 和 Excludes 之间将进行 AND 运算，也就是说，如果分支匹配了排除模式（如示例中的 feature-branch），除非同时匹配了包含模式，否则不会触发管道。如果包含模式匹配（例如 main 分支），那么管道就会被触发。

对于以下示例 JSON：

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

触发器配置对象（例如包含推送事件类型和拉取请求事件类型的触发器）在两种事件类型之间使用 OR 运算。以下示例显示了一种触发器配置，其推送事件类型包含 main 分支，拉取请求事件类型排除了同一 main 分支。此外，推送事件类型排除了一个文件路径 LICENSE.txt 并包含了一个文件路径 README.MD。对于第二种事件类型，feature-branch 分支（包含）上的 Closed 或 Created 拉取请求会启动管道，而在 feature-branch-2 或 main 分支（排除）上创建或关闭拉取请求则不会启动管道。Includes 和 Excludes 将使用 AND 运算，冲突时默认为排除。例如，拉取请求事件发生在 feature-branch 分支（在拉取请求中包含），而推送事件类型排除 feature-branch 分支，因此默认为排除。

对于以下示例：

下图显示配置。

以下是用于配置的 JSON 示例。

"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"
                                ]
                            }
                        }
                    ]
                }
            }
        ]
    },

下图显示了指定对标签 release-1（包含）进行筛选的推送筛选条件类型。添加了第二种推送筛选条件类型，指定在分支 main（包含）上进行筛选，推送到 feature* 分支（排除）不会启动管道。

对于以下示例：

以下“编辑”页面示例显示了两种推送筛选条件类型及其包含和排除的配置。

操作配置默认 BranchName 字段定义了手动启动管道时将使用的单个分支，而带有筛选条件的触发器可用于您指定的任何一个或多个分支。

以下是显示 BranchName 字段的操作配置的示例 JSON。

{
                "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"
                    }
                ],

以下示例操作输出显示了手动启动管道时使用的默认分支 main。

以下示例操作输出显示了按拉取请求筛选时用于触发器的拉取请求和分支。