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.

Utilisez les API REST des pipelines de déploiement de Fabric 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.

• Cascader en fonction des déploiements de pipeline. Si vous avez du contenu connecté entre plusieurs pipelines, vous pouvez vous assurer que certains pipelines sont 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 :

• PowerShell
• Module Az d'Azure PowerShell.

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 indiqué.

• 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 d'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 .

• Créer un pipeline de déploiement : créer un pipeline de déploiement.

• Supprimer le pipeline de déploiement : supprimez un pipeline de déploiement.

• Mise à jour du pipeline de déploiement : Mettez à jour un pipeline de déploiement.

• Obtenir l’étape du pipeline de déploiement : obtenez les détails d’une étape de pipeline de déploiement.

• Mettre à jour une étape de pipeline de déploiement : mettez à jour une étape de pipeline de déploiement.

• Ajouter une attribution de rôle de pipeline de déploiement : ajoutez une attribution de rôle à un pipeline de déploiement.

• Supprimer l’attribution de rôle de pipeline de déploiement : supprimez une attribution de rôle d’un pipeline de déploiement.

• Répertorier les attributions de rôles de pipeline de déploiement : répertorier toutes les attributions de rôles pour un pipeline de déploiement.

• Affecter un espace de travail à l’étape du pipeline de déploiement : affectez un espace de travail à une étape de pipeline de déploiement spécifique.

• Annuler l’attribution d’un espace de travail à partir de l’étape du pipeline de déploiement : annulez l’affectation d’un espace de travail à partir d’une phase de pipeline de déploiement spécifique.

• Obtenir les détails d’une opération de pipeline de déploiement : obtenez les détails d’une opération de pipeline de déploiement.

• Répertorier les opérations de pipeline de déploiement : répertorier toutes les opérations d’un pipeline de déploiement.

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.

Vous pouvez aussi télécharger l’intégralité du dossier GitHub Fabric-Samples.

• Déployer tout

  Renseignez les informations suivantes :

  • Nom du pipeline
  • Nom de scène de la source
  • Nom de scène cible
  • Notes de déploiement (facultatif)
  • Type de principal. Choisissez UserPrincipal ou ServicePrincipal. Si le principal de service est également fourni :
    • ID d’application (client) du principal de service
    • ID d’annuaire (locataire) du principal de service
    • Valeur secrète du principal de service

• Déploiement sélectif

  Renseignez les informations suivantes :

  • Nom du pipeline
  • Nom de scène de la source
  • Nom de scène cible
  • Éléments à déployer (nom complet et type d’élément)
  • Notes de déploiement (facultatif)
  • Type de principal. Choisissez UserPrincipal ou ServicePrincipal. Si le principal de service est également fourni :
    • ID d’application (client) du principal de service
    • ID d’annuaire (locataire) du principal de service
    • Valeur secrète du principal de service

• Attribuer au nouveau pipeline de déploiement et déployer

  Renseignez les informations suivantes :

  • ID de l’espace de travail de développement
  • Nouveau nom de l’espace de travail de production
  • Nom du pipeline
  • Notes de déploiement (facultatif)
  • Type de principal. Choisissez UserPrincipal ou ServicePrincipal. Si le principal de service est également fourni :
    • ID d’application (client) du principal de service
    • ID d’annuaire (locataire) du principal de service
    • Valeur secrète du principal de service

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.

• 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

  Pour utiliser l’une de ces API, utilisez l’API Power BI pour déployer. Toutefois, ces API fonctionnent uniquement pour les éléments Power BI.

Contenu connexe

• Prise en main des pipelines de déploiement
• Meilleures pratiques pour les pipelines de déploiement
• Dépannage des pipelines de déploiement