共用方式為


變數程式庫 CI/CD

您可以使用 Microsoft Fabric 變數程式庫來管理發行管線各個階段的設定,並將值儲存在 Git 中。 本文說明如何在生命週期管理、持續整合和持續傳遞 (CI/CD) 的內容中使用變數程式庫。

變數程式庫和部署管線

您可以在部署管線中部署變數程式庫及其值,以跨階段管理變數值。

部署管線的螢幕擷取畫面。

請記住以下重要資訊:

  • 變數程式庫中的所有 值集 都可供部署管線的所有階段使用,但階段中只有一組處於作用中狀態。

  • 為每個階段 設定的作用中值 是獨立選取的。 您可以隨時更改它。

  • 當您第一次部署或認可變數程式庫時,程式庫的作用中集具有預設值。 您可以存取目標階段或存放庫中新建立的變數程式庫,並變更作用中集,以變更此值。

    將作用中值集從預設值變更為部署管線中替代值集的命令螢幕擷取畫面。

  • 雖然部署不會影響每個階段中設定的 選取作用中值 ,但您可以更新變數程式庫中的值本身。 其工作區中的消費者項目(例如管線)會自動從活動值集中接收正確的值。

在部署管線的一個階段中對變數或值集進行下列作業,會導致變數程式庫反映為 與不同階段中的相同專案相比,會反映為不同的表單來源

  • 新增、刪除或編輯的變數
  • 新增或刪除的值集
  • 變數名稱
  • 變數的順序

比較部署管線的螢幕擷取畫面,變數程式庫在兩個階段中顯示為不同。

比較時,對作用中值集的簡單變更不會註冊為 不同的表單來源 。 作用中值集是項目組態的一部分,但未包含在定義中。 這就是為什麼它不會出現在部署管線比較中,也不會在每個部署上覆寫。

變數程式庫和 Git 整合

如同其他 Fabric 專案,變數程式庫可以與 Git 整合以進行原始檔控制。 變數程式庫專案會儲存為資料夾,您可以在 Fabric 與 Git 提供者之間維護和同步處理。

在 Git 更新和認可期間會檢查項目權限。

變數程式庫專案的結構描述是包含四個部分的 JSON 物件:

  • 值集的資料夾
  • 設定
  • Platform.json,自動產生的檔案
  • 變數

包含可變函式庫檔案的 Git 資料夾的螢幕擷取畫面。

值集

變數庫資料夾包含名為 的子資料夾 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 檔案。
  • 每一個值集的名稱在變數程式庫中必須是唯一的。
  • 變數名稱在變數程式庫中必須是唯一的。 如果兩個變數位於不同的專案中,則可以在工作區中具有相同的名稱。
  • 變數庫中一次總是設定一個(且只有一個)活動值。 您無法刪除值集在作用中狀態時。 若要刪除它,請先將另一個值集設定為作用中。 您可以為部署管線的每個階段設定不同的作用中值。