GitHub Webhook イベント - AWS CodeBuild

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

GitHub Webhook イベント

ウェブフックフィルターグループを使用して、ビルドをトリガーする GitHub ウェブフックイベントを指定できます。たとえば、特定のブランチへの変更に対してのみビルドをトリガーするように指定できます。

ビルドをトリガーするウェブフックイベントを指定するには、ウェブフックフィルタグループを 1 つ以上作成できます。任意のフィルターグループが true と評価されると、ビルドがトリガーされます。これは、グループ内のすべてのフィルターが true と評価されたときに発生します。フィルタグループを作成する際、以下を指定します。

イベント

では GitHub、、、PUSH、、PULL_REQUEST_CREATED、、、PULL_REQUEST_UPDATEDPULL_REQUEST_REOPENEDPULL_REQUEST_MERGED、PRERELEASED、および の 1 PULL_REQUEST_CLOSED RELEASEDつ以上のイベントを選択できますWORKFLOW_JOB_QUEUED。ウェブフックのイベントタイプは、ウェブフックペイロードの X-GitHub-Event ヘッダーに含まれています。X-GitHub-Event ヘッダーで、pull_request または push が表示される場合があります。プルリクエストイベントの場合、このタイプはウェブフックイベントペイロードの action フィールドに含まれています。以下の表に示すのは、X-GitHub-Event ヘッダー値とウェブフックのプルリクエストペイロードの action フィールドが、利用可能なイベントタイプにマッピングされる方法を示しています。

X-GitHub-Event ヘッダー値 ウェブフックイベントペイロードの action 値 イベントタイプ
pull_request opened PULL_REQUEST_CREATED
pull_request reopened PULL_REQUEST_REOPENED
pull_request synchronize PULL_REQUEST_UPDATED
pull_request closed、および merged フィールドは true PULL_REQUEST_MERGED
pull_request closed、および merged フィールドは false PULL_REQUEST_CLOSED
push 該当なし PUSH
release リリース RELEASED
release プレリリース済み PRERELEASED
workflow_job queued WORKFLOW_JOB_QUEUED
注記

PULL_REQUEST_REOPENED イベントタイプは、 および GitHub Enterprise Server でのみ使用できます GitHub。RELEASED、PRERELEASED、および WORKFLOW_JOB_QUEUEDイベントタイプは、 GitHub でのみ使用できます。WORKFLOW_JOB_QUEUED の詳細については、「チュートリアル: CodeBuildホストされた GitHubアクションランナーを設定する」をご参照ください。

1 つ以上のオプションフィルタ

フィルタを指定するには、正規表現を使用します。ビルドをトリガーするイベントでは、関連付けられているグループ内のすべてのフィルターが true と評価される必要があります。

ACTOR_ACCOUNT_ID (コンソール内の ACTOR_ID)

ウェブフックイベントは、 GitHub または GitHub Enterprise Server アカウント ID が正規表現パターンと一致するときにビルドをトリガーします。この値は、ウェブフックペイロードの sender オブジェクトの id プロパティで見つかります。

HEAD_REF

ヘッドリファレンスが正規表現パターンと一致すると、ウェブフックイベントによりビルドがトリガーされます (例: refs/heads/branch-name または refs/tags/tag-name)。プッシュイベントの場合、参照名はウェブフックペイロードの ref プロパティで見つかります。プルリクエストイベントの場合、ブランチ名はウェブフックペイロードの head オブジェクトの ref プロパティで見つかります。

BASE_REF

基本参照が正規表現パターンと一致するとウェブフックイベントによってビルドがトリガーされます。(例 refs/heads/branch-name) BASE_REF フィルタは、プルリクエストイベントでのみ使用できます。ブランチ名は、ウェブフックペイロードで base オブジェクトの ref プロパティで見つかります。

FILE_PATH

変更されたファイルのパスが正規表現パターンと一致すると、ビルドがウェブフックイベントでトリガーされます。FILE_PATH フィルターは、 GitHub プッシュリクエストイベントとプルリクエストイベント、および GitHub Enterprise Server プッシュイベントで使用できます。Enterprise Server プルリクエストイベントで GitHubは使用できません。

COMMIT_MESSAGE

HEAD コミットメッセージが正規表現パターンに一致する場合に、Webhook はビルドをトリガーします。COMMIT_MESSAGE フィルターは、 GitHub プッシュリクエストイベントとプルリクエストイベント、および GitHub Enterprise Server プッシュイベントで使用できます。Enterprise Server プルリクエストイベントで GitHubは使用できません。

TAG_NAME

ウェブフックは、リリースのタグ名が正規表現パターンと一致するときにビルドをトリガーします。TAG_NAME フィルターは、 GitHub リリースされたリクエストイベントとプレリリースされたリクエストイベントで使用できます。

RELEASE_NAME

リリース名が正規表現パターンと一致すると、ウェブフックがビルドをトリガーします。RELEASE_NAME フィルターは、 GitHub リリース済みおよびプレリリース済みのリクエストイベントで使用できます。

REPOSITORY_NAME

ウェブフックは、リポジトリ名が正規表現パターンと一致するときにビルドをトリガーします。REPOSITORY_NAME フィルターは、 GitHub グローバルまたは組織のウェブフックでのみ使用できます。

WORKFLOW_NAME

ワークフロー名が正規表現パターンと一致すると、ウェブフックがビルドをトリガーします。WORKFLOW_NAME フィルターは、 GitHub アクションワークフロージョブのキューに入れられたリクエストイベントで使用できます。

注記

ウェブフックペイロードは、 GitHub リポジトリのウェブフック設定にあります。

トピック