Gérer les branches dans les espaces de travail Microsoft Fabric

L’objectif de cet article est de présenter aux développeurs Fabric différentes options pour créer des processus d’intégration continue et de livraison continue (CI/CD) dans Fabric, basés sur des scénarios client courants. Cet article se concentre davantage sur la partie intégration continue (CI) du processus CI/CD. Pour une discussion sur la partie livraison continue (CD), consultez gérer les pipelines de déploiement.

Cet article décrit quelques options d’intégration distincts, mais de nombreuses organisations utilisent une combinaison d’entre elles.

Prérequis

Pour intégrer Git à votre espace de travail Microsoft Fabric, vous devez configurer les prérequis suivants dans Fabric et Git.

Prérequis Fabric

Pour accéder à la fonctionnalité d’intégration Git, vous avez besoin d’une capacité Fabric. Une capacité Fabric est nécessaire pour utiliser tous les éléments Fabric pris en charge. Si vous n’en avez pas encore, inscrivez-vous à un essai gratuit. Les clients qui disposent déjà d’une capacité Power BI Premium, peuvent utiliser cette capacité, mais gardez à l’esprit que certaines références SKU Power BI prennent uniquement en charge les éléments Power BI.

De plus, les commutateurs de client suivants doivent être activés à partir du portail d’administration :

• Les utilisateurs peuvent créer des éléments Fabric
• Les utilisateurs peuvent synchroniser des éléments d’espace de travail avec leurs référentiels Git
• Créez des espaces de travail (uniquement si vous souhaitez créer une branche vers un nouvel espace de travail.)
• Les utilisateurs peuvent synchroniser des éléments d’espace de travail avec des référentiels GitHub : pour les utilisateurs GitHub uniquement

Ces commutateurs peuvent être activés par l’administrateur client, l’administrateur de capacité ou l’administrateur de l’espace de travail, en fonction des paramètres de votre organisation.

Conditions préalables pour Git

L’intégration Git est actuellement prise en charge pour Azure DevOps et GitHub. Pour utiliser l’intégration Git à votre espace de travail Fabric, vous avez besoin des éléments suivants dans Azure DevOps ou GitHub :

Azure DevOps

• Un compte Azure actif inscrit auprès du même utilisateur qui utilise l’espace de travail Fabric. Créer un compte gratuit.

GitHub

• Un compte GitHub actif. Créer un compte GitHub.

• Un des jetons d’accès personnels suivants :

  • Un jeton affiné (recommandé) avec l’autorisation de lecture et d’écriture Contenu sous les autorisations de dépôt :

    

    Pour utiliser ce jeton avec GitHub Enterprise, suivez ces instructions.

  • Une action Créer un jeton classique GitHub avec des étendues de dépôt activées :

    

Processus de développement

L’espace de travail Fabric est un environnement partagé qui accède à des éléments en direct. Toutes les modifications apportées directement dans l’espace de travail remplacent et affectent tous les autres utilisateurs de l’espace de travail. Par conséquent, la meilleure pratique Git pour les développeurs consiste à travailler de manière isolée en dehors des espaces de travail partagés. Il existe deux façons pour un développeur de travailler dans son propre espace de travail protégé.

• Développer à l’aide d’outils clients, tels que Power BI Desktop pour les rapports et les modèles sémantiques, ou VS Code pour les notebooks.
• Développer dans un espace de travail Fabric distinct. Chaque développeur dispose de son propre espace de travail dans lequel il connecte sa propre branche distincte, synchronise le contenu dans cet espace de travail, puis commite dans la branche.

Pour utiliser des branches à l’aide de l’intégration Git, connectez d’abord l’espace de travail partagé de l’équipe de développement à une seule branche partagée. Par exemple, si votre équipe utilise un espace de travail partagé, connectez-le à la branche primaire dans le référentiel de votre équipe et synchronisez l’espace de travail et le référentiel. Si le flux de travail de votre équipe comporte plusieurs branches partagées telles que les branches Dev/Test/Prod, chaque branche peut être connectée à un espace de travail différent.

Ensuite, chaque développeur peut choisir l’environnement isolé dans lequel travailler.

Scénario 1 : développer en utilisant des outils clients

Si les éléments que vous développez sont disponibles dans d’autres outils, vous pouvez travailler sur ces éléments directement dans l’outil client. Tous les éléments ne sont pas disponibles dans chaque outil. Les éléments disponibles uniquement dans Fabric doivent être développés dans Fabric.

Le flux de travail pour les développeurs utilisant un outil client comme Power BI Desktop doit ressembler à ceci :

1. Clonez le dépôt sur un ordinateur local. (Vous ne devez effectuer cette étape qu’une seule fois.)

2. Ouvrez le projet dans Power BI Desktop à l’aide de la copie locale du PBIProj.

3. Apportez des modifications et enregistrez les fichiers mis à jour localement. Commiter dans le référentiel local.

4. Lorsque vous êtes prêt, envoyez (push) la branche et commitez dans le référentiel distant.

5. Testez les modifications sur d’autres éléments ou sur plus de données. Pour tester les modifications, connectez la nouvelle branche à un espace de travail distinct et chargez le modèle sémantique et les rapports en utilisant le bouton Tout mettre à jour dans le panneau contrôle de code source. Effectuez des tests ou des modifications de configuration avant de fusionner dans la branche principale.

   Si aucun test n’est requis dans l’espace de travail, le développeur peut fusionner les modifications directement dans la branche principale, sans avoir besoin d’un autre espace de travail.

6. Une fois les modifications fusionnées, l’espace de travail de l’équipe partagée est invité à accepter le nouveau commit. Les modifications sont mises à jour dans l’espace de travail partagé et tout le monde peut voir les modifications apportées à ces modèles sémantiques et rapports.

Pour obtenir des conseils spécifiques sur l’utilisation du nouveau format de fichier Power BI Desktop dans Git, consultez Format de code source.

Scénario 2 : développer en utilisant un autre espace de travail

Pour un développeur qui travaille sur le web, le flux se présente comme suit :

1. Sous l’onglet Branches du menu Contrôle de code source, sélectionnez Créer une branche dans un autre espace de travail.

   

2. Spécifiez si vous souhaitez créer un espace de travail ou basculer vers un espace de travail existant. Spécifiez les noms de la nouvelle branche et de l’espace de travail, ou sélectionnez l’espace de travail existant dans la liste déroulante. Notez que lorsque vous créez une branche vers un espace de travail, tous les éléments qui ne sont pas enregistrés dans Git peuvent être perdus. Nous vous recommandons de commiter tous les éléments que vous souhaitez conserver avant de créer l’embranchement.

   

3. Sélectionner Créer une branche.

   Fabric crée l’espace de travail et la branche. Vous êtes automatiquement redirigé vers le nouvel espace de travail.

   L’espace de travail se synchronise avec votre branche de fonctionnalité et devient un environnement isolé dans lequel travailler, comme illustré. Vous pouvez maintenant travailler dans ce nouvel environnement isolé. La synchronisation peut prendre quelques minutes. Pour plus d'informations sur l'expansion, consultez conseils de résolution des problèmes.

   

4. Enregistrez vos modifications et commitez-les dans la branche de fonctionnalité.

5. Lorsque vous êtes prêt, créez une demande de tirage (pull request) dans la branche principale. Les processus de révision et de fusion sont effectués via Azure Repos en fonction de la configuration que votre équipe a définie pour ce référentiel.

Une fois la révision et la fusion terminées, un nouveau commit est créé dans la branche principale. Ce commit invite l’utilisateur à mettre à jour le contenu de l’espace de travail de l’équipe de développement avec les modifications fusionnées.

Pour en savoir plus, veuillez consulter Limitations d’embranchement.

Processus de mise en production

Le processus de mise en production commence une fois que de nouvelles mises à jour ont terminé un pull request et se sont fusionnées dans la branche partagée de l’équipe (par exemple, Main, Dev, etc.). À partir de ce stade, il existe différentes options pour générer un processus de mise en production dans Fabric. Pour en savoir plus sur les différentes options à prendre en compte lors de la conception de votre flux de travail, consultez processus de mise en production.

Passer d’une branche à l’autre

Si votre espace de travail est connecté à une branche Git et que vous souhaitez basculer vers une autre branche, vous pouvez le faire rapidement à partir du volet Contrôle de code source sans vous déconnecter et vous reconnecter.
Lorsque vous changez de branche, l’espace de travail se synchronise avec la nouvelle branche et tous les éléments de l’espace de travail sont remplacés. S’il existe différentes versions du même élément dans chaque branche, l’élément est remplacé. Si un élément se trouve dans l’ancienne branche, mais pas dans la nouvelle branche, il est supprimé. Pour basculer entre les branches, procédez comme suit :

1. Sous l’onglet Branches du menu Contrôle de code source, sélectionnez Changer de branche.

   

2. Spécifiez la branche à laquelle vous souhaitez vous connecter ou créez une branche. Cette branche doit contenir le même répertoire que la branche actuelle.

3. Sélectionnez Changer de branche.

Vous ne pouvez pas changer de branche si vous avez des modifications non commitées dans l’espace de travail. Sélectionnez Annuler pour revenir en arrière et valider vos modifications avant de changer de branche.

Pour connecter l’espace de travail actuel à une nouvelle branche tout en conservant l’état de l’espace de travail existant, sélectionnez Extraire une nouvelle branche. En savoir plus sur l’extraction d’une nouvelle branche sur Résoudre les conflits dans Git.

Contenu connexe

• Résoudre les erreurs et les conflits
• Meilleures pratiques pour l’intégration Git