本頁說明如何建立手動觸發條件,以便在來源存放區中建構程式碼。您可以使用手動觸發條件手動叫用建構作業,並在執行建構作業前,於叫用時間覆寫定義的替換變數值。您也可以設定手動觸發事件,讓系統在��定時間自動執行。
如要瞭解如何使用 gcloud CLI 或 Cloud Build API 手動啟動建構作業,請參閱「手動啟動建構」。
事前準備
-
Enable the Cloud Build API.
- 準備好原始碼。
手動觸發條件
手動觸發條件可讓您設定建構作業,這些建構作業只會在您在已連結的存放區中叫用觸發條件時執行。假設您要建立管道,將原始碼部署至測試環境或實際執行環境。您可能想自動化工作流程,但只想手動執行建構作業。您可以定義手動觸發事件來執行這項操作。
您可以透過下列方式,透過手動觸發條件手動叫用建構作業:
- 從代管的存放區中擷取原始碼,並使用指定的分支版本或標記。
- 使用替換項目對建構作業進行參數化,這樣每次執行建構作業時,就不必手動傳入替換項目。
- 在建構程序叫用前,於叫用時覆寫已定義的替換變數值。
如果您想從本機工作目錄執行建構作業,而不是從代管的存放區執行,或是想提交建構作業而不建立觸發事件,可以在工作目錄中執行下列 gcloud
指令:
gcloud builds submit --config BUILD_CONFIG SOURCE_CODE
其中:
- BUILD_CONFIG 是建構設定檔的路徑。
- SOURCE_CODE 是路徑或網址原始碼。
如要進一步瞭解如何使用 gcloud
指令,在本機目錄中手動啟動版本,請參閱「手動啟動版本」一文。
建立手動觸發條件
主控台
如要建立手動觸發條件,請按照下列步驟操作:
開啟「觸發條件」頁面:
在頁面頂端選取專案,然後按一下「開啟」。
按一下「建立觸發條件」。
輸入下列觸發條件設定:
- 名稱︰觸發條件的名稱。
區域:選取觸發事件的區域。
- 如果您選取「全球」做為區域,Cloud Build 會使用預設集區執行建構作業。
- 如果您選取非全球區域,且與觸發事件相關聯的建構設定檔指定了私人集區,Cloud Build 就會使用私人集區執行建構作業。在這種情況下,您在觸發條件中指定的區域必須與建立私人集區的區域相符。
- 如果您選取非全球地區,且與觸發事件相關聯的建構設定檔「未」指定私人集區,Cloud Build 會使用預設集區,在與觸發事件相同的地區執行建構作業。
說明 (選用):觸發條件��說明。
事件:選取「手動叫用」來設定觸發條件,讓建構作業只在觸發條件手動叫用時執行。
來源:選取手動觸發條件執行時要建構的存放區。您可以將「第 1 代」或「第 2 代」做為來源。
修訂版本:選取手動觸發條件執行時要建構的分支版本或標記。
分支版本:設定觸發條件,在該分支版本發生修訂時啟動建構。您必須指定常值。目前不支援規則運算式。
標記:設定觸發條件,在這個標記上啟動建構。您必須指定文字值。目前不支援規則運算式。
設定:選取位於遠端存放區的建構設定檔,或建立內嵌建構設定檔,以便用於建構。
- 類型:選取要用於建構作業的設定類型。
- Cloud Build 設定檔 (yaml 或 json):使用建構設定檔來設定。
- Dockerfile:使用
Dockerfile
進行設定。
Location:指定設定檔的位置。
- 存放區:如果設定檔位於遠端存放區,請提供建構設定檔、
Dockerfile
目錄或 buildpacks 目錄的位置。如果建構設定類型為Dockerfile
或建構包,您需要為產生的映像檔提供名稱,並視需要為建構作業設定逾時時間。提供Dockerfile
或 Buildpack 映像檔名稱之後,您會看見建構作業將執行的docker build
或pack
指令預覽。 - 內嵌:如果您選取「Cloud Build 設定檔 (YAML 或 JSON)」做為設定選項,則可內嵌指定建構設定檔。按一下「Open Editor」,即可使用 YAML 或 JSON 語法在 Google Cloud 主控台中編寫建構設定檔。按一下「完成」,儲存建構設定。
- 存放區:如果設定檔位於遠端存放區,請提供建構設定檔、
- 類型:選取要用於建構作業的設定類型。
按一下「建立」,即可建立手動觸發條件。
gcloud
如需完整的旗標清單,請參閱 gcloud
參考資料,瞭解如何建立手動觸發事件。
執行手動觸發條件
主控台
如要使用 Google Cloud 控制台手動觸發事件,請按照下列步驟操作:
gcloud
如要使用 gcloud
指令列工具執行手動觸發事件,請執行下列指令:
gcloud builds triggers run TRIGGER_NAME \
--region=REGION \
--branch=BRANCH_NAME \
--substitutions=SUBSTITUTION_VAR=SUBSTITUTION_VALUE
其中:
TRIGGER_NAME
是觸發條件的名稱。REGION
是觸發條件的區域。BRANCH_NAME
是分支版本的名稱。您也可以使用--tag
指定標記,或使用--sha
指定修訂版本 ID。- [選用]
SUBSTITUTION_VAR
是替代值的變數名稱。 - [選用]
SUBSTITUTION_VALUE
是與替換變數相關聯的值。
如要依時程執行手動觸發事件,請參閱「建構排程」。