Cloud Build 會使用自動建構觸發條件,啟用 CI/CD 自動化功能。您可以設定觸發條件來監聽傳入事件,例如將新的修訂版本推送至存放區,或啟動提取要求時,然後在有新事件傳入時自動執行建構作業。您也可以設定觸發條件,在原始碼存放區發生任何變更時,或只有在變更符合特定條件時建構程式碼。
本頁面提供各個觸發條件類型的總覽,以及與觸發條件相關聯的功能。
存放區事件觸發條件
Cloud Build 可讓您在存放區事件 (例如推送或提取要求) 發生時自動執行建構作業。您可以將外部存放區 (例如 GitHub 或 Bitbucket 中的存放區) 連結至 Cloud Build,或使用 Cloud Source Repositories 中的程式碼進行建構。雖然您可以將任何來源存放區連結至 Cloud Build,但 Cloud Build 提供特定的存放區事件觸發條件,可用於整合特定的原始碼管理系統 (SCM)。本節將說明可用的存放區事件觸發條件。
GitHub 觸發條件
您可以建立 GitHub 觸發條件,在發生推送或提取要求等存放區事件時,自動執行建構作業。您可以在 GitHub 和 Google Cloud 控制台查看觸發條件的建構狀態。您也可以使用 Cloud Build GitHub 應用程式,在 GitHub 中連結及建構程式碼。詳情請參閱「透過 GitHub 建構存放區」。
GitHub Enterprise 觸發條件
您可以為託管於 GitHub Enterprise 執行個體的存放區建立觸發條件,包括託管於地端部署環境且無法透過公開網際網路連線存取的執行個體。GitHub Enterprise 觸發條件可用於執行建構作業,以回應 GitHub Enterprise 執行個體的推送或提取要求。詳情請參閱「透過 GitHub Enterprise 建構存放區」。
GitLab Enterprise Edition 觸發條件
您可以為託管在 GitLab Enterprise Edition 執行個體 (包括託管在私人網路中的執行個體) 的存放區建立觸發條件。GitLab Enterprise Edition 觸發條件可用於執行建構作業,以回應與 GitLab Enterprise Edition 存放區相關聯的修訂版本推送或提取要求。詳情請參閱「從 GitLab Enterprise Edition 建構存放區」。
Bitbucket Server 觸發條件
您可以為託管於 Bitbucket Server 執行個體 (包括託管於地端部署環境的執行個體) 的存放區建立觸發條件。您可以使用多個主機連線,將 Bitbucket Server 存放區多次連結至 Cloud Build。如要進一步瞭解如何建立觸發條件,以便在事件發生時執行建構作業,請參閱「透過 Bitbucket Server 建構存放區」。
Bitbucket 資料中心觸發條件
您可以為託管於 Bitbucket 資料中心執行個體的存放區建立觸發條件,包括託管於地端部署環境的執行個體。Bitbucket 資料中心觸發條件可用於執行建構作業,以回應提交推送或提取要求等事件。詳情請參閱「從 Bitbucket 資料中心 建構存放區」。
Bitbucket Cloud 觸發條件
您可以為託管在 Bitbucket Cloud 的存放區建立觸發條件。Bitbucket Cloud 觸發條件可用於執行建構作業,以回應修訂版本推送或提取要求等事件。詳情請參閱「從 Bitbucket Cloud 建構存放區」。
Secure Source Manager 觸發條件
您可以為託管於 Secure Source Manager 的存放區建立觸發條件。Secure Source Manager 觸發條件可用於執行建構作業,以回應修訂版本推送或提取要求等事件。詳情請參閱「在 Secure Source Manager 中建立觸發條件檔案」。
手動觸發條件
您可以建立手動觸發條件,手動執行建構作業,並在叫用時覆寫定義的替代變數值,然後再執行建構作業。您也可以設定手動觸發條件,按照排程執行。詳情請參閱「手動建構原始碼存放區中的程式碼」。
Pub/Sub 觸發條件
您可以建立 Pub/Sub 觸發條件,在 Pub/Sub 發布任何訊息時執行建構作業。舉例來說,您可以使用 Pub/Sub 觸發條件,在映像檔推送至 Artifact Registry 時建構。在這種情況下,您可以設定觸發條件,使用篩選器,只在推送的映像檔與特定標記 (例如 prod) 相符時,才執行建構作業。此外,Pub/Sub 觸發條件可設為訂閱任何 Pub/Sub 主題。詳情請參閱「自動建構以回應 Pub/Sub 事件」。
Webhook 觸發條件
您可以建立 Webhook 觸發條件,在收到 Webhook 時執行建構作業。傳送至自訂網址的 Webhook 事件可讓您將外部系統和外部原始碼管理系統 (SCM),例如 Bitbucket.com、Bitbucket Server 或 GitLab,直接連結至 Cloud Build。建立 Webhook 觸發條件時,您也可以在觸發條件中定義建構設定,控制觸發條件在建構期間複製的存放區,而不必明確指定來源。詳情請參閱「自動建構以回應 Webhook 事件」。此外,如要瞭解如何使用 Webhook 觸發條件,從特定 SCM 建構存放區,請參閱「從 Bitbucket Server 建構存放區」、「從 Bitbucket Cloud 建構存放區」和「從 GitLab 建構存放區」。
Developer Connect 連結存放區的觸發條件
Developer Connect 可讓您使用標準化步驟和應用程式,將外部產品或非 Google 開發人員工具連結至 Google Cloud 。您可以設定觸發條件,從透過 Developer Connect 連結的存放區建構下列 SCM:
- Bitbucket Cloud
- Bitbucket Data Center
- Bitbucket Server
- GitHub
- GitHub Enterprise
- GitLab
- GitLab Enterprise Edition
觸發功能
Cloud Build 觸發條件提供多項功能,可讓您精細控管建構作業的執行方式。本節將討論與觸發條件相關的各種功能。
排定手動觸發條件
您可以排定手動觸發條件,按照預先定義的時間表自動執行建構作業。舉例來說,您可以設定排定的觸發條件,在每週六上午 6:00 執行建構作業。如要排定建構作業,您可以建立手動觸發條件,並使用 Cloud Scheduler 叫用觸發條件。詳情請參閱「排定建構作業」。
篩選事件
Cloud Build 會使用一般運算語言 (CEL) 和變數 build,在建構資源中列出的欄位上,存取與建構事件相關聯的欄位,例如觸發條件 ID、映像檔清單或替代值。您可以使用 filter 字串,透過建構資源中列出的任何欄位,篩選建構設定檔中的建構事件。詳情請參閱「使用 CEL 篩選建構事件」。
替代變數
您可以在建構設定檔中指定替換變數,在建構時替換特定值。舉例來說,如果某個值在建構時才會得知,或者您想重複使用現有的建構要求,但使用不同的變數,則可能需要使用替代變數。Cloud Build 提供預設替代項目,可用於觸發條件叫用的建構作業,例如對應至觸發條件名稱或存放區名稱的變數。您也可以定義自己的替代變數。詳情請參閱「替換變數值」。
Bash 參數擴展
您可以將 bash 參數擴充套用至替代變數值。Bash 參數擴充功能可讓您操控與現有變數相關聯的字串。舉例來說,您可以使用 bash 參數擴展功能,將字母大寫或取代子字串。詳情請參閱「Bash 參數擴充」。
酬載繫結
您可以使用酬載繫結,將部分觸發條件的事件酬載儲存為替代變數。與酬載相關聯的變數稱為繫結,可用於推送和提取事件叫用的建構作業。您可以使用繫結存取與建構作業相關的其他資料,例如提取要求的作者。詳情請參閱「酬載繫結」。
核准
您可以設定觸發條件,不立即執行建構作業,而是將建構作業標示為待處理,直到獲得核准。如果具備權限的使用者核准待處理的建構作業,建構作業就會開始。如果遭到拒絕,建構作業就不會啟動。如要瞭解如何設定需要核准的觸發條件,請參閱「在核准時限制建構作業」。
建構狀態通知
您可以設定 Cloud Build 通知工具,在預設 cloud-builds 主題或使用者定義的主題上,監聽 Pub/Sub 的建構事件更新。通知器也可以篩選主題收到的訊息,並將訊息傳送至連結的服務。Cloud Build 會在 cloud-build-notifiers 存放區中提供及維護可部署的通知器映像檔。您可以使用 Cloud Build 通知器設定通知,例如 BigQuery、HTTP、Slack 或 SMTP,也可以建立自己的通知器。
自動建構觸發條件的服務帳戶
觸發條件叫用建構作業時,Cloud Build 會使用服務帳戶執行建構步驟。視觸發條件設定和專案的組織政策設定而定,由觸發條件叫用的建構作業可以使用下列其中一個服務帳戶:
- 使用者指定的服務帳戶 (
ACCOUNT_NAME@PROJECT_ID.):建議使用。您可以建立及管理這個服務帳戶,並僅授予觸發條件建構作業所需的 Identity and Access Management (IAM) 權限。 - Compute Engine 預設服務帳戶 (
PROJECT_NUMBER-compute@):如果專案在預設服務帳戶變更後才執行首次建構作業,則會使用這個預設建構服務帳戶,除非受到組織政策限制。在這些專案中,建立或更新觸發條件時,必須明確選取服務帳戶 (使用者指定的服務帳戶或 Compute Engine 預設服務帳戶)。 - 舊版 Cloud Build 服務帳戶 (
PROJECT_NUMBER@cloudbuild.):在預設服務帳戶變更前執行建構作業的專案,或選擇不採用變更的組織,會使用這個帳戶做為預設建構服務帳戶。在這些專案中,如果觸發條件的serviceAccount欄位留空,觸發條件預設會使用舊版 Cloud Build 服務帳戶。
為觸發條件的建構步驟授予 IAM 角色前,請先確認觸發條件設定的服務帳戶。如需操作說明,請參閱「找出要設定的服務帳戶」。
後續步驟
- 瞭解如何建立及管理自動建構觸發條件。
- 瞭解如何設定使用者指定的服務帳戶。