变量库 CI/CD

可以使用 Microsoft Fabric 变量库跨发布管道的各个阶段管理配置,并在 Git 中保存值。 本文介绍如何在生命周期管理和持续集成和持续交付(CI/CD)的上下文中使用变量库。

变量库和部署管道

可以在部署管道中部署变量库及其值,以跨阶段管理变量值。

部署管道的屏幕截图。

请记住以下重要信息:

  • 变量库中的所有 值集 都可用于部署管道的所有阶段,但阶段中只有一个集处于活动状态。

  • 为每个阶段 设置的活动值 是独立选择的。 你可以随时更改它。

  • 首次部署或提交变量库时,库的活动集具有默认值。 可以通过访问目标阶段或存储库中新建的变量库并更改活动集来更改此值。

    用于将活动值集从默认值更改为部署管道中设置的备用值的命令的屏幕截图。

  • 尽管部署不会影响每个阶段中 设置的所选活动值 ,但可以在变量库中更新值本身。 在其工作空间中的消费项(例如管道)会自动从活动值集中获取正确的值。

在部署管道的一个阶段中对变量或值集的以下作会导致变量库反映为不同窗体源这与不同阶段中的同一项相比:

  • 添加了、删除或编辑的变量
  • 添加或删除的值集
  • 变量的名称
  • 变量顺序

比较部署管道的屏幕截图,其中变量库在两个阶段中显示为不同。

比较时,对活动值集的简单更改不会注册为 不同的表单源 。 活动值集是项配置的一部分,但它不包括在定义中。 这就是为什么它不会显示在部署管道比较中,并且不会覆盖每个部署。

变量库和 Git 集成

与其他 Fabric 项一样,变量库可与 Git 集成进行源代码管理。 变量库项存储为可以在 Fabric 与 Git 提供程序之间维护和同步的文件夹。

在 Git 更新和提交期间检查项权限。

变量库项的架构是一个 JSON 对象,其中包含四个部分:

  • 值集的文件夹
  • 设置
  • Platform.json,自动生成的文件
  • 变量

Git 文件夹的屏幕截图,其中包含变量库文件。

值集

变量库文件夹包含名为 <a0/> 的子文件夹。 此文件夹包含每个值集的 JSON 文件。 此 JSON 文件仅包含该值集中 非默认值 的变量值。

有关值集文件的详细信息,请参阅 值集示例

不在此文件中的变量的值取自默认值集。

设置

该文件 settings.json 包含变量库的设置。

有关详细信息,请参阅 settings.json 示例

变量

该文件 variables.json 包含变量名及其默认值。

有关详细信息,请参阅 variables.json 示例

注意事项和限制

大小限制

  • 只要满足这两项要求,最多可以有 1,000 个变量最多 1,000 个值集

    • 备用值集中的单元格总数小于 10,000。
    • 项的大小不超过 1 MB。

    保存更改时会验证这些要求。

  • 备注字段最多可包含 2,048 个字符。

  • 值集描述字段最多可包含 2,048 个字符。

替代值集的限制

  • 变量库中的替代值集以添加变量库的顺序显示。 目前,无法在 UI 中对它们重新排序。 若要更改顺序,请直接编辑 JSON 文件。
  • 每个值集的名称在变量库中必须是唯一的。
  • 变量名称在变量库中必须唯一。 如果变量位于不同的项中,则可以在工作区中具有同名的两个变量。
  • 一次变量库中始终设置一个(且只有一个)活动值。 在活动时,无法删除设置的值。 若要删除它,请先配置设置为活动的另一个值。 可以为部署管道的每个阶段设置不同的活动值。