Vérifier les demandes de tirage (pull requests)

Dans cet article, vous apprendrez comment :

Dans cet article, vous apprendrez comment :

• Les référentiels doivent être activés dans vos paramètres de projet Azure DevOps. 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 passer en revue les demandes de tirage, vous devez être membre du projet Azure DevOps dans lequel se trouve la demande de tirage, avec un niveau d’accès de base ou supérieur.

  • Si vous n’avez pas de projet, créez-en un ou inscrivez-vous gratuitement.

  • Si vous n’êtes pas membre du projet, soyez ajouté.

  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 Repos et les pages associées ne s’affichent pas, consultez Activer ou désactiver un service Azure DevOps pour réactiver Repos.

• Pour passer en revue les demandes de tirage, 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é.

Vous pouvez gérer les demandes de tirage dans Azure DevOps Services à l’aide de l’interface de ligne de commande (CLI) Azure DevOps. L’interface CLI Azure DevOps est disponible lorsque vous installez Azure CLI et l’extension Azure DevOps. Pour obtenir la liste des commandes CLI permettant de gérer les demandes de tirage, consultez les commandes az repos pr.

Les demandes de tirage permettent aux réviseurs désignés d’examiner, de discuter et de voter sur les modifications proposées avant que ces modifications ne soient appliquées à une branche cible d’un référentiel. Gardez à l’esprit que si le développement est effectué avec les mêmes fichiers sur différentes branches, il peut y avoir des modifications conflictuelles. Dans ce cas, il est nécessaire d’analyser et de résoudre soigneusement ces conflits. Pour ce faire, il peut être nécessaire de modifier manuellement le fichier pour appliquer correctement les modifications à partir de la source, de la cible ou des deux branches. La prise de toutes les modifications à partir de la source ou de la cible (qui peut être effectuée en un seul clic) peut ne pas être optimale et entraîner la perte de certaines modifications requises. Cela peut être effectué à l’aide des outils ADO, ou il sera plus pratique d’utiliser des outils de développement (tels que Visual Studio).

Pour plus d’informations, consultez Résoudre les conflits de fusion.

Les étapes suivantes décrivent comment les réviseurs de demandes de tirage dans Azure Repos peuvent parcourir une demande de tirage pour comprendre les modifications proposées :

1. À partir de votre navigateur web, ouvrez le projet d’équipe pour votre organization Azure DevOps. Choisissez Demandes de tirage> de référentiel pour répertorier les demandes de tirage. Une demande de tirage nouvellement ouverte est par défaut sous l’onglet Vue d’ensemble.

2. L’onglet Vue d’ensemble d’une demande de tirage affiche le titre, la description, les réviseurs, les éléments travaillés liés, l’historique, les états et les commentaires. Lisez la description de la demande de tirage pour voir les modifications proposées. Affichez les commentaires pour comprendre les problèmes soulevés par d’autres réviseurs.

   Notes

   Chaque fichier est estimé pour un certain nombre de modifications et est marqué avec un signe « + » ou une étiquette « renommer, modifier » en regard de son nom. Lorsqu’un fichier a plus de 50 % de modifications, il est considéré renommé. Il s’agit du seuil par défaut pour les référentiels Git qui ne peuvent pas être modifiés.

   

3. Sélectionnez l’onglet Fichiers pour passer en revue toutes les modifications de contenu dans la branche source de la demande de tirage. La vue initiale affiche une vue récapitulative de toutes les modifications de fichier. Choisissez le bouton Affichage en regard d’un fichier pour afficher uniquement les modifications de ce fichier. Si le fichier a été modifié, le bouton Affichage ouvre une vue diff. Si le fichier a été ajouté ou supprimé, le bouton Affichage ouvre un volet de contenu.

   

   Notes

   Pour des raisons de performances, la vue récapitulative n’affiche pas les modifications d’un fichier supérieur à 0,5 Mo.

4. Dans une vue diff d’un fichier, vous pouvez sélectionner une disposition côte à côte ou inclus.

   

   Conseil

   Pour tout fichier unique supérieur à 5 Mo, la vue diff affiche le contenu du fichier tronqué. Pour obtenir une vue diff du contenu complet, téléchargez et examinez ces fichiers à l’aide d’un outil de diff local.

   Utilisez l’arborescence de fichiers de gauche pour afficher un autre fichier, ou sélectionnez la racine de l’arborescence de fichiers pour afficher une vue récapitulative de toutes les modifications apportées au fichier.

5. Pour passer en revue l’ensemble de modifications introduit par des push spécifiques à la branche source, sélectionnez un ou plusieurs ensembles de modifications dans la liste déroulante des modifications. Lorsque vous sélectionnez un ou plusieurs ensembles de modifications, le diff afficher les mises à jour pour afficher uniquement les modifications des ensembles de modifications sélectionnés. Cette fonctionnalité est utile lorsque des modifications ont été envoyées à la demande de tirage depuis votre dernière révision et que vous souhaitez simplement voir les nouvelles modifications. La liste déroulante des modifications nomme chaque ensemble de modifications avec le message de validation de la validation finale dans chaque opération push.

   

   Conseil

   Maintenez la touche Maj enfoncée lors de la sélection de plusieurs ensembles de modifications dans la liste déroulante modifications.

6. Choisissez l’onglet Mises à jour pour afficher tous les ensembles de modifications envoyés afin de vous assurer que vous n’avez manqué aucune modification de branche source. Les ensembles de modifications sont numérotés et le jeu de modifications le plus récent apparaît en haut de la liste. Chaque ensemble de modifications affiche les validations qui ont été envoyées dans cette opération push. Un ensemble de modifications envoyé par force ne remplace pas l’historique de l’ensemble de modifications et s’affiche dans la liste des ensembles de modifications identique à tout autre ensemble de modifications.

   

7. Choisissez l’onglet Validations pour afficher l’historique des validations de la branche source après qu’elle a divergé de la branche cible. L’historique des validations dans l’onglet Commits sera remplacé si l’auteur de la demande de tirage envoie (push) un historique de validation différent, les validations affichées dans l’onglet Commits peuvent différer des validations affichées dans l’onglet Mises à jour onglet.

   

Pour donner une image rapide de l’état des demandes de tirage, l’onglet Vue d’ensemble de demande de tirage récapitule les vérifications, les exigences et les stratégies de branche que la demande de tirage passe ou échoue. Dans certains cas, le résumé affiche un extrait de code du message d’échec du journal d’une vérification d’état. La vue d’ensemble répertorie uniquement les stratégies ayant échoué, mais vous pouvez voir toutes les vérifications de stratégie passées et ayant échoué en sélectionnant Afficher <n> vérifications.

Sous l’onglet Vue d’ensemble des demandes de tirage, vous pouvez consulter la description et les commentaires de la demande de tirage pour comprendre les modifications proposées et voir les problèmes soulevés par d’autres réviseurs.

Les auteurs et les réviseurs de demandes de tirage peuvent communiquer entre eux en ajoutant et en répondant aux commentaires de demande de tirage. Lorsque vous passez en revue une demande de tirage, utilisez des commentaires pour signaler les problèmes liés aux modifications proposées, suggérer des modificationset répondre aux commentaires précédents. Visez des commentaires constructifs, précis et faciles à comprendre. Adressez directement les destinataires à l’aide de leur @username. Référencez les éléments de travail à l’aide de #workitemID et d’autres demandes de tirage à l’aide de !pullrequestID. Parfois, les auteurs de demandes de tirage créent des commentaires pour eux-mêmes à des fins de documentation.

Fournir des commentaires dans les commentaires

Si vos commentaires s’appliquent à une ligne ou à une plage de lignes spécifiques dans un fichier, ajoutez un commentaire à cet emplacement dans le fichier :

1. Dans l’onglet Fichiers d’une demande de tirage, pointez sur la ligne sur laquelle vous souhaitez commenter et sélectionnez le bouton de commentaire pour ouvrir une zone de commentaire inlined. Vous pouvez également sélectionner plusieurs lignes, puis sélectionner le bouton de commentaire qui s’affiche lorsque vous pointez sur ces lignes.

   

2. Entrez votre commentaire dans la zone de commentaire, puis choisissez Commentaire.

   

Si vos commentaires s’appliquent à l’ensemble du fichier, ajoutez un commentaire au niveau du fichier en sélectionnant Ajouter un commentaire dans le menu d’options de fichier :

Pour fournir des commentaires généraux non liés à un fichier spécifique, ajoutez un commentaire sous l’onglet Vue d’ensemble :

Les réviseurs de demandes de tirage peuvent également utiliser des commentaires pour suggérer des modifications à des lignes de fichiers spécifiques, comme décrit dans la section suivante.

Suggérer des modifications dans les commentaires

Vous pouvez utiliser des commentaires pour suggérer du texte de remplacement pour une ou plusieurs lignes dans un fichier :

1. Dans l’onglet Fichiers d’une demande de tirage, pointez sur la ligne sur laquelle vous souhaitez commenter et sélectionnez le bouton de commentaire pour ouvrir une zone de commentaire inlined. Vous pouvez également sélectionner plusieurs lignes, puis sélectionner le bouton de commentaire qui s’affiche lorsque vous pointez sur ces lignes. S’il est accepté, votre contenu suggéré remplacera la ou les lignes auxquelles votre commentaire a été ajouté.

   

2. Sélectionnez l’icône d’ampoule sous la zone de commentaire pour apporter les modifications suggérées dans la zone de commentaire d’un bloc de code délimité, puis choisissez Commentaire. Vous ne verrez pas d’icône d’ampoule si vous ajoutez un commentaire au code d’origine (côté gauche) d’une vue diff côte à côte.

   

Les auteurs de demandes de tirage peuvent accepter votre suggestion en :

1. Choisissez Appliquer les modifications pour mettre en scène le changement de préparation à une validation.

   

2. Choisissez Valider toutes les modifications pour valider toutes les modifications intermédiaires. Les auteurs de demande de tirage peuvent annuler une suggestion en choisissant Annuler la modification.

   

Modifier ou supprimer des commentaires

Vous pouvez modifier ou supprimer votre commentaire en pointant sur le commentaire et en choisissant l’icône modifier ou supprimer :

Aimer les commentaires

Les auteurs et les réviseurs de demandes de tirage peuvent aimer leur propre commentaire ou celui de quelqu’un d’autre en pointant sur le commentaire et en choisissant l’icône pouce vers le haut :

Les commentaires avec des j’aime affichent une icône de pouces vers le haut et le nombre de j’aime. Pointez sur l’icône pouce vers le haut pour afficher la liste des personnes qui ont aimé le commentaire.

Répondre aux commentaires

Les auteurs de demandes de tirage doivent répondre aux commentaires pour informer les réviseurs de la façon dont ils répondent aux commentaires et aux suggestions :

1. Pour répondre à un commentaire, tapez votre réponse dans le champ Écrire une réponse. Adressez directement les destinataires à l’aide de leur @username. Référencez les éléments de travail à l’aide de #workitemID et d’autres demandes de tirage à l’aide de !pullrequestID.

   

2. Après avoir entré votre réponse, sélectionnez Répondre et résoudre si votre réponse est finale. Sinon, sélectionnez Répondre.

   

   Si vous sélectionnez Répondre et résoudre, l’état du commentaire passe à Résolu. Les auteurs de demandes de tirage peuvent également modifier directement l’état d’un commentaire, comme décrit dans la section suivante.

Modifier l’état des commentaires

Les nouveaux commentaires ont initialement un état Actif, que les auteurs de demande de tirage mettent à jour pendant le processus de révision pour indiquer comment ils ont traité les commentaires et suggestions des réviseurs. Les auteurs de demande de tirage peuvent sélectionner un état de commentaire dans la liste déroulante d’état :

• Actif : état par défaut pour les nouveaux commentaires.

• En attente : le problème dans ce commentaire est en cours d’examen et attend quelque chose d’autre.

• Résolu : le problème de ce commentaire est résolu.

• Ne sera pas résolu : le problème dans ce commentaire est noté, mais ne sera pas résolu.

• Fermé : la discussion dans ce commentaire est fermée.

Les auteurs et les réviseurs de demandes de tirage peuvent suivre la progression de la demande de tirage en filtrant les états de commentaires, comme décrit dans la section suivante.

Ajoutez des commentaires à une demande de tirage pour faire des suggestions, répondre aux commentaires précédents et signaler les problèmes liés aux modifications proposées.

• Commentaire inline dans l’onglet Fichiers d’une demande de tirage en pointant sur la ligne sur laquelle vous souhaitez commenter et en sélectionnant le bouton commentaire

  

• Envoyez des commentaires non liés à une ligne de code spécifique en commentant l’onglet Vue d’ensemble.

• Adressez l’auteur ou d’autres réviseurs directement dans vos commentaires à l’aide de @username et référencez les éléments de travail à l’aide de #workitemID. Vous pouvez également référencer d’autres demandes de tirage à l’aide de !pullrequestID.

Modifier, supprimer ou aimer un commentaire

Pour modifier ou supprimer votre commentaire, pointez sur le commentaire et sélectionnez l’icône en forme de crayon pour modifier le commentaire ou l’icône de poubelle pour supprimer le commentaire.

Pour aimer votre propre commentaire ou celui d’une autre personne, pointez sur le commentaire et sélectionnez l’icône pouce vers le haut. Les commentaires avec des j’aime affichent une icône remplie et le nombre de likes dans la liste des commentaires. Pointez sur l’icône pour afficher la liste des personnes qui ont aimé le commentaire.

Aimer un commentaire

Pour aimer un commentaire que vous ou quelqu’un d’autre avez fait, sélectionnez l’icône cœur. Pointez sur l’icône dans les commentaires pour afficher la liste des personnes qui ont aimé le commentaire.

Vous pouvez sélectionner les commentaires ou mises à jour affichés sous l’onglet Vue d’ensemble en sélectionnant une option de filtre dans la liste déroulante filtre de commentaires. Par exemple, sélectionnez l’option de filtre Nouveautés pour afficher les nouveaux commentaires et mises à jour depuis la dernière ouverture de la demande de tirage. Chaque option de filtre affiche le nombre d’éléments pour sa catégorie.

Vous pouvez sélectionner les commentaires et mises à jour affichés sous l’onglet Vue d’ensemble. Le fait de masquer certains commentaires et mises à jour les empêche de passer en revue le code pour la première fois. Vous pouvez également afficher uniquement les nouveautés depuis la dernière visite de la demande de tirage.

Pour filtrer les commentaires et les mises à jour, sélectionnez le bouton Tout afficher (n) au-dessus de la liste des commentaires, puis sélectionnez l’une des options de filtrage. La vue change pour afficher uniquement les commentaires et mises à jour sélectionnés. L’étiquette du bouton change pour afficher les critères de filtrage et le nombre d’éléments affichés.

Adresser des commentaires

Vous pouvez effectuer des mises à jour rapides de votre branche directement à partir de l’onglet Fichiers dans Code sur le web.

Répondre et résoudre les commentaires

Répondez aux commentaires et mettez à jour l’état des commentaires pour informer les réviseurs de la façon dont vous traitez leurs commentaires et suggestions.

• Pour résoudre un commentaire sans répondre, sélectionnez Résoudre sous le commentaire.
• Pour répondre au commentaire, tapez votre réponse dans le champ Écrire une réponse, puis sélectionnez Répondre.
• Pour répondre au commentaire et le résoudre, saisissez votre réponse dans le champ Écrire une réponse, puis sélectionnez Répondre et résoudre.
• Répondez à des réviseurs spécifiques en utilisant @username dans la réponse et référencez des éléments de travail à l’aide de #workitemID. Vous pouvez également référencer d’autres demandes de tirage à l’aide de !pullrequestID.

Les nouveaux commentaires commencent dans l’état Actif. Sélectionnez Résoudre ou Répondre et résoudre pour mettre à jour l’état du commentaire sur Résolu.

D’autres options sont disponibles dans la liste déroulante de résolution de commentaires :

• Actif : le commentaire est toujours en cours de révision.
• En attente : le problème dans ce commentaire sera résolu, mais n’est pas encore résolu.
• Résolu : le problème présenté dans ce commentaire est résolu.
• Ne corrigera pas : la suggestion dans le commentaire est notée, mais cette demande de tirage ne la traitera pas.
• Fermé : la discussion de ce commentaire est fermée.

Pour effectuer le suivi des fichiers qui ont déjà été examinés, sélectionnez Plus d’options en regard d’un fichier dans votre demande de tirage, puis sélectionnez Marquer comme étant révisé.

Modifier des fichiers

Pour des raisons pratiques, les auteurs de demandes de tirage peuvent modifier des fichiers directement dans Azure Repos. Par exemple, vous avez peut-être accepté la modification de code suggérée par un réviseur et souhaitez apporter des modifications similaires ailleurs.

1. Choisissez Fichiers >de référentiels, sélectionnez la branche source de demande de tirage, sélectionnez un fichier, puis choisissez Modifier.

   

2. Apportez vos modifications dans l’éditeur, puis choisissez Valider pour ouvrir la boîte de dialogue Valider.

   

3. Dans la boîte de dialogue Valider, modifiez le message de validation si nécessaire, puis choisissez Valider pour valider et envoyer les modifications à votre demande de tirage.

   

Suivre les fichiers examinés

Les réviseurs de demandes de tirage peuvent effectuer le suivi des fichiers révisés en choisissant Marquer comme révisé dans le menu d’options de fichier, ou en cochant la case en regard d’un fichier ou d’un dossier :

Terminer une demande de tirage

Les auteurs de demandes de tirage peuvent sélectionner une option de résolution de demande de tirage :

• Terminer : effectuez la demande de tirage maintenant si tous les réviseurs requis l’ont approuvée et si toutes les stratégies de branche requises sont respectées.

• Définir la saisie semi-automatique : complétez automatiquement la demande de tirage lorsque tous les réviseurs requis l’approuvent et que toutes les stratégies de branche requises sont satisfaites.

• Marquer comme brouillon : définissez la demande de tirage sur l’état brouillon pour indiquer qu’elle n’est pas prête à être examinée. Pour un brouillon de tirage, vous pouvez sélectionner Publier pour supprimer son état brouillon et le marquer prêt pour la révision.

• Abandonner : fermez la demande de tirage. Pour une demande de tirage abandonnée, vous pouvez sélectionner Réactiver pour la restaurer.

Pour plus d’informations sur l’exécution d’une demande de tirage, consultez Terminer la demande de tirage.