Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un plan de déploiement Microsoft Fabric est un élément d’espace de travail qui ajoute un ordre explicite des éléments et des actions automatisées à une opération de déploiement. Utilisez un plan pour déployer les objets dans un ordre précis. Vous pouvez aussi l’utiliser pour exécuter un notebook, un pipeline de données ou un autre élément supporté avant ou après le déploiement d’un item.
Un plan de déploiement fonctionne avec ces outils de déploiement :
- Intégration de Git
- Pipelines de déploiement
- API REST prises en charge
Dans cet article, outil de déploiement fait référence à l’un de ces outils pris en charge. On ne fait pas un plan seul. Vous le connectez au démarrage d’une opération avec un outil de déploiement.
Important
Cette fonctionnalité est en version préliminaire.
Quand utiliser un plan de déploiement
Utilisez un plan de déploiement lorsque :
| Scénario | Comment un plan aide |
|---|---|
| Les objets doivent être déployés dans un ordre que la lignée Fabric ne représente pas. | Le plan définit des dépendances explicites entre les groupes de déploiement. |
| La tâche doit s’exécuter avant ou après le déploiement d’un élément. | Le plan présente les éléments supportés en tant qu’actions pré-déploiement ou post-déploiement. |
| L’opération nécessite à la fois des dépendances d’ordre explicites et des dépendances entre éléments Fabric. | Fabric combine le plan avec la lignée lorsqu’il détermine l’ordre des articles. |
Vous n’avez pas besoin de plan de déploiement lorsque l’ordre standard de l’outil de déploiement est suffisant et qu’aucune action n’est requise.
Composantes du plan de déploiement
Un plan de déploiement contient les éléments suivants :
| Composant | Purpose |
|---|---|
| Groupe de déploiement | Un point à déployer et ses actions avant ou après le déploiement. |
| Étape | Déploie l’élément dans un groupe de déploiement. |
| Action | L’exécution d’un élément pris en charge avant ou après le déploiement de l’élément du groupe. |
Pour les types d’actions prises en charge et le comportement d’action, voir Actions du plan de déploiement.
Comment fonctionne un plan de déploiement
Chaque opération de déploiement combine trois entrées :
- Éléments sélectionnés : Les éléments sélectionnés pour l’opération.
- Plan de déploiement : L’ordre explicite et les actions associés à ces éléments.
- Lignée Fabric : Les dépendances que Fabric détecte entre les objets.
Déterminer le périmètre de déploiement
L’outil de déploiement détermine la source, la cible et les éléments de l’opération. Joindre un plan ne remplace pas cette sélection. Les éléments sélectionnés qui ne font pas partie d’un groupe de déploiement continuent de déployer en utilisant le comportement standard de l’outil.
Joindre un plan ne sélectionne pas automatiquement les éléments qu’il mentionne. Sur une surface de déploiement sélectif, sélectionnez les éléments que vous souhaitez déployer, et assurez-vous que les éléments requis par les actions du plan sont disponibles dans l’espace de travail cible lorsque ces actions s’exécutent.
Un plan de déploiement contrôle le déploiement et les actions des items. Il ne déploie pas de configuration au niveau de l’espace de travail telle que les identités de l’espace de travail, les connexions, les liaisons de passerelle ou les paramètres Spark. Configurer l’espace de travail cible avant une action dépend de ces réglages.
Résoudre l’ordre de déploiement
Fabric combine des dépendances explicites entre groupes de déploiement avec des dépendances détectées à partir de la lignée. Un plan peut ajouter un ordre que la lignée ne représente pas, mais il ne supprime pas les dépendances détectées par Fabric.
Pour un scénario détaillé montrant comment les éléments sélectionnés, les dépendances du plan, la lignée et les actions d’exécution fonctionnent ensemble, voir les exemples de plans de déploiement.
Exécuter les groupes et actions de déploiement
Pour chaque groupe de déploiement, Fabric exécute ses actions pré-déploiement, déploie l'élément du groupe, puis exécute ses actions post-déploiement. Les dépendances entre groupes et actions déterminent leur ordre. La position d’un élément dans le dossier du plan ne définit pas son ordre.
Joindre un plan est optionnel. Sans plan, l’outil de déploiement sélectionné utilise son comportement standard.
Joindre un plan de déploiement
Vous pouvez joindre un plan lorsque vous utilisez une opération d’intégration Git prise en charge, déployez du contenu via un pipeline de déploiement ou appelez une API REST prise en charge. La pièce jointe concerne uniquement cette opération. Pour les surfaces supportées et le comportement de sélection de plans, voir Attacher un plan de déploiement.
Créer et versionner un plan de déploiement
Créez un plan sur la canevas du plan de déploiement, où vous ajoutez des groupes de déploiement, définissez leur ordre et configurez les actions. Pour les instructions, voir Créer un plan de déploiement.
Un plan de déploiement est un élément de l’espace de travail. Lorsque l’espace de travail est connecté à Git, validez le plan avec les éléments auxquels il fait référence afin qu’il puisse suivre votre processus CI/CD.
Si une opération échoue
L’opération s’arrête lorsqu’un élément ou une action échoue et ne revient pas en arrière sur le travail terminé. Pour le comportement en cas d’échec et les étapes de résolution, voir Résoudre les problèmes liés aux plans de déploiement.
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-cicdbibliothè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.
| Élément | Limit |
|---|---|
| Taille du plan | 1 Mo |
| Longueur d’un nom de groupe ou d’étape | 60 caractères |
| Groupes d’un plan | 1,000 |
| Dépendances sur un groupe | 1,000 |
| Actions de pré-déploiement dans un groupe | 20 |
| Actions post-déploiement en groupe | 20 |
| Dépendances à une action | 20 |
| Paramètres sur une action | 20 |
Contenu connexe
- Créer un plan de déploiement
- Exemples de plans de déploiement
- Introduction au CI/CD dans Microsoft Fabric
- Présentation de l’intégration Git
- Présentation des pipelines de déploiement
- Choisissez un flux de travail Fabric CI/CD
- Comprendre la liaison des dépendances dans le déploiement multi-espaces de travail