您可以透過部署作業,排定執行儲存於遠端 Git 存放區的程式碼 (例如管道)。您可以選擇程式碼所在的目錄,並執行下列動作:
- 建立及管理連結至遠端存放區的部署項目。
- 設定觸發條件,從遠端存放區提取程式碼,並定期執行程式碼。
- 依時間表或使用其他觸發條件執行管道。
- 直接在 Google Cloud 控制台中查看執行作業的記錄。如要設定快訊,Dataform 部署作業會與 Cloud Logging 和 Cloud Monitoring 整合。
限制
- 部署作業沒有內建快訊功能。您必須使用記錄和監控功能設定快訊。
- 使用 Developer Connect 進行驗證時,僅支援連線,不支援帳戶連接器。
事前準備
建立部署作業前,請先完成下列工作:
- 在 Google Cloud 控制台中選擇使用「管道與連線」頁面。
啟用 BigQuery API、Dataform API 和 Developer Connect API:
必要的角色
如要取得完成本文工作所需的權限,請要求管理員授予您下列 IAM 角色:
- 專案的 Dataform 管理員 (
roles/dataform.admin) - 專案的 BigQuery 工作使用者 (
roles/bigquery.jobUser) - 專案的「Developer Connect 檢視者」 (
roles/developerconnect.viewer) -
使用自訂服務帳戶執行部署作業:
自訂服務帳戶的服務帳戶使用者 (
roles/iam.serviceAccountUser)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
如要使用自訂服務帳戶執行部署作業,您也必須將 BigQuery 資料編輯者角色 (roles/bigquery.dataEditor) 授予自訂服務帳戶。
建立 Deployment
如要建立 Dataform 部署作業,請按照下列步驟操作:
前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。
依序點選「建立」>「建立部署作業」。
選取存放區驗證類型,然後選取下列其中一個選項:
Developer Connect
HTTPS
- 輸入遠端 Git 存放區的網址。
- 選取分支版本。
- 輸入程式碼所在目錄的路徑。
- 輸入含有 HTTPS 遠端連線個人存取權杖的密鑰。詳情請參閱「透過 HTTPS 連線至遠端存放區」。
- 輸入部署項目的名稱。
- 選取部署作業的區域。
在「排程頻率」部分,執行下列操作:
- 在「Repeats」(重複時間間隔) 選單中,選取排定管道執行的頻率。
- 在「At time」(時間) 欄位中,輸入排定管道執行的時間。
- 在「時區」選單中,選取時間表的時區。
或者,選取「隨選」,即可視需要執行部署作業。
選用:輸入 Google Cloud 專案 ID。
選用:輸入結構定義後置字元。
選用:輸入表格前置字元。
選用:輸入預設結構定義。
選用:輸入編譯變數。
點選「Deploy」(部署)。
SSH
- 輸入遠端 Git 存放區的網址。
- 選取分支版本。
- 輸入程式碼所在目錄的路徑。
- 輸入包含使用者私密金鑰和 SSH 公開主機金鑰值的密碼。詳情請參閱「透過 SSH 連線至遠端存放區」。
- 輸入部署項目的名稱。
- 選取部署作業的區域。
在「排程頻率」部分,執行下列操作:
- 在「Repeats」(重複時間間隔) 選單中,選取排定管道執行的頻率。
- 在「At time」(時間) 欄位中,輸入排定管道執行的時間。
- 在「時區」選單中,選取時間表的時區。
或者,選取「隨選」,即可視需要執行部署作業。
選用:輸入 Google Cloud 專案 ID。
選用:輸入結構定義後置字元。
選用:輸入表格前置字元。
選用:輸入預設結構定義。
選用:輸入編譯變數。
點選「Deploy」(部署)。
列出部署作業
如要列出已建立的 Deployment,請執行下列步驟:
前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。
查看部署作業清單。
建立部署時間表
如要為部署作業建立排程,請按照下列步驟操作:
前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。
按一下「部署」分頁標籤,然後選取部署作業。
在「部署詳細資料」頁面的「觸發條件 (工作流程設定)」部分,按一下「建立」。
在「建立工作流程設定」窗格中,按照步驟建立工作流程設定。
執行部署排程
如要執行部署作業的時間表,請按照下列步驟操作:
前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。
按一下「部署」分頁標籤,然後選取部署作業。
在「Triggers (workflow configurations)」(觸發條件 (工作流程設定)) 區段中,按一下要執行的部署時間表旁的 「View actions」(查看動作)>「Run now」(立即執行)。
刪除部署排程
如要刪除部署作業的時間表,請按照下列步驟操作:
前往 Google Cloud 控制台的「Pipelines & Connections」(管線和連線) 頁面。
按一下「部署」分頁標籤,然後選取部署作業。
在「Deployment details」(部署作業詳細資料) 頁面的「Triggers (workflow configurations)」(觸發條件 (工作流程設定)) 部分,找到要刪除的部署作業排程,然後依序點選旁邊的 「View actions」(查看動作)>「Delete」(刪除)。
設定警告
如要在工作流程執行失敗時收到通知,請設定工作流程叫用失敗的快訊。