Révision du code avec des pull requests sur Amazon CodeCatalyst - Amazon CodeCatalyst

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Révision du code avec des pull requests sur Amazon CodeCatalyst

Une pull request est le principal moyen pour vous et les autres membres du projet de consulter, commenter et fusionner les modifications de code d'une branche à l'autre. Vous pouvez utiliser des pull requests pour examiner les modifications de code de manière collaborative afin de détecter des modifications ou des correctifs mineurs, des ajouts de fonctionnalités majeures ou de nouvelles versions de vos logiciels publiés. Si vous utilisez les problèmes pour suivre le travail sur votre projet, vous pouvez associer des problèmes spécifiques aux pull requests pour vous aider à suivre les problèmes résolus par les modifications de code apportées dans la pull request. Lorsque vous créez, mettez à jour, commentez, fusionnez ou fermez une pull request, un e-mail est automatiquement envoyé à l'auteur de la pull request ainsi qu'à tous les réviseurs requis ou facultatifs pour la pull request.

Astuce

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

Les pull requests nécessitent deux branches dans un référentiel source : une branche source contenant le code que vous souhaitez réviser et une branche de destination, dans laquelle vous souhaitez fusionner le code révisé. La branche source contient le AFTER commit, qui est le commit contenant les modifications que vous souhaitez fusionner dans la branche de destination. La branche de destination contient le BEFORE commit, qui représente l'état du code avant que la branche pull request ne soit fusionnée avec la branche de destination.

Note

Lorsque vous créez une pull request, la différence affichée est la différence entre l'extrémité de la branche source et celle de la branche de destination. Une fois que vous avez créé la pull request, la différence affichée se situe entre la révision de la pull request que vous avez choisie et le commit qui figurait au début de la branche de destination lorsque vous avez créé la pull request. Pour plus d'informations sur les différences et les bases de fusion dans Git, consultez git-merge-basela documentation Git.

Lorsqu'une pull request est créée pour un référentiel source et des branches spécifiques, vous pouvez les créer, les afficher, les revoir et les fermer dans le cadre de votre projet. Il n'est pas nécessaire de consulter le référentiel source pour visualiser et utiliser les pull requests. L'état d'une pull request est défini sur Ouvert lorsque vous la créez. La pull request reste ouverte jusqu'à ce que vous la fusionniez dans la CodeCatalyst console, ce qui change l'état en Merged, ou que vous la fermiez, ce qui change l'état en Closed.

Lorsque votre code a été révisé, vous pouvez modifier l'état de la pull request de plusieurs manières :

  • Fusionnez la pull request dans la CodeCatalyst console. Le code de la branche source de la pull request sera fusionné dans la branche de destination. Le statut de la pull request deviendra Merged. Il ne peut pas être redéfini sur Ouvert.

  • Fusionnez les branches localement et appliquez vos modifications, puis fermez la pull request dans la CodeCatalyst console.

  • Utilisez la CodeCatalyst console pour fermer la pull request sans la fusionner. Cela changera le statut en Fermé et ne fusionnera pas le code de la branche source dans la branche de destination.

Avant de créer une demande d'extraction :

  • Validez et transférez les modifications de code que vous souhaitez vérifier dans une branche (la branche source).

  • Configurez des notifications pour votre projet afin que les autres utilisateurs puissent être informés des flux de travail exécutés lorsque vous créez une pull request. (Cette étape est facultative mais recommandée.)