您可以使用 Microsoft Fabric 變數程式庫來管理發行管線各個階段的設定,並將值儲存在 Git 中。 本文說明如何在生命週期管理、持續整合和持續傳遞 (CI/CD) 的內容中使用變數程式庫。
變數程式庫和部署管線
您可以在部署管線中部署變數程式庫及其值,以跨階段管理變數值。
請記住以下重要資訊:
變數程式庫中的所有 值集 都可供部署管線的所有階段使用,但階段中只有一組處於作用中狀態。
為每個階段 設定的作用中值 是獨立選取的。 您可以隨時更改它。
當您第一次部署或認可變數程式庫時,程式庫的作用中集具有預設值。 您可以存取目標階段或存放庫中新建立的變數程式庫,並變更作用中集,以變更此值。
雖然部署不會影響每個階段中設定的 選取作用中值 ,但您可以更新變數程式庫中的值本身。 其工作區中的消費者項目(例如管線)會自動從活動值集中接收正確的值。
在部署管線的一個階段中對變數或值集進行下列作業,會導致變數程式庫反映為 與不同階段中的相同專案相比,會反映為不同的表單來源:
- 新增、刪除或編輯的變數
- 新增或刪除的值集
- 變數名稱
- 變數的順序
比較時,對作用中值集的簡單變更不會註冊為 不同的表單來源 。 作用中值集是項目組態的一部分,但未包含在定義中。 這就是為什麼它不會出現在部署管線比較中,也不會在每個部署上覆寫。
變數程式庫和 Git 整合
如同其他 Fabric 專案,變數程式庫可以與 Git 整合以進行原始檔控制。 變數程式庫專案會儲存為資料夾,您可以在 Fabric 與 Git 提供者之間維護和同步處理。
在 Git 更新和認可期間會檢查項目權限。
變數程式庫專案的結構描述是包含四個部分的 JSON 物件:
- 值集的資料夾
- 設定
- Platform.json,自動產生的檔案
- 變數
值集
變數庫資料夾包含名為 的子資料夾 valueSets。 此資料夾會包含每個值集的 JSON 檔案。 此 JSON 檔案僅包含該值集中 非預設 值的變數值。
如需值集檔案的詳細資訊,請參閱 值集範例。
非此檔案中變數的值則會取自預設值集。
設定
檔案包含 settings.json 變數程式庫的設定。
如需詳細資訊,請參閱 settings.json 範例。
變數
檔案 variables.json 包含變數名稱及其預設值。
如需詳細資訊,請參閱 variables.json 範例。
考慮事項與限制條件
大小限制
最多可以有 1,000 個變數 和最多 1,000 個值集,只要您同時滿足以下兩個需求:
- 替代值集中的儲存格總數小於 10,000。
- 項目大小不超過 1 MB。
當您儲存變更時,會驗證這些需求。
備註欄位最多可包含 2,048 個字元。
值集描述欄位最多可包含 2,048 個字元。
替代值集的限制
- 變數庫中的替代值集會依您新增的順序顯示。 目前,您無法在 UI 中重新排列它們。 若要變更順序,請直接編輯 JSON 檔案。
- 每一個值集的名稱在變數程式庫中必須是唯一的。
- 變數名稱在變數程式庫中必須是唯一的。 如果兩個變數位於不同的專案中,則可以在工作區中具有相同的名稱。
- 變數庫中一次總是設定一個(且只有一個)活動值。 您無法刪除值集在作用中狀態時。 若要刪除它,請先將另一個值集設定為作用中。 您可以為部署管線的每個階段設定不同的作用中值。