建立及管理部署作業

您可以透過部署作業,排定執行儲存於遠端 Git 存放區的程式碼 (例如管道)。您可以選擇程式碼所在的目錄,並執行下列動作:

  • 建立及管理連結至遠端存放區的部署項目。
  • 設定觸發條件,從遠端存放區提取程式碼,並定期執行程式碼。
  • 依時間表或使用其他觸發條件執行管道。
  • 直接在 Google Cloud 控制台中查看執行作業的記錄。如要設定快訊,Dataform 部署作業會與 Cloud Logging 和 Cloud Monitoring 整合。

限制

  • 部署作業沒有內建快訊功能。您必須使用記錄和監控功能設定快訊。
  • 使用 Developer Connect 進行驗證時,僅支援連線,不支援帳戶連接器。

事前準備

建立部署作業前,請先完成下列工作:

必要的角色

如要取得完成本文工作所需的權限,請要求管理員授予您下列 IAM 角色:

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

如要使用自訂服務帳戶執行部署作業,您也必須將 BigQuery 資料編輯者角色 (roles/bigquery.dataEditor) 授予自訂服務帳戶。

建立 Deployment

如要建立 Dataform 部署作業,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。

    前往「管道與連線」

  2. 依序點選「建立」>「建立部署作業」

  3. 選取存放區驗證類型,然後選取下列其中一個選項:

    Developer Connect

    1. 選取存放區和分支版本。
    2. 輸入程式碼所在目錄的路徑。
    3. 輸入部署項目的名稱。
    4. 選取部署作業的區域。
    5. 在「排程頻率」部分,執行下列操作:

      1. 在「Repeats」(重複時間間隔) 選單中,選取排定管道執行的頻率。
      2. 在「At time」(時間) 欄位中,輸入排定管道執行的時間。
      3. 在「時區」選單中,選取時間表的時區。

      或者,選取「隨選」,即可視需要執行部署作業。

    6. 選用:輸入 Google Cloud 專案 ID。

    7. 選用:輸入結構定義後置字元

    8. 選用:輸入表格前置字元

    9. 選用:輸入預設結構定義

    10. 選用:輸入編譯變數

    11. 點選「Deploy」(部署)

    HTTPS

    1. 輸入遠端 Git 存放區的網址。
    2. 選取分支版本。
    3. 輸入程式碼所在目錄的路徑。
    4. 輸入含有 HTTPS 遠端連線個人存取權杖的密鑰。詳情請參閱「透過 HTTPS 連線至遠端存放區」。
    5. 輸入部署項目的名稱。
    6. 選取部署作業的區域。
    7. 在「排程頻率」部分,執行下列操作:

      1. 在「Repeats」(重複時間間隔) 選單中,選取排定管道執行的頻率。
      2. 在「At time」(時間) 欄位中,輸入排定管道執行的時間。
      3. 在「時區」選單中,選取時間表的時區。

      或者,選取「隨選」,即可視需要執行部署作業。

    8. 選用:輸入 Google Cloud 專案 ID。

    9. 選用:輸入結構定義後置字元

    10. 選用:輸入表格前置字元

    11. 選用:輸入預設結構定義

    12. 選用:輸入編譯變數

    13. 點選「Deploy」(部署)

    SSH

    1. 輸入遠端 Git 存放區的網址。
    2. 選取分支版本。
    3. 輸入程式碼所在目錄的路徑。
    4. 輸入包含使用者私密金鑰和 SSH 公開主機金鑰值的密碼。詳情請參閱「透過 SSH 連線至遠端存放區」。
    5. 輸入部署項目的名稱。
    6. 選取部署作業的區域。
    7. 在「排程頻率」部分,執行下列操作:

      1. 在「Repeats」(重複時間間隔) 選單中,選取排定管道執行的頻率。
      2. 在「At time」(時間) 欄位中,輸入排定管道執行的時間。
      3. 在「時區」選單中,選取時間表的時區。

      或者,選取「隨選」,即可視需要執行部署作業。

    8. 選用:輸入 Google Cloud 專案 ID。

    9. 選用:輸入結構定義後置字元

    10. 選用:輸入表格前置字元

    11. 選用:輸入預設結構定義

    12. 選用:輸入編譯變數

    13. 點選「Deploy」(部署)

列出部署作業

如要列出已建立的 Deployment,請執行下列步驟:

  1. 前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。

    前往「管道與連線」

  2. 查看部署作業清單。

建立部署時間表

如要為部署作業建立排程,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。

    前往「管道與連線」

  2. 按一下「部署」分頁標籤,然後選取部署作業。

  3. 在「部署詳細資料」頁面的「觸發條件 (工作流程設定)」部分,按一下「建立」

  4. 在「建立工作流程設定」窗格中,按照步驟建立工作流程設定

執行部署排程

如要執行部署作業的時間表,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。

    前往「管道與連線」

  2. 按一下「部署」分頁標籤,然後選取部署作業。

  3. 在「Triggers (workflow configurations)」(觸發條件 (工作流程設定)) 區段中,按一下要執行的部署時間表旁的 「View actions」(查看動作)>「Run now」(立即執行)

刪除部署排程

如要刪除部署作業的時間表,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。

    前往「管道與連線」

  2. 按一下「部署」分頁標籤,然後選取部署作業。

  3. 在「Deployment details」(部署作業詳細資料) 頁面的「Triggers (workflow configurations)」(觸發條件 (工作流程設定)) 部分,找到要刪除的部署作業排程,然後依序點選旁邊的 「View actions」(查看動作)>「Delete」(刪除)。

設定警告

如要在工作流程執行失敗時收到通知,請設定工作流程叫用失敗的快訊

後續步驟