Bibliothèque de variables CI/CD

Utilisez des bibliothèques de variables dans Fabric pour gérer les configurations à travers les étapes du pipeline de sortie et pour sauvegarder les 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.

  • Lorsqu’une bibliothèque de variables est déployée à une étape vide, le déploiement crée un espace de travail où l’ensemble de valeurs par défaut est actif. Si l’environnement cible nécessite un autre ensemble de valeurs, ouvrez la bibliothèque de variables dans l’espace de travail cible, définissez l’ensemble de valeurs requis comme actif, et enregistrez la bibliothèque avant d’exécuter des éléments dépendants ou des actions de plan de déploiement.

    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 l’ensemble 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 de pipelines de déploiement comparés, la bibliothèque de variables apparaissant comme différente 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 des pipelines de déploiement et n’est pas remplacée à chaque déploiement.

Utiliser les valeurs de la bibliothèque variable dans un plan de déploiement

Une action de plan de déploiement peut utiliser une référence de bibliothèque de variables au lieu d’une valeur de paramètre littéral. Lorsque le déploiement s’exécute, Fabric résout la référence en utilisant l’ensemble de valeurs actives de la bibliothèque de variables dans l’espace de travail cible. Cela permet à la même action d’utiliser des valeurs spécifiques à chaque étape de déploiement.

Avant de déployer, assurez-vous que l’espace de travail cible contient la bibliothèque de variables référencées et la variable, et que le jeu de valeurs correct est actif. Le déploiement ne modifie pas l’ensemble de valeurs actives. Si le déploiement crée l’espace de travail cible, Default est actif jusqu’à ce que vous sélectionniez et enregistriez un autre ensemble de valeurs.

Pour une action de plan de déploiement, vous pouvez utiliser une référence variable comme valeur d’un paramètre. Pour plus d’informations, voir Passer les paramètres d’une action.

Si Fabric ne parvient pas à résoudre une référence, il indique quelle partie de la référence a échoué. Pour la séquence de résolution et les corrections, voir Défaillances de résolution de référence variable.

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 des éléments sont vérifiées lors de la mise à jour et du commit Git.

La sélection active de l’ensemble de valeurs correspond à l’état de l’espace de travail et n’est pas stockée dans Git. Lorsque la synchronisation initiale importe une bibliothèque de variables dans un nouvel espace de travail, Default est actif. Si l’environnement cible nécessite un autre ensemble de valeurs, ouvrez la bibliothèque de variables importées dans le nouvel espace de travail, définissez l’ensemble de valeurs requis comme actif, et enregistrez la bibliothèque de variables avant d’exécuter des éléments dépendants ou des actions de plan de déploiement.

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

  • Dossier des ensembles 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 les jeux de valeurs et 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 les variables et l’exemple settings.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

Limitations pour les variables

  • 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