Automatisez votre pipeline de déploiement avec les API Fabric
L'outil de pipelines de déploiement de Microsoft Fabric permet aux équipes de créer un processus de publication efficace et réutilisable pour leur contenu Fabric.
Important
Cette fonctionnalité est en préversion.
Vous pouvez utiliser les API REST Fabric des pipelines de déploiement pour intégrer Fabric dans le processus d'automatisation de votre organisation. Voici quelques exemples de ce qu’il est possible de faire en utilisant les API :
Intégrez Fabric dans des outils DevOps familiers tels qu'Azure DevOps ou GitHub Actions.
Planifier des déploiements de pipeline pour qu’ils se déclenchent automatiquement à un moment donné.
Déployer plusieurs pipelines en même temps.
Mettre en cascade des déploiements de pipeline. Si vous avez un contenu connecté à des pipelines, vous pouvez vous assurer que certains pipelines soient déployés avant d’autres.
Prérequis
Pour utiliser les API de pipeline de déploiement, vous avez besoin des prérequis suivants :
- Les mêmes conditions préalables que celles dont vous avez besoin pour utiliser des pipelines de déploiement.
- Un jeton Microsoft Entra pour le service Fabric. Utiliser ce jeton dans l’en-tête d’autorisation de l’appel d’API. Pour plus d’informations sur l’obtention d’un jeton, consultez Démarrage rapide avec l’API Fabric.
Vous pouvez utiliser les API REST sans PowerShell, mais les scripts de cet article utilisent PowerShell. Pour exécuter les scripts, vous devez installer les programmes suivants :
Fonctions des API des pipelines de déploiement
Les API REST Fabric des pipelines de déploiement vous permettent d'effectuer les fonctions suivantes :
Obtenir le pipeline de déploiement : retourne des informations sur le pipeline de déploiement spécifié.
Répertorier les pipelines de déploiement : retourne une liste de pipelines de déploiement auxquels l’utilisateur a accès.
Répertorier les étapes du pipeline de déploiement : retourne les étapes du déploiement spécifié, y compris son ID, son nom d’affichage, sa description et si l’étape est publique ou non.
Répertorier les éléments d’une étape du pipeline de déploiement : retourne les éléments pris en charge de l’espace de travail affecté à l’étape spécifiée du pipeline de déploiement spécifié.
Déployer le contenu de l'étape : Déploie les éléments de l'étape spécifiée du pipeline de déploiement spécifié.
Utilisez cette API pour déployer tous les éléments ou sélectionner des éléments spécifiques à déployer. Si aucun élément spécifique n’est sélectionné, tous les éléments sont déployés.
Pour rechercher l’ID d’étape approprié à déployer, utilisez l’API Répertorier les étapes du pipeline de déploiement.
Cette API est intégrée aux API Opérations longues pour surveiller l’état du déploiement.
- Obtenez l’état de l’opération pour voir si l’opération est terminée avec l’API Get Long Running - Get Operation State .
- Pendant 24 heures après la fin du déploiement, les informations de déploiement étendues sont disponibles dans l’APIGet Operation Result .
Vous pouvez également utiliser d’autres appels d’API REST Fabric pour effectuer des opérations associées.
Exemples PowerShell
Vous pouvez utiliser les scripts PowerShell suivants pour comprendre comment exécuter plusieurs processus d’automatisation. Pour visualiser ou copier le texte d’un exemple PowerShell, utilisez les liens fournis dans cette section.
-
Renseignez les informations suivantes :
- Nom du pipeline
- Nom de l’aperçu de la source
- Nom de l'aperçu cible
- Notes de déploiement (facultatif)
-
Renseignez les informations suivantes :
- Nom du pipeline
- Nom de l’aperçu de la source
- Nom de l'aperçu cible
- Éléments à déployer (nom complet et type d’élément)
- Notes de déploiement (facultatif)
Observations et limitations
Lorsque vous utilisez les API de pipelines de déploiement, tenez compte des limitations suivantes :
Toutes les limitations qui s’appliquent au pipeline de déploiement, s’appliquent lors de l’utilisation des API. Pour plus d’informations, consultez Pratiques recommandées pour les pipelines de déploiement.
Les flux de données ne sont pas pris en charge pour l’instant. Les clients utilisant des dataflows peuvent utiliser les API Power BI.
Les principaux de service ne sont pris en charge que pour les éléments Power BI.
Toutes les options de déploiement disponibles dans les API Power BI ne sont pas disponibles dans Fabric. Les API suivantes ne sont pas disponibles dans l’API de contenu de phase de déploiement de Fabric :
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
Si vous avez besoin de l’une de ces API, utilisez la API Power BI pour déployer. Toutefois, ces API fonctionnent uniquement pour les éléments Power BI.