在原始碼存放區中手動建構程式碼

本頁說明如何建立手動觸發條件,以便在來源存放區中建構程式碼。您可以使用手動觸發條件手動叫用建構作業,並在執行建構作業前,於叫用時間覆寫定義的替換變數值。您也可以設定手動觸發事件,讓系統在��定時間自動執行。

如要瞭解如何使用 gcloud CLI 或 Cloud Build API 手動啟動建構作業,請參閱「手動啟動建構」。

事前準備

  • Enable the Cloud Build API.

    Enable the API

  • 準備好原始碼。

手動觸發條件

手動觸發條件可讓您設定建構作業,這些建構作業只會在您在已連結的存放區中叫用觸發條件時執行。假設您要建立管道,將原始碼部署至測試環境或實際執行環境。您可能想自動化工作流程,但只想手動執行建構作業。您可以定義手動觸發事件來執行這項操作。

您可以透過下列方式,透過手動觸發條件手動叫用建構作業:

  • 從代管的存放區中擷取原始碼,並使用指定的分支版本或標記。
  • 使用替換項目對建構作業進行參數化,這樣每次執行建構作業時,就不必手動傳入替換項目。
  • 在建構程序叫用前,於叫用時覆寫已定義的替換變數值。

如果您想從本機工作目錄執行建構作業,而不是從代管的存放區執行,或是想提交建構作業而不建立觸發事件,可以在工作目錄中執行下列 gcloud 指令:

gcloud builds submit --config BUILD_CONFIG SOURCE_CODE

其中:

  • BUILD_CONFIG 是建構設定檔的路徑。
  • SOURCE_CODE 是路徑或網址原始碼。

如要進一步瞭解如何使用 gcloud 指令,在本機目錄中手動啟動版本,請參閱「手動啟動版本」一文。

建立手動觸發條件

主控台

如要建立手動觸發條件,請按照下列步驟操作:

  1. 開啟「觸發條件」頁面:

    開啟「觸發條件」頁面

  2. 在頁面頂端選取專案,然後按一下「開啟」

  3. 按一下「建立觸發條件」

  4. 輸入下列觸發條件設定:

    • 名稱︰觸發條件的名稱。
    • 區域:選取觸發事件的區域

      • 如果您選取「全球」做為區域,Cloud Build 會使用預設集區執行建構作業。
      • 如果您選取非全球區域,且與觸發事件相關聯的建構設定檔指定了私人集區,Cloud Build 就會使用私人集區執行建構作業。在這種情況下,您在觸發條件中指定的區域必須與建立私人集區的區域相符。
      • 如果您選取非全球地區,且與觸發事件相關聯的建構設定檔「未」指定私人集區,Cloud Build 會使用預設集區,在與觸發事件相同的地區執行建構作業。
    • 說明 (選用):觸發條件��說明。

    • 事件:選取「手動叫用」來設定觸發條件,讓建構作業只在觸發條件手動叫用時執行。

    • 來源:選取手動觸發條件執行時要建構的存放區。您可以將「第 1 代」或「第 2 代」做為來源。

    • 修訂版本:選取手動觸發條件執行時要建構的分支版本或標記。

    • 分支版本:設定觸發條件,在該分支版本發生修訂時啟動建構。您必須指定常值。目前不支援規則運算式。

    • 標記:設定觸發條件,在這個標記上啟動建構。您必須指定文字值。目前不支援規則運算式。

    • 設定:選取位於遠端存放區的建構設定檔,或建立內嵌建構設定檔,以便用於建構。

      • 類型:選取要用於建構作業的設定類型。
        • Cloud Build 設定檔 (yaml 或 json):使用建構設定檔來設定。
        • Dockerfile:使用 Dockerfile 進行設定。
      • Location:指定設定檔的位置。

        • 存放區:如果設定檔位於遠端存放區,請提供建構設定檔Dockerfile 目錄或 buildpacks 目錄的位置。如果建構設定類型為 Dockerfile 或建構包,您需要為產生的映像檔提供名稱,並視需要為建構作業設定逾時時間。提供 Dockerfile 或 Buildpack 映像檔名稱之後,您會看見建構作業將執行的 docker buildpack 指令預覽。
        • 內嵌:如果您選取「Cloud Build 設定檔 (YAML 或 JSON)」做為設定選項,則可內嵌指定建構設定檔。按一下「Open Editor」,即可使用 YAML 或 JSON 語法在 Google Cloud 主控台中編寫建構設定檔。按一下「完成」,儲存建構設定。
  5. 按一下「建立」,即可建立手動觸發條件。

gcloud

如需完整的旗標清單,請參閱 gcloud 參考資料,瞭解如何建立手動觸發事件

執行手動觸發條件

主控台

如要使用 Google Cloud 控制台手動觸發事件,請按照下列步驟操作:

  1. 在 Google Cloud 控制台中開啟「Triggers」頁面。

    開啟觸發條件頁面

  2. 在清單中找出所需觸發條件。

  3. 按一下「執行觸發條件」

    點選「執行觸發條件」後,右側會顯示「執行觸發條件」視窗窗格。如果您指定了分支名稱、標記名稱或替換變數等欄位,就能在叫用時覆寫這些欄位。

    如果您已為替代項目指定新的變數值,請按一下「執行觸發條件」執行建構作業。

    如要依時程執行手動觸發事件,請參閱「建構排程」。

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 是與替換變數相關聯的值。

如要依時程執行手動觸發事件,請參閱「建構排程」。

後續步驟