CI/CD de la biblioteca de variables

Puede usar bibliotecas de variables de Microsoft Fabric para administrar configuraciones en las fases de la canalización de versión y guardar valores en Git. En este artículo se explica cómo usar bibliotecas de variables en el contexto de la administración del ciclo de vida, la integración continua y la entrega continua (CI/CD).

Bibliotecas de variables y canalizaciones de implementación

Puede implementar bibliotecas de variables y sus valores en canalizaciones de implementación para administrar valores de variable en fases.

Recuerde esta información importante:

• Todos los conjuntos de valores de la biblioteca de variables están disponibles para todas las fases de la canalización de implementación, pero solo un conjunto está activo en una fase.

• El valor activo establecido para cada fase se selecciona de forma independiente. Puede cambiarlo en cualquier momento.

• Cuando implemente o confirme por primera vez una biblioteca de variables, el conjunto activo de la biblioteca tiene el valor predeterminado. Puede cambiar este valor accediendo a la biblioteca de variables recién creada en la fase de destino o el repositorio y cambiando el conjunto activo.

  

• Aunque las implementaciones no afectan al valor activo seleccionado establecido en cada fase, puede actualizar los propios valores en la biblioteca de variables. El elemento de consumo de su área de trabajo (por ejemplo, una canalización) recibe automáticamente el valor correcto del conjunto activo de valores.

Las siguientes operaciones en variables o conjuntos de valores en una fase de una canalización de implementación hacen que la biblioteca de variables se refleje como origen de formulario diferenteen comparación con el mismo elemento en una fase diferente:

• Variables agregadas, eliminadas o editadas
• Conjuntos de valores agregados o eliminados
• Nombres de variables
• Orden de las variables

Un simple cambio en el conjunto de valores activos no se registra como origen de formulario diferente al comparar. El conjunto de valores activos forma parte de la configuración del elemento, pero no se incluye en la definición. Por eso no aparece en la comparación de canalización de implementación y no se sobrescribe en cada implementación.

Bibliotecas de variables e integración de Git

Al igual que otros elementos de Fabric, las bibliotecas de variables se pueden integrar con Git para el control de código fuente. Los elementos de la biblioteca de variables se almacenan como carpetas que puede mantener y sincronizar entre Fabric y el proveedor de Git.

Los permisos de elemento se comprueban durante la actualización y confirmación de Git.

El esquema del elemento de biblioteca de variables es un objeto JSON que contiene cuatro partes:

• Carpeta para conjuntos de valores
• Configuración
• Platform.json, un archivo generado automáticamente
• variables

Conjuntos de valores

La carpeta de biblioteca de variables contiene una subcarpeta denominada valueSets. Esta carpeta contiene un archivo JSON para cada conjunto de valores. Este archivo JSON contiene solo los valores de variable para los valores no predeterminados de ese conjunto de valores.

Para obtener más información sobre el archivo de conjunto de valores, vea el ejemplo del conjunto de valores.

Los valores de las variables que no están en este archivo se toman del conjunto de valores predeterminado.

Configuración

El settings.json archivo contiene la configuración de la biblioteca de variables.

Para obtener más información, vea el ejemplo desettings.json.

variables

El variables.json archivo contiene los nombres de variable y sus valores predeterminados.

Para obtener más información, vea el ejemplo devariables.json.

Consideraciones y limitaciones

Limitaciones de tamaño

• Puede haber hasta 1000 variables y hasta 1000 conjuntos de valores, siempre y cuando cumpla ambos requisitos:

  • El número total de celdas de los conjuntos de valores alternativos es inferior a 10 000.
  • El tamaño del elemento no supera los 1 MB.

  Estos requisitos se validan al guardar los cambios.

• El campo de nota puede tener hasta 2048 caracteres.

• El campo de descripción de value-set puede tener hasta 2048 caracteres.

Limitaciones para conjuntos de valores alternativos

• Los conjuntos de valores alternativos de una biblioteca de variables aparecen en el orden en que los agregó. Actualmente, no se pueden reordenar en la interfaz de usuario. Para cambiar el orden, edite el archivo JSON directamente.
• El nombre de cada conjunto de valores debe ser único dentro de una biblioteca de variables.
• Los nombres de variable deben ser únicos dentro de una biblioteca de variables. Puede tener dos variables con el mismo nombre en un área de trabajo si están en elementos diferentes.
• Siempre hay un valor activo (y solo uno) establecido en una biblioteca de variables a la vez. No se puede eliminar un conjunto de valores mientras está activo. Para eliminarlo, configure primero otro valor establecido para que esté activo. Puede tener un valor activo diferente establecido para cada fase de una canalización de implementación.

Contenido relacionado

• Formato de código fuente de integración de Git