Comparer un contenu à différentes étapes de déploiement

Avant de déployer un contenu vers une étape différente, il peut être utile de voir les différences entre les deux étapes. La page d'accueil du pipeline de déploiement compare les étapes de déploiement consécutives et indique s'il existe des différences entre elles. Utilisez les boutons Comparer et Évaluer les modifications pour afficher le contenu de chaque pipeline et voir exactement quels éléments sont différents et où se trouvent ces différences.

Les pipelines de déploiement associent des éléments de deux étapes voisines en combinant le type et le nom de l’élément, afin de savoir quels éléments comparer et remplacer. Les éléments de même nom et de même type sont associés. S’il existe plusieurs éléments ayant le même nom et le même type dans un espace de travail, ils seront associés si leur chemin d’accès est identique. Si le chemin n’est pas le même, les éléments ne sont pas associés. L’association n’est créé qu’une seule fois, lors du premier déploiement d’une étape vers une autre, ou lors de l’affectation d’un espace de travail. Lors des déploiements suivants, chaque élément déployé remplace les métadonnées de l’élément associé, y compris son nom, s’il a été modifié.

Comparer les étapes

Un indicateur d’icône de comparaison apparaît entre deux étapes séquentielles pour donner un aperçu visuel rapide des différences entre elles. L’indicateur de comparaison a deux états :

• Indicateur vert : Les métadonnées de chaque élément de contenu dans les deux étapes sont identiques.

• Indicateur orange : s’affiche si l’une de ces conditions est vraie :

  • Certains éléments de contenu de chaque phase ont été modifiés ou mis à jour (ont des métadonnées différentes).
  • Il existe une différence dans le nombre d’éléments dans chaque étape.

Lorsque deux étapes séquentielles sont différentes, un lien Comparer apparaît sous l’icône de comparaison orange. Sélectionnez Comparer pour ouvrir la liste des éléments de contenu des deux étapes. Cette Vue de comparaison vous permet de suivre les modifications ou les différences entre les éléments à chaque étape du pipeline.

Dans l’affichage de la comparaison, les éléments associés sont placés les uns à côté des autres, même s’ils portent des noms différents. Tous les éléments de l’espace de travail sont répertoriés dans une liste plate, quelle que soit la structure de leur dossier. Survolez un élément pour voir son chemin d’accès et son nom.

Les éléments qui ne sont pas associés ou qui ont été modifiés portent l’une des étiquettes suivantes :

• Nouveau : Nouvel élément à l’étape source. Cet élément n’existe pas à l’étape cible. Après le déploiement, cet élément sera cloné à l’étape cible.

• Différent : un élément qui existe dans l’étape source et dans l’étape cible, dont une des versions a été modifiée après le dernier déploiement. Après le déploiement, l’élément à l’étape source remplace l’élément à l’étape cible, quel que soit l’endroit où la modification a été apportée.

  Les modèles sémantiques ayant des règles de déploiement configurées et qui n’ont pas été déployés sont également marqués comme différents, car les règles de déploiement ne sont pas appliquées tant que les modèles sémantiques ne sont pas déployés de la phase source vers la phase cible.

• Manquant dans : cet élément apparaît dans l’étape cible, mais pas dans l’étape source. Le déploiement n’affecte pas ces éléments.

Remarque

Si vous modifiez un dossier, par exemple en déplaçant son emplacement ou en le renommant, même si vous n’avez pas modifié les éléments qu’il contient, ceux-ci sont traités comme si vous les aviez renommés. Par conséquent, lorsque vous comparez des pipelines, les éléments sont étiquetés comme étant Différents.

Évaluer les modifications apportées aux éléments associés

Si un élément de texte, comme un modèle sémantique, est différent, pointez dessus pour voir le bouton Révision des modifications.

S’il n’y a rien à comparer, le bouton est désactivé. Si des modifications sont apportées au schéma, vous pouvez sélectionner le bouton pour afficher une comparaison détaillée ligne par ligne des deux éléments.

Lorsque vous sélectionnez le bouton Évaluer les modifications, une fenêtre contextuelle contenant une comparaison ligne par ligne du contenu de l’élément tel qu’il apparaît actuellement dans les deux étapes comparées s’ouvre.

Le haut de l’écran contient les informations suivantes :

1. Nom de l’espace de travail suivi du nom de l’élément tel qu’il apparaît dans l’étape source (à déployer).
2. Nombre total de modifications apportées au fichier à l’étape à modifier (en vert) et à l’étape à déployer (en rouge).
3. Flèches haut et bas qui vous amènent à la différence précédente ou suivante dans le fichier.
4. Barre de navigation sur le côté droit avec des barres rouges ou vertes mettant en surbrillance les modifications dans le fichier.
5. Boutons permettant de basculer entre une vue côte à côte et une vue intraligne des modifications.
6. Fenêtre d’évaluation des modifications avec une comparaison ligne par ligne des éléments.

Vue côte à côte

Vue inline

Comparer les modifications

Dans la vue de comparaison côte à côte des éléments, la zone de code est divisée en deux :

• À gauche se trouve le contenu de l’élément de l’étape cible du déploiement. Cette étape sera modifiée au prochain déploiement. Son contenu sera remplacé.
• À droite se trouve le contenu de l’élément de l’étape source du déploiement. Cette étape sera déployée. Son contenu sera appliqué.
• Les lignes de chaque côté apparaissent dans le même ordre, de sorte que chaque ligne se trouve à côté de son équivalent dans l’étape comparée.

La vue de comparaison intraligne, par opposition à la vue côte à côte, montre chaque ligne de l’étape cible (à modifier) sous son équivalent dans l’étape source (à déployer).

Dans les deux affichages de comparaison, intraligne ou côte à côte, les différences sont mises en surbrillance comme suit :

• Les lignes de contenu de fichier sont numérotées et les lignes modifiées sont marquées comme suit :

  • Les modifications indiquées à l’étape À modifier seront supprimées ou remplacées lors du prochain déploiement. Ils sont mis en surbrillance en rouge avec un signe « - » à côté du nombre.
  • Les modifications indiquées à l’étape À déployer sont les nouvelles valeurs qui seront appliquées lors du prochain déploiement. Ils sont mis en surbrillance en vert avec un signe « + » à côté du nombre.

• Dans les lignes modifiées, les caractères spécifiques qui ont été ajoutés ou supprimés sont mis en surbrillance dans une nuance plus sombre.

Modifications de fichier avant comparaison

Les deux versions du contenu affiché dans la fenêtre d’évaluation des modifications sont modifiées de la manière suivante pour faciliter la comparaison :

• Les règles relatives aux sources de données et aux paramètres sont appliquées à l’élément source de sorte que la source de données que vous voyez est celle qui est déployée.
• Les champs qui n’indiquent pas de différences (par exemple, les horodatages et l’appartenance au rôle) sont supprimés des deux éléments.
• Les tableaux managés par le système, tels que l’agrégat automatique, sont supprimés.
• Les éléments sont triés de sorte que les champs et les tableaux apparaissent dans le même ordre.

Fermez la fenêtre lorsque vous avez terminé d’examiner les différences et passez à l’étape suivante du déploiement lorsque vous êtes prêt.

Considérations et limitations

• La fonctionnalité Évaluer les modifications prend uniquement en charge les modifications de schéma des types d’éléments textuels. Actuellement, il prend en charge les modèles sémantiques, à l’exception de la modélisation des données au format v1, et des flux de données.

• Un élément peut être étiqueté comme Différent, mais ne pas encore faire l’objet d’une évaluation des modifications. Dans ce cas, le bouton Évaluer les modifications est désactivé. Par exemple :

  • Modifications des paramètres, tels que le changement de nom.
  • Le type d’élément n’est pas encore pris en charge.
  • L’élément a un état inconnu, car le processus de comparaison n’est pas terminé.

• Le contenu de la fenêtre d’évaluation des modifications peut être légèrement différent de la version originale, car il a été modifié avant l’exécution de la comparaison.

Contenu connexe

Déployer le contenu à l'étape suivante