Le contenu est la partie facile d’une migration. Voici ce qui doit bouger avec lui, ce qui a tendance à casser en silence ensuite, et ce qu’une migration gouvernée vérifie avant que quiconque approuve une exécution.
Mis à jour · 6 min de lecture
Un plan de migration bâti sur une liste de noms de projets est un plan bâti sur une supposition. Avant que quoi que ce soit ne bouge, vous voulez un inventaire de ce qui existe, pris sur le serveur source lui-même, avec un propriétaire en face de chaque élément.
Six sortes de choses peuvent appartenir à une personne sur un site Tableau : les classeurs, les sources de données publiées, les flux, les projets, les abonnements et les tâches de rafraîchissement. Les trois premières sont ce que les gens imaginent quand ils disent contenu. Les trois dernières sont là où les migrations tournent mal, parce qu’elles sont invisibles dans une arborescence de projets et que personne ne remarque leur absence avant un lundi matin.
Enregistrez l’identifiant, pas seulement le nom. Les noms se répètent d’un projet à l’autre, sont renommés en cours de projet, et sont la raison pour laquelle une migration sélective choisit le mauvais classeur. Une sélection par LUID ne peut pas faire cette erreur, et un projet parent devrait être inclus automatiquement quand un enfant est choisi.
Le contenu bouge. Ce qui entoure le contenu doit surtout être présent avant qu’il puisse atterrir.
L’identité est la contrainte d’ordre qui piège les équipes. Le contenu ne peut pas appartenir à quelqu’un qui n’est pas encore là. La séquence n’est pas négociable, même quand le calendrier préférerait autre chose.
Les pannes qui font mal ne sont pas celles qui lèvent une erreur pendant l’exécution. Ce sont celles qui laissent un tableau de bord visiblement présent et discrètement faux.
Chaque élément de cette liste est découvrable avant de migrer, et aucun d’eux n’est découvrable depuis une arborescence de projets. C’est l’argument en faveur de l’étape d’inventaire, et c’est le seul argument qui survit au contact d’une échéance.
Une simulation qui ne valide que les identifiants vous dit que le mot de passe est bon. Une simulation utile résout la sélection puis parcourt ce que l’exécution ferait, élément par élément, pour que le plan que vous approuvez soit le plan qui s’exécute.
L’outil Migrate exécute le Tableau Migration SDK officiel sur .NET 8, dans le même conteneur que le reste de la suite. La migration elle-même emprunte le chemin pris en charge par l’éditeur plutôt qu’une réimplémentation. Une simulation à deux niveaux précède une porte d’approbation stricte à trois conditions imposées.
Lisez la simulation en entier. C’est le dernier moment bon marché du projet.
L’approbation est le moment où une personne nommée prend la responsabilité. Sa trace doit survivre à l’équipe projet. Un audit de conformité se construit à partir de trois entrées simples : le plan, l’état final de l’exécution et les métadonnées d’approbation.
Il est rendu deux fois à partir d’un seul enregistrement. En JSON pour ingestion dans un système de gouvernance, en Markdown pour un relecteur humain ou un dossier d’audit. Un enregistrement, deux rendus. La copie machine et la copie humaine ne peuvent pas se contredire.
Les noms d’identifiants et les valeurs secrètes n’entrent jamais dans cet audit. Les points de terminaison, les noms de sites et les types sont enregistrés. Un test l’impose.
La fin honnête d’une migration est une comparaison, pas une page de statut verte.
La dernière étape est celle qui vaut l’heure passée. Un tableau de bord qui s’affiche n’est pas la même chose qu’un tableau de bord pointé vers la bonne source, et la différence est invisible de face.
La propriété d’abord est l’étape que les gens sautent, parce qu’elle ressemble à un projet à part. C’est aussi l’étape qui transforme une migration de deux semaines en une de quatre quand elle est sautée, et la raison pour laquelle le départ d’un utilisateur et la migration sont la même discipline vue par les deux bouts.
Une personne s’en va. Son nom reste sur des classeurs, des planifications et des abonnements, et plusieurs d’entre eux tombent en panne sans un bruit. Ce qu’elle détient, ce qui casse, et l’ordre qui garde la licence récupérable.
Quatre choses se font appeler gouvernance : la certification, la propriété, le contenu obsolète et le contrôle des changements. Ici, chacune est écrite comme une vérification que vous pouvez lancer, pas comme un objectif que vous pouvez énoncer. Il y est aussi question du seul changement qui passe une revue visuelle et reste faux.
Une affirmation est une phrase. Une preuve est quelque chose qu’une seconde personne peut vérifier sans vous demander. Ce qu’une piste d’audit doit contenir, ce qu’un hachage prouve réellement, et ce qu’il faut exiger de tout outil qui prétend en produire une.