Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Vous créez des demandes de tirage (PR) pour passer en revue et fusionner les modifications de code dans un Référentiel Git sur Azure Repos. Les membres de l’équipe et les parties prenantes peuvent examiner les modifications et envoyer des commentaires avant de fusionner le code dans la branche cible. Les réviseurs peuvent également commenter les modifications et voter pour approuver ou rejeter le code.
Les équipes peuvent exiger des demandes de tirage pour toute modification apportée aux branches protégées, et définir des stratégies de branche pour exiger que certaines demandes de tirage répondent à des critères spécifiques.
Il existe plusieurs façons de répertorier, de filtrer, d’afficher et d’ouvrir des demandes de tirage pour un projet.
Conditions préalables
Les dépôts doivent être activés sur votre projet. Si le hub Repos et les pages associées ne s’affichent pas, consultez Activer ou désactiver un service Azure DevOps pour réactiver Repos.
Pour afficher les demandes de tirage, vous devez être membre du projet Azure DevOps où se trouve la demande de tirage, avec au moins un accès de base. Si vous n’êtes pas membre du projet, soyez ajouté.
Remarque
Pour les projets publics, les utilisateurs disposant de l'accès partie prenante ont un accès complet à Azure Repos.
Les dépôts doivent être activés sur votre projet. Si le hub Repos et les pages associées ne s’affichent pas, consultez Activer ou désactiver un service Azure DevOps pour réactiver Repos.
Pour afficher des demandes de tirage, vous devez être membre du projet Azure DevOps avec au moins un accès de base. Si vous n’êtes pas membre du projet, soyez ajouté.
Dans Azure DevOps Services, vous pouvez gérer les demandes de tirage et d’autres ressources à partir de l’interface de ligne de commande (CLI) Azure avec l’extension azure-devops. Pour savoir comment utiliser l’interface CLI Azure DevOps Services, consultez Prise en main d’Azure DevOps CLI. Les commandes d’interface de ligne de commande Azure Repos pour les demandes de tirage utilisent az repos pr.
Lister les demandes de tirage
Vous pouvez répertorier les demandes de tirage à l’aide du site web du projet Azure DevOps, de Visual Studio ou de la ligne de commande Azure DevOps.
Pour répertorier les demandes de tirage d’un référentiel spécifique d’un projet, accédez à ce projet dans le portail web et sélectionnez Référentiels>Demandes de tirage.
Vérifiez que vous avez sélectionné le référentiel approprié.
La vue par défaut affiche vos PR sous l'onglet Mine. Sélectionnez Active pour afficher tous les PR actifs pour le référentiel actuel. Sélectionnez Terminé ou Abandonné pour afficher des listes de demandes de tirage fermées.
Sélectionnez n’importe quelle demande de tirage dans la liste pour accéder à la page Vue d’ensemble de cette demande de tirage.
Vous pouvez répertorier toutes vos demandes de tirage sur différents projets dans votre organisation en choisissant Demandes de tirage dans l’affichage Mon travail.
Pour répertorier les demandes de tirage à partir de Visual Studio, dans le menu Git, sélectionnez <votre service Git>>Afficher les demandes de tirage.
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 Team Explorer Git. Pour utiliser Team Explorer, décochez Outils>Options>Fonctionnalités en préversion>Nouvelle expérience utilisateur Git dans la barre de menus. Vous pouvez exercer des fonctionnalités Git à partir de l’une ou l’autre des interfaces de manière interchangeable.
Pour accéder aux demandes de tirage à partir de Visual Studio Team Explorer :
URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=<ORG_URL>. obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration Git. Exemple : https://dev.azure.com/MyOrganizationName/.
--project-p
Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=<NAME_OR_ID>. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration Git.
--query-examples
Chaîne JMESPath recommandée. Vous pouvez copier l’une des requêtes et la coller après le paramètre --query entre guillemets doubles pour afficher les résultats. Vous pouvez ajouter un ou plusieurs mots clés positionnels afin que les suggestions soient basées sur ces mots clés.
--repository-r
Nom ou ID du référentiel.
--reviewer
Limitez les résultats aux demandes de tirage pour lesquelles cet utilisateur est un réviseur.
--skip
Nombre de pull requests à ignorer.
--source-branch-s
Limitez les résultats aux pull requests provenant de cette branche source.
--status
Limitez les résultats aux demandes de tirage avec cet état. Valeurs acceptées : abandoned, active, all, completed.
--subscription
Nom ou ID de l’abonnement Azure. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s <NAME_OR_ID>.
--target-branch-t
Limitez les résultats aux demandes de tirage qui ciblent cette branche.
--top
Nombre maximal de demandes de tirage à lister.
Exemple
La commande suivante répertorie toutes les demandes de tirage dans le référentiel, quel que soit l’état et affiche la sortie dans un tableau. L’exemple utilise la configuration par défaut az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".
az repos pr list --status all --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------------------------- --------- --------- ------------
11 2021-10-04 jamalh@fabrikam.com Revert 'Updated parameterized-functions.md' Completed False Fabrikam
10 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Completed False Fabrikam
9 2021-10-04 ke@fabrikam.com New pull request Completed False Fabrikam
8 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Abandoned False Fabrikam
7 2021-09-30 jamalh@fabrikam.com Added note-new-git-tool.md to / Completed False Fabrikam
6 2021-09-29 jamalh@fabrikam.com Revert 'Added parameterized-functions.md to /' Abandoned False Fabrikam
5 2021-09-29 jamalh@fabrikam.com Updated README.md Completed False Fabrikam
4 2021-09-29 jamalh@fabrikam.com Added parameterized-functions.md to / Completed False Fabrikam
3 2021-09-28 jamalh@fabrikam.com WIP New file Abandoned False Fabrikam
2 2021-09-28 jamalh@fabrikam.com Update README.md Abandoned False Fabrikam
1 2021-09-28 jamalh@fabrikam.com Edit README.md Completed False Fabrikam
Les commandes AZURE DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.
Définir une vue personnalisée de pull request
Le filtrage de la liste des demandes de tirage vous permet de rechercher et d’organiser les demandes de tirage pour hiérarchiser les fichiers les plus importants dans votre flux de travail.
Pour filtrer la liste de demande de tirage, dans la page Demandes de tirage, sélectionnez l’icône Filtrer en haut à droite. Sélectionnez ensuite branche cible ou un autre en-tête de colonne, puis sélectionnez la branche ou une autre valeur sur laquelle vous souhaitez filtrer.
Pour personnaliser davantage votre affichage de la liste des demandes de tirage, sélectionnez Personnaliser l’affichage en haut à droite de la page Demandes de tirage.
Dans la Personnaliser l’affichage page, vous pouvez réorganiser les sections d’affichage actuelles, les modifier ou les supprimer. Pour créer une section, sélectionnez Ajouter une section.
Dans la page Personnaliser la section, entrez et sélectionnez des valeurs pour filtrer la section par paramètres tels que l’état brouillon ou la date de mise à jour. Vous pouvez choisir de Afficher les demandes de tirage que j’ai approuvées ou rejetées sous un onglet distinct, ou Exclure les demandes de tirage (doublons) incluses dans les sections précédentes. Lorsque vous avez terminé la personnalisation de l’affichage, sélectionnez Enregistrer.
Ces vues personnalisées créent des sections distinctes, rétractables sur la page de pull request. Ces requêtes personnalisées fonctionnent également entre les référentiels dans l’onglet Mes demandes de tirage de la page d’accueil de l’organisation.
Pour modifier les paramètres des vues personnalisées, sélectionnez le bouton Personnaliser en regard de l’affichage. Vous pouvez également sélectionner Personnaliser l’affichage, puis, dans l’écran Personnaliser l’affichage, sélectionnez l’affichage que vous souhaitez modifier. Certaines vues, comme Assignées à moi, ne peuvent pas être personnalisées, mais elles peuvent être réorganisées ou supprimées.
Dans un onglet Fichiers de demande de tirage, vous pouvez utiliser plusieurs filtres pour sélectionner des fichiers et des commentaires afin d’accélérer les révisions. Sélectionnez filtre, puis sélectionnez parmi les options.
Mot clé : entrez un mot clé.
Révisé/Non révisé : Tous (par défaut), En attente, Révisé.
Fichiers commentés : Tous les fichiers (valeur par défaut), Fichiers avec des commentaires.
Commentaires : Afficher (valeur par défaut), Nouveautés, Masquer.
État des commentaires : actif (valeur par défaut), en attente , résolu , Comme conçu, Ne corrige pas, Fermé.
Commenté par : tous les commentaires (par défaut) ou une personne spécifique.
Vous pouvez également taper une chaîne dans le champ de recherche pour afficher les résultats correspondants des options précédentes.
Pour filtrer les pull requests depuis Visual Studio :
Dans le menu Git, sélectionnez <votre service Git>>Afficher les Pull Requests.
Filtrez par Author, Labelou d’autres attributs.
À partir de l’affichage Demandes de tirage de Team Explorer :
Sélectionnez Actif, ou Assigné à moi ou à mon équipe, pour filtrer les listes des PR par statut ou assignation.
Vous pouvez également saisir les champs Taper ici pour filtrer les listes afin de filtrer les listes de demande de tirage en fonction de la date, de l’auteur, de la branche ou d’autres attributs.
Vous pouvez utiliser plusieurs paramètres az repos pr list pour filtrer la liste des demandes de tirage, tels que --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branch, et --top.
Les valeurs --creator et --reviewer peuvent être des noms d’affichage ou des adresses e-mail. Le paramètre --top définit le nombre maximal de PRs à répertorier.
Par exemple, pour répertorier les détails sur la dernière demande de tirage que vous avez créée, quel que soit son état, utilisez :
az repos pr list --creator "My Name" --status all --top 1
Les commandes AZURE DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.
Ouvrir une pull request
Lorsque vous ouvrez une demande de tirage à partir du navigateur, de Visual Studio ou d’Azure CLI, la page Vue d’ensemble de la demande de tirage s’ouvre dans le navigateur.
Pour ouvrir une demande de tirage dans le navigateur, sélectionnez la demande de tirage dans la liste de la page Demandes de tirage. La demande de tirage s’ouvre dans son onglet Vue d’ensemble. L’onglet Vue d’ensemble affiche le titre, la description, les réviseurs, les éléments travaillés liés, l’historique et l’état. Vous pouvez voir un résumé des stratégies de branche qui passent ou échouent, et voir les commentaires que les réviseurs ont faits.
Dans l’onglet Fichiers de demande de tirage, vous pouvez passer en revue les modifications réelles dans les fichiers de demande de tirage. Dans les onglets Mises à jour et Validations, vous pouvez voir les modifications apportées par l’auteur pour mettre à jour la branche de demande de tirage.
Pour ouvrir une demande de tirage à partir de Visual Studio, dans le menu Git, sélectionnez <votre service Git>>Afficher les demandes de tirage, puis sélectionnez une demande de tirage pour l’ouvrir.
Ou, dans l’affichage Demandes de tirage de Team Explorer, faites un clic droit sur la demande de tirage et sélectionnez Ouvrir dans le navigateur pour ouvrir la demande de tirage dans le portail web.
Extrayez une branche
Dans Visual Studio 2019, vous pouvez extraire la branche source d’une demande de tirage directement à partir de l’affichage Demandes de tirage. Faites un clic droit sur une demande de tirage, puis choisissez Branche source de la validation.
Remarque
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.
Pour afficher les détails d’une seule demande de tirage, utilisez az repos pr show avec le paramètre --id requis. Pour ouvrir le PR dans votre navigateur, utilisez --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=<ORG_URL>. obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration Git. Exemple : https://dev.azure.com/MyOrganizationName/.
--query-examples
Chaîne JMESPath recommandée. Vous pouvez copier l’une des requêtes et la coller après le paramètre --query entre guillemets doubles pour afficher les résultats. Vous pouvez ajouter un ou plusieurs mots clés positionnels afin que les suggestions soient basées sur ces mots clés.
--subscription
Nom ou ID de l’abonnement Azure. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s <NAME_OR_ID>.
Exemple
L’exemple suivant montre les détails de la demande de tirage #21, affiche la sortie de commande sous forme de tableau et ouvre la demande de tirage dans le navigateur :
az repos pr show --id 21 --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
21 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
Extrayez une branche
Utilisez Validation de demande de tirage az repos avec le paramètre requis --id pour extraire une branche de demande de tirage localement, tant qu’il n’y a pas de modifications locales.
az repos pr checkout --id
[--remote-name]
[--subscription]
Paramètres
Paramètre
Description
--id
ID de la demande de tirage.
--remote-name
Nom de dépôt distant git sur lequel la demande de tirage est effectuée. Valeur par défaut : origin.
--subscription
Nom ou ID de l’abonnement Azure. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s <NAME_OR_ID>.
Exemple
Par exemple, pour extraire la branche pour la demande de tirage #21 localement, utilisez :
az repos pr checkout --id 21
Les commandes AZURE DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.
Pour passer en revue les modifications, faire des commentaires ou des suggestions, ou approuver ou voter sur la demande de tirage, consultez Passer en revue les demandes de tirage.
Afficher et mettre à jour les pull requests depuis un appareil mobile
Vous pouvez utiliser des appareils mobiles pour afficher tous les écrans de demande de tirage Azure Repos et prendre des mesures.