트리거 및 필터링을 사용하여 시작 파이프라인 자동화

풀 요청과 같은 단일 필터 유형의 경우 필터를 결합할 수 있으며, 이러한 필터는 AND 연산을 사용합니다. 즉, 완전한 일치 시에만 파이프라인이 시작됩니다. 다음 예제는 두 개의 필터(filePaths 및 branches)가 있는 푸시 이벤트 유형에 대한 Git 구성을 보여줍니다. 다음 예제에서는 filePaths가 branches와 함께 AND가 됩니다.

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

위의 Git 구성으로 이 예제에서는 AND 작업이 성공하므로 파이프라인 실행이 시작되는 이벤트를 보여줍니다. 즉, 지정된 브랜치 refs/heads/feature/triggers 에 영향을 미치지 않았더라도, common/app.js라는 파일 경로가 필터에 포함되어 파이프라인을 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"
                    }
                ],

다음 예제 작업 출력은 파이프라인이 수동으로 시작될 때 사용된 기본 브랜치 기본을 보여줍니다.

다음 예제 작업 출력은 풀 요청으로 필터링할 때 트리거에 사용된 풀 요청 및 브랜치를 보여줍니다.