Mettre à jour le code avec extraction, fusion et extraction

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

Visual Studio 2019 | Visual Studio 2022

Lorsqu’il existe plusieurs contributeurs à un projet, conservez votre dépôt Git local mis à jour en téléchargeant et en intégrant le travail que d’autres utilisateurs ont chargés dans le dépôt distant du projet. Ces commandes Git mettent à jour votre dépôt local :

• Git récupère les nouvelles validations que d’autres utilisateurs ont chargées dans le dépôt distant. Les branches de suivi à distance dans le cache de référentiel local sont mises à jour : les branches locales restent inchangées.
• La fusion Git intègre des validations d’une ou plusieurs branches sources dans une branche cible.
• Git rebase intègre les validations d’une branche source dans une branche cible, mais utilise une stratégie différente de la fusion Git.
• Git pull effectue une extraction, puis une fusion ou une rebase pour intégrer des validations extraites dans votre branche locale actuelle.

Visual Studio utilise un sous-ensemble de ces commandes Git lorsque vous synchronisez votre dépôt local avec un dépôt distant.

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

Cet article fournit des procédures pour les tâches suivantes :

• Télécharger les modifications avec extraction
• Mettre à jour des branches avec fusion ou rebase
• Télécharger les modifications et mettre à jour les branches avec extraction

Télécharger les modifications avec extraction

Git récupère les validations de branche distante et les objets de fichiers référencés qui n’existent pas dans votre dépôt local et met à jour les branches de suivi à distance dans le cache de référentiel local. Les branches de suivi à distance sont des copies en lecture seule mises en cache localement des branches distantes et ne sont pas vos branches locales. Git fetch ne met pas à jour vos branches locales. Par exemple, si un dépôt distant désigné par origin une branche a une bugfix3 branche, Git fetch met à jour la branche de suivi à distance nommée origin/bugfix3 et non votre branche locale bugfix3 . Vous pouvez utiliser des branches de suivi à distance pour :

• Comparez une branche de suivi à distance avec une branche locale pour examiner les modifications extraites.
• Fusionnez une branche de suivi à distance dans une branche locale.
• Créez une branche locale à partir d’une branche de suivi à distance.

Visual Studio 2022

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 team Explorer . Pour plus d’informations, consultez l’onglet Visual Studio 2019 - Team Explorer .

1. Dans la fenêtre Modifications Git , choisissez Fetch. Sélectionnez ensuite sortant/entrant pour ouvrir la fenêtre Dépôt Git .

   

   Vous pouvez également choisir Fetch dans le menu Git.

   

2. Dans la fenêtre Référentiel Git , les validations extraites s’affichent dans la section Entrante . Sélectionnez une validation extraite pour afficher la liste des fichiers modifiés dans cette validation. Sélectionnez un fichier modifié pour afficher un affichage différent du contenu modifié.

   

Conseil / Astuce

Fetch ne supprime pas les branches de suivi à distance dans votre cache de dépôt local qui n’ont plus d’équivalent distant. Pour configurer Visual Studio afin de nettoyer les branches de suivi à distance obsolètes lors d’une extraction :

• Sélectionnez options Outils>Options>Contrôle de> code sourceParamètres globaux Git.
• Définissez les branches distantes Prune pendant l’option d’extraction sur True.

Visual Studio 2019 - 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 la fenêtre Modifications Git , choisissez Fetch. Sélectionnez ensuite sortant/entrant pour ouvrir la fenêtre Dépôt Git .

   

   Vous pouvez également choisir Fetch dans le menu Git.

   

2. Dans la fenêtre Référentiel Git , les validations extraites s’affichent dans la section Entrante . Sélectionnez une validation extraite pour afficher la liste des fichiers modifiés dans cette validation. Sélectionnez un fichier modifié pour afficher un affichage différent du contenu modifié.

   

Conseil / Astuce

Fetch ne supprime pas les branches de suivi à distance dans votre cache de dépôt local qui n’ont plus d’équivalent distant. Pour configurer Visual Studio afin de nettoyer les branches de suivi à distance obsolètes lors d’une extraction :

• Sélectionnez options Outils>Options>Contrôle de> code sourceParamètres globaux Git.
• Définissez les branches distantes Prune pendant l’option d’extraction sur True.

Visual Studio 2019 - Team Explorer

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 team Explorer . Pour utiliser Team Explorer, décochez Outils>Options>Aperçu fonctionnalités>Nouvelle expérience utilisateur Git dans la barre de menus. Vous pouvez utiliser des fonctionnalités Git à partir de l’une ou l’autre des interfaces de façon interchangeable.

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

   

2. Dans la vue Synchronisation , choisissez Fetch. Les deux boutons Fetch font la même chose. Lors du téléchargement, les validations extraites s’affichent dans la section Validations entrantes .

   

3. Dans la section Validations entrantes , cliquez avec le bouton droit sur une validation, puis choisissez Afficher les détails de validation pour afficher les fichiers modifiés.

   

4. Dans la fenêtre Détails de validation, les fichiers modifiés sont répertoriés dans la section Modifications .

   

   Double-cliquez sur un fichier modifié pour ouvrir une vue différentielle du contenu modifié.

   

Conseil / Astuce

Fetch ne supprime pas les branches de suivi à distance dans votre cache de dépôt local qui n’ont plus d’équivalent distant. Pour configurer Visual Studio afin de nettoyer les branches de suivi à distance obsolètes lors d’une extraction :

• Sélectionnez options Outils>Options>Contrôle de> code sourceParamètres globaux Git.
• Définissez les branches distantes Prune pendant l’option d’extraction sur True.

Ligne de commande Git

Pour télécharger de nouvelles validations à partir d’une branche distante spécifique, exécutez la commande Git fetch :

git fetch <remote repo> <remote branch name>

Pour exécuter git fetch pour toutes les branches distantes, utilisez :

git fetch <remote repo>

Lorsque vous clonez un référentiel distant, Git attribue l’alias origin comme raccourci pour l’URL du référentiel distant que vous avez cloné. Exécutez git remote -v pour vérifier la valeur de l’alias origin . Pour ajouter l’alias origin manuellement, exécutez git remote add origin <remote repo url>. Avec l’alias origin , vous pouvez simplifier la commande Git fetch pour :

git fetch

Pour plus d’informations sur les options de récupération Git, consultez le manuel de référence Git.

Note

Par défaut, git fetch ne supprime pas les branches de suivi à distance dans votre cache de référentiel local qui n’ont plus d’équivalent distant. Pour supprimer les branches de suivi à distance obsolètes, exécutez l’extraction Git avec l’indicateur --prune ou configurez Git pour supprimer les branches de suivi à distance pendant la récupération Git.

Après une extraction Git, vous pouvez comparer une branche locale à sa branche de suivi à distance correspondante pour voir ce qui a changé sur la branche distante. Si vous décidez de mettre à jour votre branche locale actuelle avec des modifications extraites, vous pouvez effectuer une fusion Git ou rebaser. Vous pouvez également exécuter une extraction Git, qui combine une extraction Git avec une fusion Git ou une rebase. La fusion Git et la rebase Git mettent à jour une branche cible en appliquant des validations à partir d’une branche source. Toutefois, la fusion Git et la rebase Git utilisent différentes stratégies. Pour plus d’informations, consultez Mettre à jour les branches avec fusion ou rebasement et Quand rebaser ou fusionner.

Mettre à jour des branches avec fusion ou rebase

La fusion Git et la rebase Git intègrent des validations à partir d’une branche source dans votre branche locale actuelle (branche cible). La fusion Git effectue un transfert rapide ou une fusion sans transfert rapide. La fusion sans transfert rapide est également connue sous le nom de fusion tridirectionnel ou de fusion vraie . La rebase Git est un autre type de fusion. Ces types de fusion sont présentés dans le diagramme suivant.

La fusion Git et la rebase Git sont largement utilisées dans le flux de travail Git. Lors de l’utilisation d’une fonctionnalité locale ou d’une branche de correction de bogues, il est courant de :

1. Conservez votre branche locale main actuelle avec son équivalent distant en extrayant régulièrement pour extraire et fusionner des validations distantes.
2. Intégrez les mises à jour de branche locale main à votre branche de fonctionnalité locale à l’aide d’une nouvelle base ou d’une fusion.
3. Sauvegardez votre travail sur la branche de fonctionnalité locale en le transmettant à la branche distante correspondante.
4. À la fin de la fonctionnalité, créez une demande de tirage pour fusionner votre branche de fonctionnalité distante dans la branche distante main .

Cette approche vous aide à :

• Restez au courant du travail récent par d’autres personnes susceptibles d’affecter votre travail.
• Résolvez rapidement les conflits entre votre travail et celui d’autres personnes.
• Appliquez votre nouvelle fonctionnalité en plus du contenu du projet up-to-date.
• Obtenez une révision de demande de tirage (pull request) de votre travail.

Merge

Pour la fusion Git, si l’extrémité de la branche cible existe dans la branche source, le type de fusion par défaut est une fusion rapide vers l’avant. Sinon, le type de fusion par défaut est une fusion sans transfert rapide.

Une fusion Git à transfert rapide ne peut jamais avoir de conflit de fusion , car Git n’applique pas de fusion rapide si la pointe de la branche cible a divergent de la branche source. Par défaut, Git utilise une fusion rapide dans la mesure du possible. Par exemple, Git applique une fusion rapide sur une branche locale que vous mettez à jour uniquement en extrayant de sa branche distante.

Une fusion Git sans rapidité génère une nouvelle branche cible « validation de fusion » qui intègre les modifications de branche source avec les modifications de branche cible. Les modifications applicables sont celles apportées après la dernière validation commune aux deux branches. Dans le diagramme précédent, la validation C est la dernière validation commune dans les deux branches. Si une modification de branche source est en conflit avec une modification de branche cible, Git vous invite à résoudre le conflit de fusion. La validation de fusion (L) contient les modifications de branche source et de branche cible intégrées. Les conseils de branche source et cible (K et E) sont les parents de la validation de fusion. Dans l’historique de validation de votre branche, une validation de fusion est un marqueur utile pour une opération de fusion et indique clairement quelles branches ont été fusionnées.

La fusion Git modifie uniquement la branche cible. La branche source reste inchangée. Lorsque vous rencontrez un ou plusieurs conflits de fusion, vous devez les résoudre pour terminer la fusion. Vous pouvez également annuler l’opération de fusion et renvoyer la branche cible à son état antérieur.

Pour plus d’informations sur les options et stratégies de fusion, consultez le manuel de référence Git et les stratégies de fusion Git.

Conseil / Astuce

Si la branche source est une branche de suivi à distance, vérifiez que la branche est up-to-date en exécutant une extraction Git avant la fusion.

Visual Studio 2022

1. Choisissez Git > Manage Branches dans la barre de menus pour ouvrir la fenêtre Dépôt Git .

   

2. Dans la fenêtre Dépôt Git , cliquez avec le bouton droit sur la branche cible, puis sélectionnez Extraction.

   

3. Cliquez avec le bouton droit sur la branche source, puis sélectionnez Fusionner <la branche> source dans <la branche> cible.

   

4. Visual Studio affiche un message de confirmation après une fusion réussie.

   

   Si la fusion est interrompue en raison de conflits de fusion, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la fusion et revenir à l’état de pré-fusion.

   

Visual Studio 2019 - Menu Git

1. Choisissez Git > Manage Branches dans la barre de menus pour ouvrir la fenêtre Dépôt Git .

   

2. Dans la fenêtre Dépôt Git , cliquez avec le bouton droit sur la branche cible, puis sélectionnez Extraction.

   

3. Cliquez avec le bouton droit sur la branche source, puis sélectionnez Fusionner <la branche> source dans <la branche> cible.

   

4. Visual Studio affiche un message de confirmation après une fusion réussie.

   

   Si la fusion est interrompue en raison de conflits de fusion, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la fusion et revenir à l’état de pré-fusion.

   

Visual Studio 2019 - Team Explorer

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

   

2. Dans la vue Branches , cliquez avec le bouton droit sur la branche cible, puis sélectionnez Extraction.

   

3. Cliquez avec le bouton droit sur la branche source, puis sélectionnez Fusionner à partir de.

   

4. Vérifiez les options de fusion, puis cliquez sur Fusionner.

   

5. Visual Studio affiche un message de confirmation après une fusion réussie.

   

   S’il existe des conflits pendant la fusion, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la fusion et revenir à l’état de pré-fusion.

   

Ligne de commande Git

Pour intégrer des validations d’une ou plusieurs branches sources à votre branche locale actuelle, exécutez la commande de fusion Git suivante. Pour plusieurs branches sources, séparez leurs noms par des espaces.

git merge <source branch name>

Git vous avertit s’il existe des conflits pendant la fusion. Vous pouvez résoudre les conflits , puis exécuter git merge --continue, ou git merge --abort annuler la fusion et revenir à l’état de pré-fusion.

Rebase

Git rebase resequence l’historique des validations de la branche cible afin qu’elle contienne toutes les validations de branche source, suivie de toutes les validations de branche cible depuis la dernière validation commune. Une autre façon de l’afficher est qu’une rebase Git relecture les modifications apportées à votre branche cible en plus de l’historique des branches sources. Si une modification de branche source est en conflit avec une modification de branche cible, Git vous invite à résoudre le conflit de fusion. La rebase Git ne crée pas de validation de fusion. Notamment, Git rebase change la séquence des validations de branche cible existantes, ce qui n’est pas le cas pour les autres stratégies de fusion. Dans le diagramme précédent, le commit K' contient les mêmes modifications que K, mais a un nouvel ID de validation, car il renvoie à la validation E au lieu de C.

Git rebase uniquement modifie la branche cible. La branche source reste inchangée. Lorsque vous rencontrez un ou plusieurs conflits de fusion, vous devez les résoudre pour terminer la rebase. Vous pouvez également annuler l’opération de rebase et renvoyer la branche cible à son état antérieur.

Si vous êtes la seule personne travaillant sur votre fonctionnalité ou branche de correction de bogues, envisagez d’utiliser git rebase pour intégrer de nouvelles main validations de branche dans celle-ci. Sinon, utilisez la fusion Git. Pour plus d’informations sur la rebase Git et quand l’utiliser, consultez Appliquer des modifications avec rebase et rebase et fusion.

Conseil / Astuce

Si la branche source est une branche de suivi à distance, vérifiez que la branche est up-to-date en exécutant une extraction Git avant la rebase.

Visual Studio 2022

1. Choisissez Git > Manage Branches pour ouvrir la fenêtre Dépôt Git .

   

2. Dans la fenêtre Dépôt Git , cliquez avec le bouton droit sur la branche cible, puis sélectionnez Extraction.

   

3. Cliquez avec le bouton droit sur la branche source, puis sélectionnez Rebase <target-branch> sur <la branche> source.

   

4. Visual Studio affiche un message de confirmation après une nouvelle base réussie.

   

   Si le rebase est arrêté en raison de conflits de fusion, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la rebase et revenir à l’état de pré-rebase.

   

Visual Studio 2019 - Menu Git

1. Choisissez Git > Manage Branches pour ouvrir la fenêtre Dépôt Git .

   

2. Dans la fenêtre Dépôt Git , cliquez avec le bouton droit sur la branche cible, puis sélectionnez Extraction.

   

3. Cliquez avec le bouton droit sur la branche source, puis sélectionnez Rebase <target-branch> sur <la branche> source.

   

4. Visual Studio affiche un message de confirmation après une nouvelle base réussie.

   

   Si le rebase est arrêté en raison de conflits de fusion, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la rebase et revenir à l’état de pré-rebase.

   

Visual Studio 2019 - Team Explorer

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

   

2. Dans la vue Branches , cliquez avec le bouton droit sur la branche cible, puis sélectionnez Extraction.

   

3. Cliquez avec le bouton droit sur la branche source, puis sélectionnez Rebase On.

   

4. Vérifiez les options de rebase, puis cliquez sur Rebase.

   

5. Visual Studio affiche un message de confirmation après une nouvelle base réussie.

   

   S’il y a des conflits pendant la rebase, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la rebase et revenir à l’état de pré-rebase.

   

Ligne de commande Git

Pour intégrer les validations d’une branche source à une branche cible, exécutez la commande de rebase Git :

git rebase <source branch name> <target branch name>

Si votre branche locale actuelle est la branche cible, vous pouvez simplifier la commande de rebase Git sur :

git rebase <source branch name>

Git vous avertit s’il existe des conflits pendant la rebase. Vous pouvez résoudre les conflits , puis exécuter git rebase --continue, ou git rebase --abort annuler la rebase et revenir à l’état de pré-rebase.

Télécharger les modifications et mettre à jour les branches avec extraction

Par défaut, Git pull combine une extraction Git et une fusion Git pour mettre à jour votre branche locale actuelle à partir de son équivalent distant. Si vous le souhaitez, git pull peut effectuer une rebase Git au lieu d’une fusion Git.

Contrairement à Git fetch, Git pull met à jour votre branche locale actuelle immédiatement après le téléchargement de nouveaux commits à partir du dépôt distant. Utilisez git pull lorsque vous savez que vous souhaitez mettre à jour votre branche locale actuelle juste après une extraction Git.

Conseil / Astuce

Pour configurer Visual Studio de manière à rebaser au lieu de fusionner lorsque vous extrayez :

1. Dans le menu Git, accédez auxparamètres globaux git du contrôle > decode source>>.
2. Définissez la branche locale rebase lors de l’extraction de l’optionTrue.

Visual Studio 2022

1. Dans la fenêtre Modifications Git , choisissez Pull.

   

   Vous pouvez également choisir Pull dans le menu Git.

   

2. Un message de confirmation s’affiche une fois l’opération de tirage terminée.

   

   S’il existe des conflits pendant la partie fusion de l’opération d’extraction, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la fusion et revenir à l’état de pré-fusion.

   

Note

Dans Visual Studio, Synceffectue un pull , puis un push pour synchroniser une branche locale et distante. Pour plus d’informations sur la synchronisation, consultez Utiliser git fetch, pull, push et sync pour le contrôle de version dans Visual Studio.

Visual Studio 2019 - Menu Git

1. Dans la fenêtre Modifications Git , choisissez Pull.

   

   Vous pouvez également choisir Pull dans le menu Git.

   

2. Un message de confirmation s’affiche une fois l’opération de tirage terminée.

   

   S’il existe des conflits pendant la partie fusion de l’opération d’extraction, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la fusion et revenir à l’état de pré-fusion.

   

Note

Dans Visual Studio, Synceffectue un pull , puis un push pour synchroniser une branche locale et distante. Pour plus d’informations sur la synchronisation, consultez Utiliser git fetch, pull, push et sync pour le contrôle de version dans Visual Studio.

Visual Studio 2019 - Team Explorer

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

   

2. Dans la vue Synchronisation , choisissez Pull. Les deux boutons Pull font la même chose.

   

3. Visual Studio affiche un message de confirmation une fois l’opération de tirage terminée.

   

   S’il existe des conflits pendant la partie fusion de l’opération d’extraction, Visual Studio vous avertit. Vous pouvez résoudre les conflits ou annuler la fusion et revenir à l’état de pré-fusion.

   

Note

Dans Visual Studio, Synceffectue un pull , puis un push pour synchroniser une branche locale et distante. Pour plus d’informations sur la synchronisation, consultez Utiliser git fetch, pull, push et sync pour le contrôle de version dans Visual Studio.

Ligne de commande Git

Pour utiliser les validations d’extraction et d’intégration d’une branche distante dans la branche de travail actuelle, exécutez la commande pull Git :

git pull <remote repo> <remote branch name>

Si le dépôt distant a une branche portant le même nom que votre branche de travail actuelle, vous pouvez simplifier la commande pull Git pour :

git pull <remote repo>

Lorsque vous clonez un référentiel distant, Git attribue l’alias origin comme raccourci pour l’URL du référentiel distant que vous avez cloné. Exécutez git remote -v pour vérifier la valeur de l’alias origin . Pour ajouter l’alias origin manuellement, exécutez git remote add origin <remote repo url>. Avec l’alias origin , vous pouvez simplifier davantage la commande pull Git pour :

git pull

Pour utiliser une stratégie de rebase pour intégrer des validations d’une branche distante à la branche de travail actuelle, exécutez la commande pull Git avec l’indicateur --rebase . Pour plus d’informations sur les options de tirage Git, consultez le manuel de référence Git.

Conseil / Astuce

Git vous avertit s’il existe des conflits pendant la partie fusion/rebase de l’opération de tirage Git. Ensuite, vous pouvez résoudre les conflits , puis exécuter git merge --continue ou git rebase --continueexécuter git merge --abort ou git rebase --abort annuler la fusion/rebase.

Étapes suivantes

Partager du code avecrésolution push des conflits de fusion

Articles connexes

• Nouveautés des dépôts Git ? Learn more