Automatiser votre pipeline de déploiement avec des 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.
Utilisez 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 faire en sorte 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 prérequis que 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.
Obtenir les phases du pipeline de déploiement : retourne les phases du déploiement spécifié, y compris son ID, son nom d’affichage, sa description et si la phase est publique ou non.
Obtenir les éléments de phase du pipeline de déploiement : retourne les éléments pris en charge de l’espace de travail affecté à la phase spécifiée du pipeline de déploiement spécifié.
Déployer le contenu de la phase : déploie des éléments à partir de la phase spécifiée du pipeline de déploiement spécifié.
Utilisez cette API pour déployer tous les éléments ou sélectionner ceux à déployer. Si aucun élément spécifique n’est sélectionné, tous sont déployés.
Pour trouver l’ID de phase approprié à déployer, utilisez l’API Obtenir les phases du pipeline de déploiement.
Cette API est intégrée aux API d’opérations longues pour surveiller l’état du déploiement.
- Obtenez l’état de l’opération pour voir si elle est terminée avec l’API Obtenir l’opération longue - Obtenir l’état de l’opération.
- Pendant 24 heures après la fin du déploiement, les informations de déploiement étendues sont disponibles dans l’API Obtenir le résultat de l’opération.
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 la phase source
- Nom de la phase cible
- Notes de déploiement (facultatif)
-
Renseignez les informations suivantes :
- Nom du pipeline
- Nom de la phase source
- Nom de la phase cible
- Éléments à déployer (nom complet et type des éléments)
- Notes de déploiement (facultatif)
Observations et limitations
Lorsque vous utilisez les API de pipeline de déploiement, tenez compte des limitations suivantes :
Toutes les limitations qui s’appliquent au pipeline de déploiement sont valables 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 flux de données 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 le sont pas 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 l’API Power BI pour déployer. Toutefois, ces API fonctionnent uniquement pour les éléments Power BI.