パイプライン JSON でのトリガーフィルタリング (CLI)

パイプライン JSON を更新して、トリガーのフィルターを追加できます。

を使用してパイプライン AWS CLI を作成または更新するには、 create-pipeline または update-pipeline コマンドを使用します。

次の JSON 構造の例は、 のフィールド定義のリファレンスを提供しますcreate-pipeline。

{
    "pipeline": {
        "name": "MyServicePipeline",
        "triggers": [
            {
                "provider": "Connection",
                "gitConfiguration": {
                    "sourceActionName": "ApplicationSource",
                    "push": [
                        {
                            "filePaths": {
                                "includes": [
                                    "projectA/**",
                                    "common/**/*.js"
                                ],
                                "excludes": [
                                    "**/README.md",
                                    "**/LICENSE",
                                    "**/CONTRIBUTING.md"
                                ]
                            },
                            "branches": {
                                "includes": [
                                    "feature/**",
                                    "release/**"
                                ],
                                "excludes": [
                                    "mainline"
                                ]
                            },
                            "tags": {
                                "includes": [
                                    "release-v0", "release-v1"
                                ],
                                "excludes": [
                                    "release-v2"
                                ]
                            }
                        }
                    ],
                    "pullRequest": [
                        {
                            "events": [
                                "CLOSED"
                            ],
                            "branches": {
                                "includes": [
                                    "feature/**",
                                    "release/**"
                                ],
                                "excludes": [
                                    "mainline"
                                ]
                            },
                            "filePaths": {
                                "includes": [
                                    "projectA/**",
                                    "common/**/*.js"
                                ],
                                "excludes": [
                                    "**/README.md",
                                    "**/LICENSE",
                                    "**/CONTRIBUTING.md"
                                ]
                            }
                        }
                    ]
                }
            }
        ],
        "stages": [
            {
                "name": "Source",
                "actions": [
                    {
                        "name": "ApplicationSource",
                        "configuration": {
                            "BranchName": "mainline",
                            "ConnectionArn": "arn:aws:codestar-connections:eu-central-1:111122223333:connection/fe9ff2e8-ee25-40c9-829e-65f8EXAMPLE",
                            "FullRepositoryId": "monorepo-example",
                            "OutputArtifactFormat": "CODE_ZIP"
                        }
                    }
                ]
            }
        ]
    }
}

JSON 構造のフィールドは次のように定義されます。

• sourceActionName: Git 設定のパイプラインソースアクションの名前。

• push: フィルタリングを使用してイベントをプッシュします。これらのイベントは、異なるプッシュフィルター間の OR オペレーションと、フィルター内の AND オペレーションを使用します。

  • branches: フィルタリングするブランチ。ブランチは、包含と除外の間で AND オペレーションを使用します。

    • includes: 含まれるブランチをフィルタリングするパターン。OR オペレーションの使用が含まれます。

    • excludes: 除外されるブランチをフィルタリングするパターン。OR オペレーションの使用を除外します。

  • filePaths: フィルタリングするファイルパス名。

    • includes: 含まれるファイルパスをフィルタリングするパターン。OR オペレーションの使用が含まれます。

    • excludes: 除外されるファイルパスをフィルタリングするパターン。OR オペレーションの使用を除外します。

  • tags: フィルタリングするタグ名。

    • includes: 含まれるタグをフィルタリングするパターン。OR オペレーションの使用が含まれます。

    • excludes: 除外されるタグをフィルタリングするパターン。OR オペレーションの使用を除外します。

• pullRequest: プルリクエストイベントとプルリクエストフィルターをフィルタリングして、リクエストイベントをプルします。

  • events: 指定されたオープン、更新、またはクローズされたプルリクエストイベントをフィルタリングします。

  • branches: フィルタリングするブランチ。ブランチは、包含と除外の間で AND オペレーションを使用します。

    • includes: 含まれるブランチをフィルタリングするパターン。OR オペレーションの使用が含まれます。

    • excludes: 除外されるブランチをフィルタリングするパターン。OR オペレーションの使用を除外します。

  • filePaths: フィルタリングするファイルパス名。

    • includes: 含まれるファイルパスをフィルタリングするパターン。OR オペレーションの使用が含まれます。

    • excludes: 除外されるファイルパスをフィルタリングするパターン。OR オペレーションの使用を除外します。