Partagez votre code avec Azure Repos et Visual Studio

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Partagez votre solution Visual Studio avec d’autres personnes en hébergeant votre code dans un référentiel Git Azure Repos. Vous pouvez utiliser Visual Studio pour gérer les référentiels Git Azure Repos ou les référentiels GitHub. Cette article fournit des procédures pour les tâches suivantes :

  • Ajoutez un projet ou une solution à un référentiel Git local
  • Publiez votre code dans un référentiel Git Azure Repos ou un référentiel GitHub
  • Passez en revue vos modifications de code avant la publication
  • Liez des éléments de travail à vos validations
  • Validez et envoyez (push) les mises à jour
  • Modifications de tirage (pull) de la branche primaire de votre référentiel

Pour cloner un référentiel GitHub, obtenez l’URL de clone comme décrit dans Clonage d’un référentiel.

Pour obtenir une vue d’ensemble du flux de travail Git, consultez le tutoriel Git Azure Repos.

Prérequis

  • Les référentiels doivent être activés dans vos paramètres de projet Azure DevOps. Si le hub Référentiel et les pages associées ne s’affichent pas, consultez Activer ou désactiver un service Azure DevOps pour réactiver le Référentiel.

  • Pour afficher le code dans des projets privés, vous devez être membre d’un projet Azure DevOps avec un niveau d’accès De base ou supérieur. Pour les projets publics, tout le monde peut afficher le code.

  • Pour cloner ou contribuer au code d’un projet privé, vous devez être membre du groupe de sécurité Contributeurs ou disposer des autorisations correspondantes. Pour les projets publics, n’importe qui peut cloner et contribuer au code. Pour en savoir plus, consultez Qu’est-ce qu’un projet public ?

    Notes

    Pour les projets publics, les utilisateurs autorisés à accéder aux Parties prenantes ont un accès complet à Azure Repos.

  • Les référentiels doivent être activés dans vos paramètres de projet Azure DevOps. Si le hub Référentiel et les pages associées ne s’affichent pas, consultez Activer ou désactiver un service Azure DevOps pour réactiver le Référentiel.

  • Pour afficher le code, vous devez être membre du projet Azure DevOps avec un accès De base ou supérieur. Si vous n’êtes pas membre du projet, soyez ajouté.

  • Pour cloner ou contribuer au code, vous devez être membre du groupe de sécurité Contributeurs ou disposer des autorisations correspondantes dans le projet que vous souhaitez modifier.

Pour en savoir plus sur les autorisations et l’accès, consultez Référentiel Git par défaut et les autorisations de branche et À propos des niveaux d’accès.

Notes

Visual Studio 2019 version 16.8 et versions ultérieures fournissent un nouveau menu Git pour gérer le flux de travail Git avec moins de changement de contexte que Team Explorer. Les procédures fournies dans cet article sous l’onglet Visual Studio fournissent des informations sur l’utilisation de l’expérience Git et Team Explorer. Pour plus d’informations, consultez Comparaison côte à côte de Git et Team Explorer.

Ajoutez un projet ou une solution à un nouveau référentiel Git local

La première étape pour partager votre solution Visual Studio avec d’autres utilisateurs de Git consiste à créer un référentiel Git local pour votre code. Si c’est la première fois que vous utilisez Visual Studio pour vous connecter à Azure Repos, consultez Se connecter à un projet à partir de Visual Studio pour plus d’informations.

  1. Créez un référentiel Git local pour votre solution Visual Studio, en faisant un clic droit sur le nom de la solution dans Explorateur de solutions, puis en sélectionnant Créer un référentiel Git. Vous pouvez également choisir Ajouter au contrôle de code source dans la barre d’état dans le coin inférieur droit de Visual Studio, puis sélectionnez Git. Si vous ne voyez pas ces options, votre code se trouve déjà dans un référentiel Git.

    Capture d’écran de l’option « Créer un référentiel Git » dans le menu contextuel de l’Explorateur de solutions dans Visual Studio 2022.

    Vous pouvez également choisir Git > Créer un référentiel Git dans la barre de menu pour lancer la fenêtre Créer un référentiel Git. Si vous ne voyez pas cette option, votre code se trouve déjà dans un référentiel Git.

    Capture d’écran de l’option « Créer un référentiel Git » dans le menu Git de la barre de menu de Visual Studio 2022.

  2. Cette étape s’applique uniquement à l’expérience de contrôle de version de Visual Studio Git : dans la fenêtre Créer un référentiel Git, choisissez Local uniquement, vérifiez que le chemin d’accès local est correct, puis choisissez Créer.

    Capture d’écran de la fenêtre « Créer un référentiel Git » avec l’option « Local uniquement » sélectionnée dans Visual Studio 2022.

Vous avez maintenant créé un référentiel Git local dans le dossier de solution Visual Studio et vous avez validé votre code dans ce référentiel. Votre référentiel Git local contient à la fois votre solution Visual Studio et des ressources Git.

Capture d’écran du dossier Git, du fichier Git ignore et du fichier d’attributs Git dans l’Explorateur de fichiers Windows.

Publiez votre code

Vous pouvez partager votre travail avec d’autres personnes en publiant votre référentiel Git local dans un référentiel Git Azure Repos.

Visual Studio 2022 offre une expérience de contrôle de version Git à l’aide du menu Git, des modifications Git et des menus contextuels dans l’Explorateur de solutions. Visual Studio 2019 version 16.8 offre également l’interface utilisateur Git de Team Explorer. Pour plus d’informations, consultez l’onglet Visual Studio 2019 - Team Explorer.

  1. Connectez-vous à un référentiel Azure DevOps en faisant un clic droit sur le nom de la solution dans Explorateur de solutions, puis en sélectionnant Envoyer (push) vers le service Git pour lancer la fenêtre Créer un référentiel Git.

    Capture d’écran de l’option de menu « Envoyer (push) vers le service Git » dans le menu contextuel de l’Explorateur de solutions dans Visual Studio 2022.

    Vous pouvez également choisir Git > Envoyer (push) vers le service Git dans la barre de menu pour lancer la fenêtre Créer un référentiel Git.

    Capture d’écran de l’option « Envoyer (push) vers le service Git » dans le menu contextuel de Visual Studio 2022.

  2. Dans la boîte de dialogue Créer un référentiel Git, sélectionnez GitHub. Entrez les valeurs requises sous Créer un référentiel GitHub. Sélectionnez ensuite Envoyer (push).

    Capture d’écran de la boîte de dialogue « Créer un référentiel Git » pour Visual Studio 2022.

    Vous pouvez vérifier que le référentiel est créé en accédant à GitHub et en recherchant le nom de votre référentiel dans votre compte.

Passez en revue les modifications de validation

Il est recommandé de passer en revue les modifications apportées au code dans votre validation avant la publication. Visual Studio propose un affichage diff qui vous permet de voir toutes les modifications que vous avez apportées depuis la validation précédente.

  1. Pour voir ce qui a changé dans une validation, sélectionnez Git>Gérer les branches pour ouvrir la fenêtre Référentiel Git.

    Capture d’écran de Visual Studio.

  2. Dans la fenêtre Référentiel Git, sélectionnez votre branche, faites un clic droit sur la validation, puis choisissez Afficher les détails de validation pour ouvrir la fenêtre Validation.

    Capture d’écran de l’option de menu « Afficher les détails de validation » d’une validation dans la fenêtre « Référentiel Git » dans Visual Studio.

  3. Dans la fenêtre Validation, vous pouvez faire un clic droit sur n’importe quel fichier et sélectionner Comparer avec Précédent pour afficher les modifications apportées au fichier par la validation.

    Capture d’écran de l’option « Comparer avec Précédent » dans le volet Validation dans Visual Studio.

Lorsque vous développez votre logiciel, vous pouvez capturer les validations qui prennent en charge l’achèvement d’éléments de travail tels que les tâches Azure DevOps ou les correctifs de bogues. La piste d’audit des éléments de travail liés aux validations permet à votre équipe de comprendre comment les tâches et les bogues ont été résolus.

Notes

La syntaxe #ID est prise en charge lorsque vous vous connectez à un référentiel Git Azure Repos. Si vous vous connectez à un référentiel GitHub, vous pouvez toujours lier des éléments de travail, mais vous devez utiliser la syntaxe #ABID et avoir précédemment configuré une connexion Azure Boards-GitHub.

Vous pouvez lier des éléments de travail à des validations en ajoutant #ID dans le message de validation. Par exemple, le message de validation « Corriger le bogue #12 Icônes manquantes dans les outils de création de rapports » lierait l’élément de travail 12 à la validation lorsque la validation est envoyée (push) à Azure Repos.

Capture d’écran d’un élément de travail lié à une validation dans la fenêtre « Modifications Git » dans Visual Studio.

Envoyer (push) les modifications de validation

Lorsque vous écrivez votre code, vos modifications sont suivies automatiquement par Visual Studio. Lorsque vous êtes satisfait de vos modifications, vous pouvez les enregistrer dans Git à l’aide d’une validation, puis envoyer (push) votre validation vers Azure Repos.

  1. Dans la fenêtre Modifications Git, entrez un message qui décrit les modifications, puis choisissez Tout valider. Tout valider permet de valider les modifications non indexées et de ne pas passer par la zone d’indexation. Vous pouvez choisir d’indexer tous les fichiers avant de les valider en sélectionnant le bouton indexer tous + (plus) en haut de la section Modifications de la fenêtre Modifications Git.

    Capture d’écran du bouton « Tout valider » dans la fenêtre « Modifications Git » dans Visual Studio.

  2. Pour envoyer votre validation à Azure Repos, sélectionnez le bouton d’envoi (push) de flèche vers le haut.

    Capture d’écran du bouton d’envoi (push) de flèche vers le haut dans la fenêtre « Modifications Git » de Visual Studio.

    Vous pouvez également envoyer (push) votre validation à partir de la fenêtre Référentiel Git. Pour ouvrir la fenêtre Référentiel Git, sélectionnez le lien sortant/entrant dans la fenêtre Modifications Git.

    Capture d’écran du lien « sortant / entrant » dans la fenêtre « Modifications Git » et du lien Envoyer (push) dans la fenêtre « Référentiel Git » de Visual Studio.

    Vous pouvez également choisir Git > Envoyer (push) dans la barre de menu.

    Capture d’écran de l’option Envoyer (push) à partir du menu Git dans Visual Studio.

Modifications de tirage (pull)

Vous pouvez maintenir la synchronisation de vos branches locales avec leurs homologues distants en tirant (pull) les validations créées par d’autres personnes. Pendant que vous travaillez sur votre branche de fonctionnalité, il est judicieux de basculer régulièrement vers votre branche main et de tirer (pull) de nouvelles validations pour la maintenir à jour avec la branche distante main.

Notes

Dans Visual Studio, les liens Récupérer (fetch) et Tirer (pull) se trouvent dans différents affichages et dans le menu Git de la barre de menu. Ces liens font tous la même chose : récupérer (fetch) ou tirer (pull) du référentiel distant vers la branche actuelle du référentiel local.

  1. Dans la fenêtre Modifications Git, vous pouvez vérifier les validations les plus récentes sur la branche distante à l’aide du lien de récupération (fetch) de flèche vers le bas, puis en sélectionnant le lien sortant/entrant pour ouvrir la fenêtre Référentiel Git. Récupérer (fetch) télécharge les validations distantes qui ne se trouvent pas dans votre branche locale, mais ne les fusionneront pas dans votre branche locale. Les validations récupérées (fetch) s’affichent dans la section Validations entrantes de la fenêtre Référentiel Git. Vous pouvez double-cliquer sur une validation récupérée (fetch) pour afficher ses modifications de fichier.

    Capture d’écran des boutons Récupérer (fetch), Tirer (pull), Envoyer (push) et Synchroniser dans la fenêtre « Modifications Git » de Visual Studio.

  2. Choisissez Tirer (pull) pour fusionner les validations distantes récupérée (fetch) dans votre référentiel local. Tirer (pull) effectue une récupération (fetch), puis fusionne les validations téléchargées dans votre branche locale.

FAQ

Q : Pourquoi la page de connexion diffère-t-elle entre le portail web et Visual Studio ?

R : Votre page de connexion dépend de l’utilisation d’un compte Microsoft ou d’un compte professionnel avec Azure DevOps. Connectez-vous toujours avec le nom d’utilisateur et le mot de passe que vous utilisez pour Azure DevOps.

Q : Puis-je utiliser l’invite de commandes Git avec Visual Studio ?

R : Team Explorer de Visual Studio et la ligne de commande Git fonctionnent ensemble. Les modifications apportées à vos référentiels dans l’un des deux outils seront reflétées dans l’autre. Veillez à installer la dernière version de Git pour Windows, qui dispose d’outils pour vous aider à vous connecter à vos référentiels Azure DevOps Services/TFS.

Pour obtenir de l’aide supplémentaire sur l’utilisation de Git à partir de la ligne de commande, consultez le tutoriel Git Azure Repos et les informations de référence sur les commandes.

Étapes suivantes