Partager via

Bibliothèque de variables CI/CD

Vous pouvez utiliser des bibliothèques de variables Microsoft Fabric pour gérer les configurations entre les étapes du pipeline de mise en production et pour enregistrer des valeurs dans Git. Cet article explique comment utiliser des bibliothèques de variables dans le contexte de la gestion du cycle de vie et de l’intégration continue et de la livraison continue (CI/CD).

Bibliothèques de variables et pipelines de déploiement

Vous pouvez déployer des bibliothèques de variables et leurs valeurs dans des pipelines de déploiement pour gérer les valeurs des variables entre les étapes.

Capture d’écran d’un pipeline de déploiement.

N’oubliez pas ces informations importantes :

  • Tous les jeux de valeurs de la bibliothèque de variables sont disponibles pour toutes les étapes du pipeline de déploiement, mais un seul ensemble est actif dans une phase.

  • La valeur active définie pour chaque étape est sélectionnée indépendamment. Vous pouvez le modifier à tout moment.

  • Lorsque vous déployez ou validez une bibliothèque de variables pour la première fois, l’ensemble actif de la bibliothèque a la valeur par défaut. Vous pouvez modifier cette valeur en accédant à la bibliothèque de variables nouvellement créée à l’étape ou au référentiel cible et en modifiant l’ensemble actif.

    Capture d’écran de la commande pour la modification d’un jeu de valeurs actif de la valeur par défaut à un autre jeu de valeurs dans un pipeline de déploiement.

  • Bien que les déploiements n’affectent pas le jeu de valeurs actives sélectionné à chaque étape, vous pouvez mettre à jour les valeurs elles-mêmes dans la bibliothèque de variables. L’élément consommateur de son espace de travail (par exemple, un pipeline) reçoit automatiquement la valeur correcte du jeu de valeurs actives.

Les opérations suivantes sur des variables ou des jeux de valeurs dans une phase d’un pipeline de déploiement entraînent l’affichage de la bibliothèque de variables en tant que source de formulaire différentepar rapport au même élément d’une étape différente :

  • Ajout, suppression ou modification de variables
  • Jeux de valeurs ajoutés ou supprimés
  • Noms des variables
  • Ordre des variables

Capture d’écran des pipelines de déploiement comparés à la bibliothèque de variables montrant comme différent dans les deux étapes.

Une modification simple du jeu de valeurs actives ne s’inscrit pas en tant que source de formulaire différente lorsque vous comparez. Le jeu de valeurs actives fait partie de la configuration de l’élément, mais il n’est pas inclus dans la définition. C’est pourquoi elle n’apparaît pas dans la comparaison du pipeline de déploiement et n’est pas remplacée sur chaque déploiement.

Bibliothèques de variables et intégration à Git

Comme d’autres éléments Fabric, les bibliothèques de variables peuvent être intégrées à Git pour le contrôle de code source. Les éléments de bibliothèque de variables sont stockés en tant que dossiers que vous pouvez gérer et synchroniser entre Fabric et votre fournisseur Git.

Les autorisations d’élément sont vérifiées pendant la mise à jour et la validation Git.

Le schéma de l’élément de bibliothèque de variables est un objet JSON qui contient quatre parties :

  • Dossier pour les jeux de valeurs
  • Paramètres
  • Platform.json, un fichier généré automatiquement
  • Variables

Capture d’écran d’un dossier Git contenant des fichiers de bibliothèque de variables.

Jeux de valeurs

Le dossier de bibliothèque de variables contient un sous-dossier appelé valueSets. Ce dossier contient un fichier JSON pour chaque ensemble de valeurs. Ce fichier JSON contient uniquement les valeurs de variable pour les valeurs autres que les valeurs par défaut de ce jeu de valeurs.

Pour plus d’informations sur le fichier de jeu de valeurs, consultez l’exemple de jeu de valeurs.

Les valeurs des variables qui ne figurent pas dans ce fichier sont prises dans l’ensemble de valeurs par défaut.

Paramètres

Le settings.json fichier contient les paramètres de la bibliothèque de variables.

Pour plus d’informations, consultez l’exemplesettings.json.

Variables

Le variables.json fichier contient les noms des variables et leurs valeurs par défaut.

Pour plus d’informations, consultez l’exemplevariables.json.

Considérations et limitations

Limites de taille

  • Il peut y avoir jusqu’à 1 000 variables et jusqu’à 1 000 ensembles de valeurs, tant que vous répondez aux deux exigences suivantes :

    • Le nombre total de cellules dans les jeux de valeurs alternatives est inférieur à 10 000.
    • La taille de l’élément ne dépasse pas 1 Mo.

    Ces exigences sont validées lorsque vous enregistrez les modifications.

  • Le champ de note peut contenir jusqu’à 2 048 caractères.

  • Le champ de description de l’ensemble de valeurs peut contenir jusqu’à 2 048 caractères.

Limitations pour les jeux de valeurs alternatifs

  • Les autres jeux de valeurs d’une bibliothèque de variables apparaissent dans l’ordre dans lequel vous les avez ajoutés. Actuellement, vous ne pouvez pas les réorganiser dans l’interface utilisateur. Pour changer l’ordre, modifiez directement le fichier JSON.
  • Le nom de chaque jeu de valeurs doit être unique dans une bibliothèque de variables.
  • Les noms de variables doivent être uniques dans une bibliothèque de variables. Vous pouvez avoir deux variables portant le même nom dans un espace de travail si elles se trouvent dans des éléments différents.
  • Il existe toujours une valeur active (et une seule) définie dans une bibliothèque de variables à la fois. Vous ne pouvez pas supprimer un jeu de valeurs lorsqu’il est actif. Pour le supprimer, configurez d’abord une autre valeur définie pour qu’elle soit active. Vous pouvez avoir un ensemble de valeurs actives différent pour chaque étape d’un pipeline de déploiement.

Contenu connexe

  • Last updated on