Bien démarrer avec Git dans 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. Dans le menu Git de la barre de menu, choisissez Cloner le référentiel...

   

2. Dans la fenêtre Cloner un référentiel, entrez l’emplacement du référentiel distant et le chemin d’accès du dossier du référentiel cloné. Si vous ne connaissez pas l’emplacement du référentiel distant, sélectionnez Azure DevOps dans les options Parcourir un référentiel.

   

3. Sélectionnez Cloner. Une fois que vous avez cloné un référentiel Git, Visual Studio détecte le référentiel et l’ajoute à votre liste de référentiels locaux dans le menu Git.

   

Visual Studio 2019 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.

1. Dans le menu Git de la barre de menu, choisissez Cloner le référentiel...

   

2. Dans la fenêtre Cloner un référentiel, entrez l’emplacement du référentiel distant et le chemin d’accès du dossier du référentiel cloné. Si vous ne connaissez pas l’emplacement du référentiel distant, sélectionnez Azure DevOps dans les options Parcourir un référentiel.

   

3. Sélectionnez Cloner. Une fois que vous avez cloné un référentiel Git, Visual Studio détecte le référentiel et l’ajoute à votre liste de référentiels locaux dans le menu Git.

   

Visual Studio 2019 version 16.8 et versions ultérieures fournit une expérience de contrôle de version Git tout en conservant l’interface utilisateur Git de Team Explorer. Vous pouvez exercer les fonctionnalités Git à partir de l’une ou l’autre interface de manière interchangeable.

1. Dans Team Explorer, sélectionnez Se connecter pour ouvrir la page Se connecter, puis choisissez Gérer les connexions>Se connecter au projet.

   

2. Dans la fenêtre Se connecter à un projet, choisissez le référentiel à cloner et sélectionnez Cloner. Si vous ne voyez pas votre référentiel, sélectionnez Ajouter Azure DevOps Server pour ajouter un serveur qui héberge un référentiel. Vous pouvez filtrer la liste pour rechercher votre référentiel.

   

3. Vérifiez l’emplacement du référentiel cloné sur votre ordinateur, puis sélectionnez Cloner.

1. Téléchargez et installez Git et le Gestionnaire d’informations d’identification Git pour votre plateforme.

2. Ouvrez le portail web Azure DevOps Services dans votre navigateur en accédant à https://<your account name>.visualstudio.com.

3. Ouvrez le portail web Azure DevOps Services dans votre navigateur en accédant à https://<your account name>.visualstudio.com et en trouvant votre référentiel Git. Copiez l’URL de clonage à partir du menu contextuel Clone.

   

   Notes

   Avec Azure DevOps Services, le format de l’URL du projet est dev.azure.com/{your organization}/{your project}. Toutefois, le format précédent qui fait référence au format visualstudio.com est toujours pris en charge. Pour plus d’informations, consultez Présentation d’Azure DevOps, Changer d’organisation existante pour utiliser la nouvelle URL de nom de domaine.

4. À l’invite de commandes, accédez au dossier dans lequel vous souhaitez stocker le code sur votre ordinateur local.

5. À partir de l’invite de commandes, exécutez git clone suivi de l’URL de clonage, comme illustré dans l’exemple suivant.

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   Git télécharge et crée votre propre copie du code dans un nouveau dossier pour vous.

1. Dans le menu Git de la barre de menu, choisissez Nouvelle branche... pour ouvrir la fenêtre Créer une nouvelle branche.

   

2. Dans la fenêtre Créer une nouvelle branche, entrez un nom de branche descriptif pour informer d’autres utilisateurs du travail que contient la branche. Par défaut, Visual Studio crée votre nouvelle branche à partir de votre branche actuelle. La case à cocher Branche de validation vous bascule automatiquement vers la branche créée. Sélectionnez Create (Créer).

   

3. Ajoutez un fichier README.md à votre référentiel cloné. Dans l’Explorateur de solutions, vous pouvez parcourir le contenu du référentiel à l’aide de Affichage du dossier ou ouvrir des solutions Visual Studio dans le référentiel. Git effectue le suivi des modifications apportées à l’intérieur et à l’extérieur de Visual Studio.

4. Lorsque vous êtes satisfait de vos modifications, enregistrez-les dans Git à l’aide d’une validation. Dans la fenêtre Modifications Git, entrez un message qui décrit les modifications, puis sélectionnez 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 dans la fenêtre Modifications Git.

   

   Sélectionnez le lien d’informations de validation pour obtenir plus d’informations sur la validation.

   

1. Dans le menu Git de la barre de menu, choisissez Nouvelle branche... pour ouvrir la fenêtre Créer une nouvelle branche.

   

2. Dans la fenêtre Créer une nouvelle branche, entrez un nom de branche descriptif pour informer d’autres utilisateurs du travail que contient la branche. Par défaut, Visual Studio crée votre nouvelle branche à partir de votre branche actuelle. La case à cocher Branche de validation vous bascule automatiquement vers la branche créée. Sélectionnez Create (Créer).

   

3. Ajoutez un fichier README.md à votre référentiel cloné. Dans l’Explorateur de solutions, vous pouvez parcourir le contenu du référentiel à l’aide de Affichage du dossier ou ouvrir des solutions Visual Studio dans le référentiel. Git effectue le suivi des modifications apportées à l’intérieur et à l’extérieur de Visual Studio.

4. Lorsque vous êtes satisfait de vos modifications, enregistrez-les dans Git à l’aide d’une validation. Dans la fenêtre Modifications Git, entrez un message qui décrit les modifications, puis sélectionnez 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 dans la fenêtre Modifications Git.

   

   Sélectionnez le lien d’informations de validation pour obtenir plus d’informations sur la validation.

   

1. Dans Team Explorer, sélectionnez le bouton Accueil et choisissez Branches.

   

2. Faites un clic droit sur la branche par défaut, souvent nommée main, puis choisissez Nouvelle branche locale à partir de...

   

3. Entrez un nom de branche descriptive pour informer d’autres utilisateurs du travail que contient la branche. Sélectionnez Créer une branche.

   

4. Ajoutez un fichier README.md à votre référentiel cloné. Dans l’affichage Accueil de Team Explorer, vous pouvez parcourir le contenu du référentiel à l’aide de Montrer l’affichage du dossier ou ouvrir des solutions Visual Studio dans le référentiel. Git effectue le suivi des modifications apportées à l’intérieur et à l’extérieur de Visual Studio.

5. Lorsque vous êtes satisfait de vos modifications, enregistrez-les dans Git à l’aide d’une validation. Ouvrez l’affichage Modifications de Team Explorer en sélectionnant le bouton Accueil et en choisissant Modifications.

   

6. Entrez un message qui décrit la validation, puis sélectionnez Tout valider.

   

1. Créez une branche dans laquelle vous apportez vos modifications au code. Si vous collaborez avec une personne utilisant une branche qu’elle a créée, vous pouvez passer à l’étape git checkout suivante.

    > git branch ReadMeFix
   

   Choisissez un nom de branche descriptif pour votre travail afin de vous rappeler, ainsi qu’aux autres, quel type de travail se trouve dans la branche.

2. Extrayez votre branche pour commencer à travailler dans cette branche.

    > git checkout ReadMeFix
   

   Vous pouvez également utiliser la commande checkout pour commencer à travailler sur une branche dans laquelle d’autres membres de l’équipe travaillent déjà.

3. Apportez des modifications à l’aide de vos outils favoris sur le code.

4. Lorsque vous êtes satisfait des modifications, même si vous n’êtes pas prêt à partager le travail, enregistrez-les dans Git à l’aide d’une validation. Vos modifications ne seront pas partagées tant que vous ne les envoyez (push) pas, comme décrit dans la section suivante.

    > git commit -a -m "Descriptive message"
   

   Cette commande enregistre vos modifications localement dans une nouvelle validation dans Git. Veillez à donner à la validation un message court qui décrit vos modifications après -m.

1. Dans la fenêtre Modifications Git, sélectionnez le bouton d’envoi (push) de la flèche vers le haut pour envoyer votre validation.

   

   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.

   

   Vous pouvez également envoyer (push) vos modifications à partir du menu Git de la barre de menus.

   

2. Créez une demande de tirage afin que d’autres personnes puissent passer en revue vos modifications. Si vous venez d’envoyer (push) vos modifications à partir de la fenêtre Modifications Git, vous pouvez sélectionner le lien Créer une demande de tirage pour ouvrir un navigateur web dans lequel vous pouvez créer une nouvelle demande de tirage dans le portail web Azure Repos.

   

   Ou, si vous venez d’envoyer (push) vos modifications à partir de la fenêtre Référentiel Git, vous pouvez sélectionner le lien Créer une demande de tirage en haut de cette fenêtre.

   

   Vous pouvez également faire un clic droit sur n’importe quelle branche dans la fenêtre Référentiel Git, puis sélectionner Créer une demande de tirage.

   

Lorsque la demande de tirage s’ouvre dans le portail web Azure Repos, vérifiez vos branches source et de destination. Dans cet exemple, nous voulons fusionner les validations de la branche add-readme-file vers la branche main. Entrez un titre et une description facultative, spécifiez tous les réviseurs, associez éventuellement tous les éléments de travail, puis sélectionnez Créer.

Pour plus d’informations sur les demandes de tirage, consultez le tutoriel sur les Demandes de tirage.

1. Dans la fenêtre Modifications Git, sélectionnez le bouton d’envoi (push) de la flèche vers le haut pour envoyer votre validation.

   

   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.

   

   Vous pouvez également envoyer (push) vos modifications à partir du menu Git de la barre de menus.

   

2. Créez une demande de tirage afin que d’autres personnes puissent passer en revue vos modifications. Si vous venez d’envoyer (push) vos modifications à partir de la fenêtre Modifications Git, vous pouvez sélectionner le lien Créer une demande de tirage pour ouvrir un navigateur web dans lequel vous pouvez créer une nouvelle demande de tirage dans le portail web Azure Repos.

   

   Ou, si vous venez d’envoyer (push) vos modifications à partir de la fenêtre Référentiel Git, vous pouvez sélectionner le lien Créer une demande de tirage en haut de cette fenêtre.

   

   Vous pouvez également faire un clic droit sur n’importe quelle branche dans la fenêtre Référentiel Git, puis sélectionner Créer une demande de tirage.

   

Lorsque la demande de tirage s’ouvre dans le portail web Azure Repos, vérifiez vos branches source et de destination. Dans cet exemple, nous voulons fusionner les validations de la branche add-readme-file vers la branche main. Entrez un titre et une description facultative, spécifiez tous les réviseurs, associez éventuellement tous les éléments de travail, puis sélectionnez Créer.

Pour plus d’informations sur les demandes de tirage, consultez le tutoriel sur les Demandes de tirage.

1. Dans Team Explorer, sélectionnez Accueil, puis cliquez sur Synchroniser pour ouvrir Synchronisation.

   

   Vous pouvez également accéder à la vue Synchronisation à partir de Modifications en choisissant Synchroniser immédiatement après avoir effectué une validation.

   

2. Dans l’affichage Synchronisation, choisissez Envoyer (push) pour charger votre validation dans le référentiel distant. S’il s’agit de votre premier envoi (push) vers le référentiel, vous verrez le message : The current branch does not track a remote branch..., qui vous indique que votre validation a été envoyée (push) à une nouvelle branche sur le référentiel distant et que les validations ultérieures envoyées (push) à partir de la branche actuelle seront chargées vers cette branche distante.

   

3. Créez une demande de tirage afin que d’autres personnes puissent passer en revue vos modifications. Ouvrez Demande de tirage dans Team Explorer en sélectionnant Accueil et en choisissant Demandes de tirage.

   

4. Dans Demandes de tirage, vous pouvez afficher les demandes de tirage que vous avez ouvertes, qui vous ont été attribuées, et vous pouvez créer des demandes de tirage. Sélectionnez Nouvelle demande de tirage pour ouvrir un navigateur web dans lequel vous pouvez créer une nouvelle demande de tirage dans le portail web Azure Repos.

   

Lorsque la demande de tirage s’ouvre dans le portail web Azure Repos, vérifiez vos branches source et de destination. Dans cet exemple, nous voulons fusionner les validations de la branche add-readme-file vers la branche main. Entrez un titre et une description facultative, spécifiez tous les réviseurs, associez éventuellement tous les éléments de travail, puis sélectionnez Créer.

Pour plus d’informations sur les demandes de tirage, consultez le tutoriel sur les Demandes de tirage.

1. Envoyez (push) votre branche pour que d’autres personnes puissent voir les modifications que vous avez enregistrées.

    > git push -u origin ReadMeFix
   

2. Ouvrez le projet dans le portail web et accédez à votre référentiel dans l’onglet Code. Sélectionnez Créer une demande de tirage pour créer une demande de tirage pour la branche que vous avez envoyée (push).

   

3. Vérifiez vos branches. Dans cet exemple, nous voulons fusionner les validations de la branche ReadMeFix dans la branche main. Entrez un titre et une description facultative, spécifiez tous les réviseurs, associez éventuellement tous les éléments de travail et sélectionnez Créer.

   

4. Une fois les modifications approuvées, terminez la demande de tirage. Une demande de tirage complète ajoute vos modifications de la branche dans la branche primaire du code.

   Pour plus d’informations sur les demandes de tirage, consultez le tutoriel sur les demandes de tirage.

Dans la fenêtre Modifications Git, vous pouvez maintenir votre branche locale à jour avec son équivalent distant à l’aide des boutons Récupérer (fetch), Tirer (pull), Envoyer (push) et Synchroniser.

De gauche à droite dans la capture d’écran précédente, les contrôles bouton sont les suivants :

• Récupérer (fetch) télécharge les validations distantes qui ne sont pas dans votre branche locale, mais ne les fusionne pas.
• Tirer (pull) effectue une récupération (fetch), puis fusionne les validations téléchargées dans votre branche locale.
• L’envoi (push) charge vos validations non bloquées dans le référentiel distant, ce qui les ajoute à la branche distante correspondante.
• La synchronisation effectue un Tirage (pull), puis un Envoi (push).

Vous pouvez également sélectionner Récupérer (fetch), Tirer (pull), Envoyer (push) et Synchroniser dans le menu Git.

Dans la fenêtre Modifications Git, vous pouvez maintenir votre branche locale à jour avec son équivalent distant à l’aide des boutons Récupérer (fetch), Tirer (pull), Envoyer (push) et Synchroniser.

De gauche à droite dans la capture d’écran précédente, les contrôles bouton sont les suivants :

• Récupérer (fetch) télécharge les validations distantes qui ne sont pas dans votre branche locale, mais ne les fusionne pas.
• Tirer (pull) effectue une récupération (fetch), puis fusionne les validations téléchargées dans votre branche locale.
• L’envoi (push) charge vos validations non bloquées dans le référentiel distant, ce qui les ajoute à la branche distante correspondante.
• La synchronisation effectue un Tirage (pull), puis un Envoi (push).

Vous pouvez également sélectionner Récupérer (fetch), Tirer (pull), Envoyer (push) et Synchroniser dans le menu Git.

1. Dans Team Explorer, sélectionnez Accueil et choisissez Synchroniser pour ouvrir Synchronisation.

   

2. Vous pouvez télécharger les dernières modifications apportées à votre branche à l’aide du lien Tirer (pull). Il existe deux liens Tirer (pull), l’un en haut de la page et l’autre dans la section Validations entrantes. Vous pouvez utiliser l’un ou l’autre, car ils font tous les deux la même chose.

   

1. Passez à la branche dans laquelle vous souhaitez télécharger les modifications apportées par d’autres personnes.

    > git checkout ReadMeFix
   

   Dans cet exemple, vous tirez (pull) les modifications apportées par d’autres personnes de votre équipe à la branche ReadMeFix vers votre copie locale de la branche.

2. Tirez (pull) les modifications apportées par d’autres personnes à votre branche locale.

    > git pull
   

   Git télécharge les modifications et les fusionne avec vos propres modifications dans votre branche locale.