Actions du plan de déploiement (aperçu)

Une action est une exécution d’un élément d’espace de travail qu’un déploiement effectue autour du déploiement d’un autre élément. Les actions permettent à un plan de déploiement d’effectuer des opérations que le déploiement des seules métadonnées des éléments ne permet pas, comme alimenter une table de lakehouse avant le déploiement d’une vue d’entrepôt de données qui la lit.

Une action appartient à un groupe de déploiement, et un groupe déploie exactement un seul élément. Les actions du groupe tournent autour du déploiement de cet objet.

Actions pré-déploiement et post-déploiement

Chaque groupe de déploiement comporte deux ensembles d’actions :

• Les actions de pré-déploiement s’exécutent avant le déploiement de l’objet du groupe.
• Les actions post-déploiement s’exécutent après le déploiement de l’élément du groupe.

Une action de pré-déploiement ne peut pas s’exécuter sur le même élément que celui déployé par son propre groupe, car cet élément n’est pas encore déployé lorsque l’action s’exécute.

Types d’objets que vous pouvez utiliser en action

Les types d’éléments suivants peuvent s’exécuter comme actions de plan de déploiement :

Pour la structure de définition et les propriétés du poste, voir Définition du plan de déploiement.

Chaque action fait tourner l’objet. L’élément définit ce que fait l’action et quels paramètres elle accepte, pas le plan.

Aucun autre type d’objet ne peut être exécuté en tant qu’action. Pour les types d’objets à l’étude mais non pris en charge, voir Considérations et limitations.

Ordonner des actions au sein d’un groupe de déploiement

Des actions en chaîne pour contrôler l’ordre dans lequel ils se déroulent. Lorsque vous chaînez une action à une autre, le déploiement les exécute dans cette séquence, vous pouvez donc ordonner une action qui charge les données avant l’action qui les valide.

Dans l’image précédente, la chaîne du groupe lakehouse s’exécute Refresh_Sales avant Validate_Sales. Le groupe d’entrepôt suivant s’exécute Notify avant de déployer l’entrepôt.

Les règles suivantes s’appliquent :

• Vous pouvez enchaîner une action à d’autres actions dans le même groupe de déploiement. Dans le fichier de plan, une chaîne est une dépendance vis-à-vis du nom d’une autre action.
• Les noms des actions doivent être uniques au sein de leur groupe de déploiement, car une chaîne désigne une action par son nom.
• Une chaîne ne peut pas se replier sur elle-même. Le système rejette un cycle de dépendance lorsque vous sauvegardez le plan.
• Les actions se déroulent une par une. Les actions que vous ne reliez pas entre elles ne se déroulent toujours pas en parallèle.

Une opération de déploiement s’arrête dès la première défaillance, et le système ne revient en arrière sur aucune modification. Pour plus d’informations, voir Si une opération échoue.

Passer les paramètres à une action

Une action peut contenir des paramètres, que le plan transmet à l’élément que l’action exécute. Chaque paramètre a un nom et une valeur, et les noms des paramètres doivent être uniques au sein d’une action.

Une valeur de paramètre est soit une valeur littérale, soit une référence à une variable dans une bibliothèque de variables. Une référence variable permet à un seul plan de fournir des valeurs différentes par environnement, au lieu de coder en dur une valeur correcte dans un seul espace de travail.

Une référence de variable qui ne se résout pas vers un type de variable connue est rejetée lorsque le plan est sauvegardé.

Comme le plan transmet les valeurs à l’article, fournissez les paramètres que l’article attend. Pour les paramètres qu’un article accepte, consultez la documentation de ce type d’article.

Considérations et limites

Limitations générales du plan de déploiement

• Vous ne pouvez pas utiliser un seul plan pour déployer dans plus d’un espace de travail en une seule exécution.
• Vous ne pouvez attacher qu’un seul plan de déploiement à une opération de déploiement.

Limitations pour joindre un plan

• Un plan annexe ne s’applique qu’à l’opération en cours. Vous ne pouvez pas configurer un plan par défaut pour les déploiements futurs ni programmer le plan lui-même. Si un outil de déploiement planifie une opération, l’opération doit joindre le plan à chaque exécution.
• On ne peut pas associer un plan à une opération d’importation d’un seul article.
• La fabric-cicd bibliothèque ne supporte pas les plans de déploiement.

Limitations lors d’un déploiement

• Vous ne pouvez pas déployer des groupes de déploiement indépendants en parallèle.
• Un déploiement raté n’est pas annulé. Les éléments déjà déployés restent dans l’espace de travail cible, et les éléments ultérieurs ne sont pas déployés.

Limitations des actions de plan

• Seules les combinaisons d’objets et de types de tâches prises en charge peuvent s’exécuter en actions pré-déploiement ou post-déploiement. Voir les types d’objets que vous pouvez utiliser en tant qu’action.
• Vous ne pouvez pas utiliser le même élément Dataflow Gen2 dans plus d’une action dans un plan. Sa tâche d’actualisation ne peut pas s’exécuter plus d’une fois simultanément. Le canevas vous avertit donc lorsque vous ajoutez une deuxième occurrence, et cette deuxième occurrence est bloquée lors du déploiement.
• Vous ne pouvez pas renvoyer plus de 512 Ko dans le cadre d’une action de fonction de données d’utilisateur. Une production plus importante est tronquée. L’action réussit néanmoins.
• On ne peut pas mettre une action en attente pour laisser aux services qu’elle alimente le temps de se mettre à jour. Une action se termine lorsque l’action elle-même se termine, de sorte que l’action suivante peut commencer avant que les données produites ne soient interrogables.
• Lorsqu’un plan de déploiement spécifie un ensemble de valeurs actif pour une bibliothèque de variables, cet ensemble de valeurs est appliqué dans l’espace de travail cible lorsque vous utilisez le plan. Vous ne pouvez pas outrepasser cette sélection pendant le déploiement. Pour utiliser un ensemble de valeurs différent, modifiez le plan de déploiement.

Limitations pour la rédaction de plans

• Vous ne pouvez pas ajouter plus d’un élément à un groupe de déploiement.
• La toile ne supporte que la mise en page automatique.

Limites de taille du plan de déploiement

Un plan qui dépasse l’une de ces limites est rejeté au moment de l’enregistrement. Les limites sont appliquées chaque fois qu’un plan est sauvegardé, donc elles s’appliquent au canvas, à l’API REST, à un pull depuis Git, et aux outils externes.

Contenu connexe

• Qu’est-ce qu’un plan de déploiement ?
• Créer un plan de déploiement
• Exemples de plans de déploiement
• Résoudre les problèmes liés aux plans de déploiement
• Comprendre la liaison des dépendances dans le déploiement multi-espaces de travail
• Défaillances de la résolution de référence variable