通过变量库,可以轻松地跨发布管道的不同阶段管理配置,并在 Git 中保存值。 本文介绍如何在生命周期管理和 CI/CD 上下文中使用变量库。
变量库和部署管道
可以在部署管道中部署变量库及其值,以跨不同阶段管理变量值。
以下是要记住的重要信息:
- 变量库中的所有 值集 都可用于部署管道的所有阶段,但阶段中只有一个值集处于活动状态。
- 为每个阶段 设置的活动值 是独立选择的,可以随时更改。
- 默认情况下,首次部署/提交时,变量 librarie 的活动集设置为默认值。 可以通过访问目标阶段/存储库中新建的变量库并更改活动集来更改此设置。
- 虽然每个阶段中 设置的所选活动值 不受部署影响,但值本身可以在变量库中更新。 在其工作空间中的消费项(例如管道)会自动从活动值集中获取正确的值。
在部署管道的某个阶段,以下对变量或值集的操作会导致变量库在与其他阶段相同项目的对比中被反映为不一致。
- 添加了、删除或编辑的变量
- 已添加或已删除的值集
- 变量的名称
- 变量顺序
在比较时,对 活动值集 的简单更改不会被认定为 不同 ,因为活动值集是项配置的一部分,但不包含在其定义中。 这就是为什么它不会显示在部署管道的“比较”中,并且在每次部署时不会被覆盖。
变量库和 Git 集成
与其他 Fabric 项一样,变量库可与 Git 集成,以便进行源代码管理。 变量库项存储为可在 Fabric 与 Git 提供程序之间维护和同步的文件夹。
在 Git 更新和提交期间检查项权限。
变量库项架构是一个 JSON 对象,其中包含四个部分:
- 值集 文件夹
- 设置
- platform.json:自动生成的文件
- 变量
值集
变量库文件夹包含名为 valueSets 的子文件夹。 此文件夹包含每个值集的 JSON 文件。 此 JSON 文件仅包含该值集中 非默认值 的变量值。 (默认值位于 variables.json 文件中。
有关值集文件(包括示例)的详细信息,请参阅 值集示例。
不在此文件中的变量的值取自默认值集。
设置
settings.json 文件包含变量库的设置。
有关示例设置文件,请参阅 settings.json 示例。
变量
variables.json 文件包含变量名及其默认值。
有关变量文件(包括示例)的详细信息,请参阅 variables.json 示例。
注意事项和限制
大小限制
- 最多可以有 1,000 个变量和 1,000 个值集,只要备用值集中的单元格总数小于 10,000 个单元格,项的大小不超过 1 MB。 当用户保存更改时,会对此进行验证。
- 备注字段最多可包含 2,048 个字符。
- 值集描述字段最多可包含 2,048 个字符。
备用值集限制
- 变量库中的备用值集按添加的顺序显示。 目前,无法在 UI 中对它们重新排序。 若要更改顺序,请直接编辑 JSON 文件。
- 每个值集的名称在变量库中必须是唯一的。
- 变量名称在变量库中必须是唯一的。 如果变量位于不同的项中,则可以在同一工作区中具有两个同名变量。
- 变量库中始终只有一个值集处于活动状态。 无法删除活动值集。 若要删除它,请先将另一个值集设置为“活动”。 可以为部署管道的每个阶段设置不同的活跃值集合。