Révision d'une pull request

Vous pouvez utiliser la CodeCatalyst console Amazon pour examiner et commenter de manière collaborative les modifications incluses dans une pull request. Vous pouvez ajouter des commentaires à des lignes de code individuelles en faisant la différence entre les branches source et destination, ou en fonction de la différence entre les révisions de la pull request. Vous pouvez choisir de créer un résumé des commentaires laissés sur les modifications de code dans la pull request afin de vous aider à comprendre rapidement les commentaires laissés par les autres utilisateurs. Vous pouvez également choisir de créer un environnement de développement pour travailler sur le code.

Note

Note

Propulsé par Amazon Bedrock : AWS implémente la détection automatique des abus. Étant donné que les fonctionnalités Rédiger une description pour moi, Créer un résumé du contenu, recommander des tâches, utiliser Amazon Q pour créer ou ajouter des fonctionnalités à un projet et Attribuer des problèmes à Amazon Q avec Amazon Q Developer Agent pour les fonctionnalités de développement logiciel sont basées sur Amazon Bedrock, les utilisateurs peuvent tirer pleinement parti des contrôles mis en œuvre dans Amazon Bedrock pour renforcer la sûreté, la sécurité et l'utilisation responsable de l'intelligence artificielle (IA).

Astuce

Vous pouvez configurer les événements de pull request pour lesquels vous recevrez des e-mails dans le cadre de votre profil. Pour plus d’informations, consultez Envoi de notifications par Slack et par e-mail depuis CodeCatalyst.

Les pull requests indiquent quelle sera la différence entre la révision de la pull request et le commit qui figurait au début de la branche de destination lorsque vous avez créé la pull request. C'est ce qu'on appelle la base de fusion. Pour plus d'informations sur les différences et les bases de fusion dans Git, consultez git-merge-basela documentation Git.

Astuce

Lorsque vous travaillez dans la console, en particulier si une pull request est ouverte depuis un certain temps, pensez à actualiser votre navigateur pour vous assurer que vous disposez de la dernière version disponible pour une pull request avant de commencer à la consulter.

Pour consulter une pull request dans la CodeCatalyst console

1. Accédez à votre projet.

2. Accédez aux pull requests en effectuant l'une des opérations suivantes :

   • Si la pull request est répertoriée sur la page du projet, choisissez-la dans la liste.

   • Si la pull request n'est pas répertoriée sur la page du projet, choisissez Afficher tout. Utilisez les filtres et triez pour trouver la pull request, puis choisissez-la dans la liste.

   • Dans le volet de navigation, choisissez Code, puis choisissez Pull requests.

3. Choisissez la pull request que vous souhaitez consulter dans la liste. Vous pouvez filtrer la liste des pull requests en saisissant une partie de son nom dans la barre de filtre.

4. Dans Vue d'ensemble, vous pouvez consulter le nom et le titre de la pull request. Vous pouvez créer et consulter les commentaires laissés sur la pull request elle-même. Vous pouvez également consulter les détails de la pull request, y compris les informations sur les exécutions du flux de travail, les problèmes liés, les réviseurs, l'auteur de la pull request et les stratégies de fusion réalisables.

   Note

   Les commentaires laissés sur des lignes de code spécifiques apparaissent dans Modifications.

5. (Facultatif) Pour ajouter un commentaire qui s'applique à l'intégralité de la pull request, développez Commentaires sur la pull request, puis choisissez Create comment.

6. (Facultatif) Pour afficher un résumé de tous les commentaires laissés concernant les modifications apportées aux révisions de cette pull request, choisissez Créer un résumé des commentaires.

   Note

   Cette fonctionnalité nécessite que les fonctionnalités d'IA générative soient activées pour l'espace et n'est disponible que dans la région ouest des États-Unis (Oregon). Pour plus d'informations, consultez la section Gestion des fonctionnalités d'IA générative.

7. Dans Changes, vous pouvez voir les différences entre la branche de destination et la version la plus récente de la pull request. S'il existe plusieurs révisions, vous pouvez modifier la différence entre les révisions comparées. Pour plus d'informations sur les révisions, consultezRévisions.

   Astuce

   Vous pouvez rapidement voir combien de fichiers ont été modifiés dans la pull request, et quels fichiers de la pull request contiennent des commentaires, dans Fichiers modifiés. Le nombre de commentaires affichés à côté d'un dossier indique le nombre de commentaires sur les fichiers de ce dossier. Développez le dossier pour afficher le nombre de commentaires pour chaque fichier qu'il contient.

8. Pour modifier la façon dont les différences sont affichées, choisissez entre Unified et Split.

9. Pour ajouter un commentaire à une ligne de la pull request, rendez-vous sur la ligne que vous souhaitez commenter. Choisissez l'icône de commentaire qui apparaît pour cette ligne, entrez un commentaire, puis choisissez Enregistrer.

10. Pour afficher les modifications entre les révisions d'une pull request, ou entre ses branches source et de destination, choisissez l'une des options disponibles dans Comparing. Les commentaires sur les lignes des révisions sont conservés dans ces révisions.

11. Si vous avez configuré votre flux de travail pour générer un rapport de couverture de code sur les déclencheurs de pull request, vous pouvez consulter les résultats de couverture des lignes et des succursales dans la pull request correspondante. Pour masquer les résultats relatifs à la couverture du code, choisissez Masquer la couverture du code. Pour plus d’informations, consultez Rapports sur la couverture du code.

12. Si vous souhaitez modifier le code de la pull request, vous pouvez créer un environnement de développement à partir de la pull request. Choisissez Create Dev Environment. Ajoutez éventuellement un nom pour l'environnement de développement ou modifiez sa configuration, puis choisissez Create.

13. Dans Rapports, vous pouvez consulter les rapports de qualité contenus dans cette pull request. S'il existe plusieurs révisions, vous pouvez modifier la différence entre les révisions comparées. Vous pouvez filtrer les rapports par nom, statut, flux de travail, action et type.

    Note

    Un flux de travail doit être configuré pour générer des rapports afin qu'ils apparaissent dans vos pull requests. Pour plus d’informations, consultez Configuration des rapports de qualité dans une action.

14. Pour consulter un rapport spécifique, sélectionnez-le dans la liste. Pour plus d’informations, consultez Tests avec des flux de travail.

15. Si vous êtes répertorié comme réviseur de cette pull request et que vous souhaitez approuver les modifications, assurez-vous de consulter la révision la plus récente, puis choisissez Approuver.

    Note

    Tous les réviseurs requis doivent approuver une pull request avant de pouvoir la fusionner.