

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 篩選 GitHub 全域或組織 Webhook 事件 （主控台）
<a name="github-global-organization-webhook-events-console"></a>

透過主控台建立 GitHub 專案時，請選取下列選項，以在專案內建立 GitHub 全域或組織 Webhook。如需全域和組織 GitHub Webhook 的詳細資訊，請參閱 [GitHub 全域和組織 Webhook](github-global-organization-webhook.md)。

1. 在 https：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1. 建立建置專案。如需詳細資訊，請參閱 [建立組建專案 (主控台)](create-project.md#create-project-console) 及 [執行建置 (主控台)](run-build-console.md)。
   +  在 **Source (來源)** 中：
     +  針對**來源提供者**，選擇 **GitHub** 或 **GitHub Enterprise**。
     +  針對**儲存庫**，選擇 **GitHub 範圍 Webhook**。

        GitHub 儲存庫會自動設定為 `CODEBUILD_DEFAULT_WEBHOOK_SOURCE_LOCATION`，這是全域和組織 Webhook 所需的來源位置。
**注意**  
如果您使用的是組織 Webhook，請確定 CodeBuild 具有在 GitHub 中建立組織層級 Webhook 的許可。如果您使用的是[現有的 OAuth 連線](oauth-app-github.md)，您可能需要重新產生連線，才能授予 CodeBuild 此許可。或者，您可以使用 [CodeBuild 手動 Webhook 功能手動建立 Webhook](github-manual-webhook.md)。請注意，如果您有現有的 GitHub OAuth 權杖，並想要新增其他組織許可，您可以[撤銷 OAuth 權杖的許可](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/reviewing-your-authorized-oauth-apps)，並透過 CodeBuild 主控台重新連接權杖。  
![\[GitHub 範圍 Webhook 的組態。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/github-organization-webhook-source.png)
   +  在**主要來源 Webhook 事件**中：
     +  對於**範圍類型**，如果您要建立**組織** Webhook，請選擇組織層級；如果您要建立全域 Webhook，請選擇**企業層級**。
     +  對於**名稱**，輸入企業或組織名稱，取決於 Webhook 是全域還是組織 Webhook。

       如果專案的來源類型為 `GITHUB_ENTERPRISE`，您也需要指定網域做為 Webhook 組織組態的一部分。例如，如果您組織的 URL 為 **https://domain.com/orgs/org-name**，則網域為 **https://domain.com**。
**注意**  
 建立 Webhook 之後，就無法變更此名稱。若要變更名稱，您可以刪除並重新建立 Webhook。如果您想要完全移除 Webhook，也可以將專案來源位置更新為 GitHub 儲存庫。  
![\[全域或組織 Webhook 的組態。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/github-organization-webhook-primary-events.png)
     +  （選用） 在 **Webhook 事件篩選條件群組**中，您可以指定[要觸發新組建的事件](github-webhook.md)。您也可以指定 `REPOSITORY_NAME`做為篩選條件，以僅觸發來自特定儲存庫的 Webhook 事件建置。  
![\[僅觸發來自特定儲存庫之 Webhook 事件建置的篩選條件。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/github-organization-webhook-filter-groups.png)

       您也可以將事件類型設定為 `WORKFLOW_JOB_QUEUED`，以設定自我託管的 GitHub 動作執行器。如需詳細資訊，請參閱[教學課程：設定 CodeBuild 託管的 GitHub 動作執行器](action-runner.md)。

1. 繼續執行預設值，然後選擇**建立建置專案**。