CI/CD de la biblioteca de variables

Utiliza bibliotecas de variables en Fabric para gestionar configuraciones a lo largo de las etapas del pipeline de lanzamiento y para 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 usar bibliotecas de variables y sus valores en canalizaciones de implementación para administrar los valores de las variables entre 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 una biblioteca de variables se despliega en una etapa vacía, el despliegue crea un espacio de trabajo donde el conjunto de valores predeterminado está activo. Si el entorno destino requiere otro conjunto de valores, abre la biblioteca de variables en el espacio de trabajo de destino, establece el conjunto de valores requerido como activo y guarda la biblioteca de variables antes de ejecutar elementos dependientes o acciones del plan de despliegue.

  

• 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.

Utiliza valores de biblioteca variable en un plan de despliegue

Una acción de plan de despliegue puede usar una referencia de biblioteca de variables en lugar de un valor literal de parámetro. Cuando se ejecuta el despliegue, Fabric resuelve la referencia utilizando el conjunto de valores activos de la biblioteca de variables en el espacio de trabajo objetivo. Esto permite que la misma acción utilice valores específicos de cada etapa de despliegue.

Antes de desplegar, asegúrate de que el espacio de trabajo destino contiene la biblioteca de variables y la variable referenciadas, y que el conjunto de valores correcto está activo. El despliegue no cambia el conjunto de valores activos. Si el despliegue crea el espacio de trabajo de destino, Predeterminado permanece activo hasta que selecciones y guardes otro conjunto de valores.

Para una acción de plan de despliegue, puedes usar una referencia variable como valor de un parámetro. Para más información, véase Pasar parámetros a una acción.

Si Fabric no puede resolver una referencia, informa qué parte de la referencia falló. Para la secuencia de resolución y las correcciones, véase Fallas de resolución de referencia variable.

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.

La selección activa del conjunto de valores es el estado del espacio de trabajo y no se almacena en Git. Cuando la sincronización inicial importa una biblioteca de variables a un nuevo espacio de trabajo, Default está activo. Si el entorno destino requiere otro conjunto de valores, abre la biblioteca de variables importada en el nuevo espacio de trabajo, establece el conjunto de valores requerido como activo y guarda la biblioteca de variables antes de ejecutar elementos dependientes o acciones del plan de despliegue.

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 conjuntos de valores y 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 variables y 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 las variables

• 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 conjunto de valores activos diferente para cada fase de una canalización de despliegue.

Contenido relacionado

• Formato de código fuente de integración de Git
• ¿Qué es un plan de despliegue?
• Acciones del plan de despliegue
• Fallas de resolución de referencia variable