針對環境使用 Git 整合和部署管線

當你在 Fabric 入口中設定環境——新增函式庫、選擇 Spark 執行時、調整計算設定——這些選擇只存在於 Fabric 服務中。 如果有人不小心更改了設定,或你需要在另一個工作區重現環境,就沒有內建的歷史紀錄可以備份。

Git 整合與部署流程解決了這個問題。 透過將工作空間連接到 Git 倉庫,你可以獲得版本歷史、分支和環境設定的程式碼審查,就像處理應用程式程式碼一樣。 部署流程則讓你能跨階段推廣測試環境(例如從開發到測試再到生產),而無需手動重建。

整合 Git for Fabric 環境

Git 整合讓你可以透過 Git 分支備份、版本管理並協作環境設定。 當你將工作區連接到 Git 倉庫時,Fabric 會將環境的函式庫和 Spark 的計算設定(包括 Spark 執行時)序列化成 Git 可以追蹤的檔案。目前 Git 還沒有包含其他環境元件。

你在 Git 中所做的變更會與環境的 暫存 狀態同步——直到發佈後才會生效。 每次 Git 同步後發布,確保即時環境反映你的變更。 如果你偏好以程式碼為先的工作流程,可以透過 Environment Publish API 發佈。

請記住以下考量:

  • 自訂池參考 — 當你將環境從倉庫同步到不同工作區時,附加的自訂池 ID 會被保留 as-is。 由於池定義具有工作區範圍限制,跨工作區的參照無法解析。 將同步檔案中的 instance_pool_id 更新為目標工作區中的現有池,或移除屬性以還原為起始池。 您可以使用 List Workspace 自訂池 API 來列出可用池,或使用 Create Workspace Custom Pool API 建立一個池。
  • 提交大小限制 — 每次提交限制為 150 MB。 超過 150 MB 的自訂函式庫無法透過 Git 提交。

將 Fabric 工作區連接到 Azure DevOps 儲存庫

如果您是工作區的管理員,請移至 工作區設定 並在 原始檔控制 區段中設定連線。 若要深入了解,請參閱<使用 Git 管理工作區>。

連線之後,您可以找到項目,包括與儲存庫同步的環境。

截圖,顯示工作區成功連接到Azure DevOps倉庫。

Git 中本地環境的表示法

在專案根資料夾中,環境會使用 Libraries 資料夾來組織,其中包含 PublicLibraries 和 CustomLibraries 子資料夾,以及 Setting 資料夾。

螢幕擷取畫面,顯示 Git 中環境的本機表示法。

程式庫

當您將環境認可至 Git 時,公用程式庫區段會轉換成其 YAML 表示法。 自訂程式庫也會與其來源檔案一起提交。

在 Git 中的螢幕擷取畫面,顯示環境公共程式庫的本地表示。

可以編輯 YAML 表示法來更新公用程式庫。 就像入口網站體驗一樣,您可以從 PyPI 和 Conda 指定程式庫。 您可以指定具有預期版本、版本範圍或不帶版本的程式庫。 系統可協助您判斷與環境中其他相依性相容的版本。 若要清除所有現有的公用程式庫,請刪除 YAML 檔案。

可以新增檔案或直接刪除現有檔案來更新自訂程式庫。

注意

可以自備 YAML 檔案來管理公用程式庫。 檔案名稱需要 environment.yml ,以便系統能夠正確識別。

Spark 計算

Spark 計算區段也會轉換成 YAML 表示法。 在此 YAML 檔案中,您可以切換連結的集區、微調計算設定、管理 Spark 屬性,以及選取您想要的 Spark 執行階段。

顯示環境在 Git 中的 Spark 本地計算表示法的螢幕擷取畫面。

設置環境的部署流程

Fabric 部署流程簡化了跨階段交付修改內容的流程,例如從開發到測試階段。 自動化流程可以包括環境元素來簡化重建過程。

可以指派具有不同階段的工作區來設定部署管線。 如需詳細資訊,請參閱開始使用 部署管線。

螢幕擷取畫面,顯示在部署管線中部署環境。

你可以在成功設置管線後查詢部署狀態。 選取 [部署] 並選取環境之後,環境的所有內容都會部署至目的地工作區。 在此程式中會保留原始環境的狀態,以便已發佈的組態會保持已發佈狀態,且不需要額外的發佈。

重要

目前,部署管線不支援自訂集區。 如果環境選取自訂集區,則目的地環境中 [計算] 區段的組態會設定為預設值。 在此情況下,即使部署成功完成,環境仍會在部署管線中持續顯示差異。