Commencez avec l'intégration de Git

Cet article vous guide tout au long des tâches de base suivantes dans l’outil d’intégration Git de Microsoft Fabric :

• Se connecter à un référentiel Git
• Valider les modifications
• Mettre à jour à partir de Git
• Se déconnecter de Git

Nous vous recommandons de lire la vue d’ensemble de l’intégration Git avant de commencer.

Prérequis

Pour intégrer Git à votre espace de travail Microsoft Fabric, vous devez configurer les conditions préalables suivantes pour Fabric et Git.

Les prérequis de Fabric

Pour accéder à la fonctionnalité d’intégration à Git, vous avez besoin d’une capacité de 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 de Power BI ne prennent en charge que les éléments Power BI.

En outre, les commutateurs de locataire suivants doivent être activés à partir du portail d’administration :

• Les utilisateurs peuvent créer des éléments Fabric - requis en cas d'utilisation d'artefacts 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.)
• 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 Active Azure DevOps inscrit auprès du même utilisateur Fabric (pris en charge même si l'organisation Azure DevOps réside dans un client différent de celui du client Fabric). Créer un compte gratuit.
• Access à un référentiel existant.

GitHub

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

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

  • Un jeton granulaire (recommandé) avec une autorisation de lecture et d’écriture sur Contents sous les autorisations de dépôt :

    

    Pour utiliser ce jeton avec GitHub Entreprise, suivez les instructions c0.

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

    

Connecter un espace de travail dans un référentiel Git

Se connecter à un référentiel Git

Seul un administrateur d’espace de travail peut connecter un espace de travail à un référentiel mais, une fois connecté, toute personne disposant d’une autorisation peut travailler dans l’espace de travail. Si vous n’êtes pas administrateur, demandez de l’aide à votre administrateur pour vous connecter. Pour connecter un espace de travail à un dépôt Azure ou GitHub, procédez comme suit :

1. Connectez-vous à Fabric et accédez à l’espace de travail avec lequel vous souhaitez vous connecter.

2. Accédez à Paramètres de l’espace de travail

   

3. Sélectionnez Intégration Git.

4. Sélectionnez votre fournisseur Git. Actuellement, Azure DevOps et GitHub sont pris en charge.

Connexion à Azure DevOps

Si vous sélectionnez Azure DevOps, sélectionnez Connect pour vous connecter automatiquement au compte Azure Repos inscrit à l’utilisateur Microsoft Entra connecté à Fabric.

Si vous vous êtes déjà connecté à Azure à partir de Fabric à l’aide d’un autre compte, sélectionnez votre compte dans la liste et sélectionnez Connect.

S’il s’agit de votre première connexion à partir de Fabric ou si vous souhaitez ajouter un nouveau compte, sélectionnez Ajouter un compte.

S’il s’agit de la première connexion, vous devez autoriser votre utilisateur. Renseignez les informations suivantes :

• Nom d'affichage : doit être unique pour chaque utilisateur
• Azure URL DevOps : URL du dépôt Azure DevOps. L’URL doit être au format https://dev.azure.com/{organization}/{project}/_git/{repository} ou https://{organization}.visualstudio.com/{project}/_git/{repo}.
• Authentification : vous pouvez vous authentifier auprès d’OAuth2 ou d’un principal de service. Pour plus d’informations, consultez Azure DevOps - Intégration Git avec le principal de service

Une fois connecté, sélectionnez Connect pour autoriser Fabric à access votre compte

GitHub Connect

Si vous sélectionnez GitHub, vous devez vous connecter à votre compte GitHub. Si vous êtes déjà connecté à GitHub, sélectionnez votre compte dans la liste et sélectionnez Connect.

S’il s’agit de votre première connexion à partir de Fabric ou si vous souhaitez ajouter un nouveau compte, sélectionnez Ajouter un compte.

S'il s'agit de la première connexion, vous devez autoriser l'utilisateur GitHub. Renseignez les informations suivantes :

• Display name : doit être unique pour chaque utilisateur GitHub
• jeton d'accès personnel - votre jeton d'accès personnel classique ou affiné
• Repository URL (facultatif pour github.com, obligatoire pour ghe.com) : si vous n'entrez pas d'URL, vous pouvez vous connecter à n'importe quel dépôt github.com auquel vous avez access. Si vous entrez une URL, vous ne pouvez vous connecter qu’à ce référentiel.

Une fois connecté, sélectionnez Connect pour autoriser Fabric à access votre compte de GitHub.

Se connecter à un espace de travail

Si l’espace de travail est déjà connecté à Azure DevOps/GitHub, suivez les instructions de Connecting à un espace de travail partagé.

Connexion des branches Azure DevOps

1. Dans le menu déroulant, spécifiez les détails suivants sur la branche à laquelle vous souhaitez vous connecter :

   • Organization
   • Project
   • dépôt Git.
   • Branche (Sélectionnez une branche existante à l’aide du menu déroulant ou sélectionnez + Nouvelle branche pour créer une nouvelle branche. Vous ne pouvez vous connecter qu’à une seule branche à la fois.)
   • Dossier (Tapez le nom d’un dossier existant ou entrez un nom pour créer un dossier. Si vous laissez le nom du dossier vide, le contenu est créé dans le dossier racine. Vous ne pouvez vous connecter qu’à un seul dossier à la fois.)

connexion de branche GitHub

1. Dans le menu déroulant, spécifiez les détails suivants sur la branche à laquelle vous souhaitez vous connecter :

   • URL du dépôt. Si vous vous êtes connecté à GitHub à l’aide d’un jeton délimité, l’URL est automatiquement renseignée et vous pouvez uniquement vous connecter à ce référentiel.
   • Branche (Sélectionnez une branche existante à l’aide du menu déroulant ou sélectionnez + Nouvelle branche pour créer une nouvelle branche. Vous ne pouvez vous connecter qu’à une seule branche à la fois.)
   • Dossier (Tapez le nom d’un dossier existant ou entrez un nom pour créer un dossier. Si vous laissez le nom du dossier vide, le contenu est créé dans le dossier racine. Vous ne pouvez vous connecter qu’à un seul dossier à la fois.)

Sélectionnez Se connecter et synchroniser.

Pendant la synchronisation initiale, si l’espace de travail ou la branche Git est vide, le contenu est copié de l’emplacement non vide vers l’emplacement vide. Si l’espace de travail et la branche Git ont du contenu, vous devez choisir la direction à suivre pour la synchronisation. Pour plus d’informations sur cette synchronisation initiale, consultez Se connecter et synchroniser.

Une fois connecté, l’espace de travail affiche des informations sur le contrôle de code source qui permettent à l’utilisateur d’afficher la branche connectée, l’état de chaque élément de la branche et l’heure de la dernière synchronisation.

Pour maintenir la synchronisation de votre espace de travail avec la branche Git, validez toutes les modifications que vous apportez dans l’espace de travail dans la branche Git et mettez à jour votre espace de travail chaque fois que quelqu’un crée de nouvelles validations dans la branche Git.

Valider les modifications apportées à Git

Une fois que vous êtes connecté à un dossier Git, modifiez votre espace de travail comme d’habitude. Toutes les modifications que vous enregistrez sont enregistrées dans l’espace de travail uniquement. Lorsque vous êtes prêt, vous pouvez valider vos modifications dans la branche Git, ou vous pouvez annuler les modifications et revenir à l’état précédent.

En savoir plus sur les commits.

Validation sur git

Pour valider vos modifications dans la branche Git, procédez comme suit :

1. Accéder à l’espace de travail.

2. Sélectionnez l’icône Contrôle de code source. Cette icône affiche le nombre de modifications non validées.

3. Sélectionnez Modifications dans le volet Contrôle de code source. Une liste s’affiche avec tous les éléments que vous avez modifiés et une icône indiquant si l’élément est nouveau, modifié, conflictuel , identique ou supprimé.

4. Sélectionnez les éléments que vous voulez confirmer. Pour sélectionner tous les éléments, cochez la case du haut.

5. Ajoutez un commentaire dans la case. Si vous n’ajoutez pas de commentaire, un message par défaut est ajouté automatiquement.

6. Sélectionnez Valider.

   

Une fois les changements commités, les éléments qui ont été commités sont supprimés de la liste et l’espace de travail pointe vers le nouveau commit avec lequel il est synchronisé.

Une fois la validation terminée, l’état des éléments sélectionnés passe de Non validé à Synchronisé.

Valider sur une branche autonome

La validation sur une branche autonome est une fonctionnalité d’intégration Git qui vous permet de créer une nouvelle branche et de valider vos modifications actuelles dans une seule action. En d’autres termes, au lieu de vous engager dans la branche connectée, vous pouvez vous brancher à la volée : le système va faire tourner une nouvelle branche Git et enregistrer votre travail là-bas sans vous obliger à quitter ou à basculer de votre branche d’origine.

1. Accéder à l’espace de travail.
2. Sélectionnez l’icône Contrôle de code source. Cette icône affiche le nombre de modifications non validées.
3. Sélectionnez Modifications dans le volet Contrôle de code source. Une liste s’affiche avec tous les éléments que vous avez modifiés et une icône indiquant si l’élément est nouveau, modifié, conflictuel , identique ou supprimé.
4. Sélectionnez les éléments que vous voulez confirmer. Pour sélectionner tous les éléments, cochez la case du haut.
5. Ajoutez un commentaire dans la case. Si vous n’ajoutez pas de commentaire, un message par défaut est ajouté automatiquement.
6. Sélectionnez Valider dans une nouvelle branche.

Important

Soyez conscient des éléments suivants :

• la branche nouvellement créée ne sera pas connectée à l’espace de travail existant.
• la branche nouvellement créée est basée sur le dernier état de synchronisation de l’espace de travail actuel.
• cette fonctionnalité est possible lorsqu’il existe des mises à jour entrantes, même si la validation par défaut est désactivée.
• L’état actuel de l’espace de travail ne sera pas modifié par cette validation et restera inchangé.

Annuler la modification enregistrée

Après avoir enregistré les modifications apportées à l’espace de travail, si vous décidez que vous ne souhaitez pas valider ces modifications dans git, vous pouvez annuler les modifications et rétablir ces éléments à leur état précédent. Pour annuler vos modifications, procédez comme suit :

1. Accéder à l’espace de travail.

2. Sélectionnez le bouton Contrôle de code source. Ce bouton affiche également le nombre de modifications non validées.

3. Sélectionnez Modifications du volet Contrôle de code source. Une liste s’affiche avec tous les éléments que vous avez modifiés et une icône indique si l’élément modifié est nouveau, modifié, conflictuel, ou supprimé.

4. Sélectionnez les modifications que vous souhaitez annuler.

5. Placez une case à cocher dans la zone I comprenez que les éléments de l’espace de travail peuvent être supprimés et ne peuvent pas être restaurés , puis sélectionnez Annuler.

   

6. Sélectionnez Annuler à nouveau pour confirmer. La boîte de dialogue que vous voyez peut varier selon que des éléments qui seront supprimés sont détectés ou non. La première capture d’écran ne montre aucune suppression. Deuxièmement, si des suppressions sont détectées.

   

   

Les éléments sélectionnés dans votre espace de travail retournent à l’état dans lequel ils étaient lors de la dernière synchronisation de l’espace de travail.

Important

Si vous supprimez un élément, puis annulez les modifications, l’élément est créé et certaines des métadonnées peuvent être perdues. Par exemple, les étiquettes de sensibilité ne sont pas conservées et doivent être réinitialisées, et le propriétaire de l’élément est attribué à l’utilisateur actuel.

L’annulation des éléments ajoutés supprime définitivement l’élément.

Mettre à jour l’espace de travail à partir de Git

Chaque fois que quelqu’un valide une nouvelle modification de la branche Git connectée, une notification s’affiche dans l’espace de travail approprié. Utilisez le volet Contrôle de code source pour intégrer les dernières modifications, fusions ou restaurations dans l’espace de travail et mettre à jour les éléments en direct. Les modifications apportées aux dossiers sont également mises à jour. En savoir plus sur la mise à jour.

Pour mettre à jour un espace de travail, procédez comme suit :

1. Accéder à l’espace de travail.
2. Sélectionnez l’icône Contrôle de code source.
3. Sélectionnez Updates à partir du control panel source. Une liste s’affiche avec tous les éléments qui ont été modifiés dans la branche depuis la dernière mise à jour.
4. Sélectionnez Mettre à jour tout.

5. Dans la boîte de dialogue de confirmation, sélectionnez Mettre à jour.

Une fois la mise à jour réussie, la liste des éléments est supprimée et l’espace de travail pointe vers le nouvel espace de travail auquel il est synchronisé.

Une fois la mise à jour terminée, l’état des éléments devient Synchronisé.

Déconnecter un espace de travail de Git

Seul un administrateur d’espace de travail peut déconnecter un espace de travail d’un référentiel Git. Si vous n’êtes pas administrateur, demandez de l’aide à votre administrateur pour vous déconnecter. Si vous êtes administrateur et que vous souhaitez déconnecter votre référentiel, procédez comme suit :

1. Accédez à Paramètres de l’espace de travail
2. Configurez l’intégration de Git
3. Sélectionnez Déconnecter l’espace de travail
4. Sélectionnez à nouveau Déconnecter pour confirmer.

autorisations

Les actions que vous pouvez effectuer sur un espace de travail dépendent des autorisations dont vous disposez à la fois dans l’espace de travail et dans le référentiel Git. Pour une présentation plus détaillée des autorisations, consultez Autorisations.

Contenu connexe

• Comprendre le processus d’intégration Git
• Gérer les branches GIT
• Meilleures pratiques pour l’intégration Git