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.
Création d'une demande d'extraction
La création de demandes d'extraction permet aux autres utilisateurs de voir et de vérifier vos modifications de code avant de les fusionner dans une autre branche. Tout d'abord, vous devez créer une branche pour vos modifications de code. C'est ce que l'on appelle la branche source d'une demande d'extraction. Après avoir validé et transféré les modifications apportées au référentiel, vous pouvez créer une pull request qui compare le contenu de la branche source au contenu de la branche de destination.
Vous pouvez créer une pull request dans la CodeCatalyst console Amazon depuis une branche spécifique, depuis la page des pull requests ou depuis l'aperçu du projet. La création d'une pull request à partir d'une branche spécifique fournit automatiquement le nom du référentiel et la branche source sur la page de création de la pull request. Lorsque vous créez une pull request, vous recevez automatiquement des e-mails concernant toute mise à jour de la pull request, ainsi que la date de fusion ou de fermeture de la pull request.
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 la pointe de la branche de destination. Une fois la pull request créée, la différence affichée se situera 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-base
Vous pouvez utiliser la fonctionnalité Rédiger une description pour moi lorsque vous créez des pull requests pour qu'Amazon Q crée automatiquement une description des modifications contenues dans une pull request. Lorsque vous choisissez cette option, Amazon Q analyse les différences entre la branche source contenant les modifications de code et la branche de destination dans laquelle vous souhaitez fusionner ces modifications. Il crée ensuite un résumé de ces modifications, ainsi que sa meilleure interprétation de l'intention et de l'effet de ces modifications. Cette fonctionnalité n'est disponible que dans la région ouest des États-Unis (Oregon) pour les CodeCatalyst pull requests. La fonctionnalité Écrire une description pour moi n'est pas disponible pour les pull requests dans les référentiels liés.
Note
Propulsé par Amazon Bedrock : AWS implémente la détection automatique des abus. Les fonctionnalités Write description for me et Create content summary étant 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).
Pour créer une pull request
-
Accédez à votre projet.
-
Effectuez l’une des actions suivantes :
-
Dans le volet de navigation, choisissez Code, choisissez Pull requests, puis Create pull request.
-
Sur la page d'accueil du référentiel, choisissez Plus, puis Create pull request.
-
Sur la page du projet, choisissez Create pull request.
-
-
Dans le référentiel source, assurez-vous que le référentiel source spécifié est celui qui contient le code validé. Cette option n'apparaît que si vous n'avez pas créé la pull request depuis la page principale du dépôt.
-
Dans Branche de destination, choisissez la branche dans laquelle vous souhaitez fusionner le code une fois celui-ci révisé.
-
Dans Branche source, choisissez la branche qui contient le code validé.
-
Dans Titre de la demande d'extraction, entrez un titre qui aide les autres utilisateurs à comprendre ce qui doit être revu et pourquoi.
-
(Facultatif) Dans la description de la Pull request, fournissez des informations telles qu'un lien vers les problèmes ou une description de vos modifications.
Astuce
Vous pouvez choisir Write description for me afin de générer CodeCatalyst automatiquement une description des modifications contenues dans la pull request. Vous pouvez apporter des modifications à la description générée automatiquement après l'avoir ajoutée à la pull request.
Cette fonctionnalité nécessite que les fonctionnalités d'IA générative soient activées pour l'espace et ne sont pas disponibles pour les pull requests dans les référentiels liés. Pour plus d'informations, consultez la section Gestion des fonctionnalités génératives de l'IA.
-
(Facultatif) Dans Problèmes, choisissez Lier les problèmes, puis choisissez un problème dans la liste ou entrez son ID. Pour dissocier un problème, cliquez sur l'icône de dissociation.
-
(Facultatif) Dans Réviseurs obligatoires, sélectionnez Ajouter les réviseurs requis. Choisissez parmi la liste des membres du projet pour les ajouter. Les réviseurs requis doivent approuver les modifications avant que la pull request puisse être fusionnée dans la branche de destination.
Note
Vous ne pouvez pas ajouter un réviseur à la fois en tant que réviseur obligatoire et en tant que réviseur facultatif. Vous ne pouvez pas vous ajouter en tant que réviseur.
-
(Facultatif) Dans Réviseurs facultatifs, sélectionnez Ajouter des réviseurs facultatifs. Choisissez parmi la liste des membres du projet pour les ajouter. Les réviseurs facultatifs n'ont pas à approuver les modifications comme condition préalable pour que la pull request puisse être fusionnée dans la branche de destination.
-
Passez en revue les différences entre les branches. La différence affichée dans une pull request réside dans les modifications entre la révision dans la branche source et la base de fusion, qui est le commit principal de la branche de destination au moment de la création de la pull request. Si aucune modification ne s'affiche, il se peut que les branches soient identiques ou que vous ayez choisi la même branche pour la source et pour la destination.
-
Lorsque vous êtes certain que la pull request contient le code et les modifications que vous souhaitez vérifier, choisissez Create.
Note
Après avoir créé la pull request, vous pouvez ajouter des commentaires. Des commentaires peuvent être ajoutés à la pull request ou à des lignes individuelles des fichiers, ainsi qu'à la pull request globale. Vous pouvez ajouter des liens vers des ressources, telles que des fichiers, en utilisant le signe @ suivi du nom du fichier.
Pour créer une pull request depuis une branche
-
Accédez au projet dans lequel vous souhaitez créer une pull request.
-
Dans le volet de navigation, choisissez Référentiels sources, puis choisissez le référentiel qui contient la branche dans laquelle vous devez vérifier les modifications de code.
-
Cliquez sur la flèche déroulante à côté du nom de branche par défaut, puis sélectionnez la branche souhaitée dans la liste. Pour afficher toutes les branches d'un référentiel, choisissez Afficher tout.
-
Choisissez Plus, puis choisissez Create pull request.
-
Le référentiel et la branche source sont présélectionnés pour vous. Dans la branche de destination, choisissez la branche dans laquelle vous allez fusionner le code une fois qu'il aura été révisé. Dans le titre de la demande Pull, entrez un titre qui aidera les autres utilisateurs du projet à comprendre ce qui doit être révisé et pourquoi. Vous pouvez éventuellement fournir des informations supplémentaires dans la description de la demande Pull, par exemple en collant un lien vers des problèmes connexes ou en CodeCatalyst ajoutant une description des modifications que vous avez apportées.
Note
Les flux de travail configurés pour être exécutés lors d'événements de création de pull request s'exécuteront après la création de la pull request, si la branche de destination de la pull request correspond à l'une des branches spécifiées dans le flux de travail.
-
Passez en revue les différences entre les branches. Si aucune modification n'est affichée, il se peut que les branches soient identiques ou que vous ayez choisi la même branche pour la source et pour la destination.
-
(Facultatif) Dans Problèmes, choisissez Lier les problèmes, puis choisissez un problème dans la liste ou entrez son ID. Pour dissocier un problème, cliquez sur l'icône de dissociation.
-
(Facultatif) Dans Réviseurs obligatoires, sélectionnez Ajouter les réviseurs requis. Choisissez parmi la liste des membres du projet pour les ajouter. Les réviseurs requis doivent approuver les modifications avant que la pull request puisse être fusionnée dans la branche de destination.
Note
Vous ne pouvez pas ajouter de réviseur à la fois comme obligatoire et facultatif. Vous ne pouvez pas vous ajouter en tant que réviseur.
-
(Facultatif) Dans Réviseurs facultatifs, sélectionnez Ajouter des réviseurs facultatifs. Choisissez parmi la liste des membres du projet pour les ajouter. Les réviseurs facultatifs n'ont pas à approuver les modifications pour que la pull request puisse être fusionnée dans la branche de destination.
-
Lorsque vous êtes certain que la pull request contient les modifications que vous souhaitez vérifier et inclut les réviseurs requis, choisissez Create.
Si vous avez configuré des flux de travail pour s'exécuter là où la branche correspond à la branche de destination dans la pull request, vous verrez des informations sur ces flux de travail dans la section Vue d'ensemble, dans la zone des détails de la pull request après la création de la pull request. Pour plus d'informations, voir Ajouter un déclencheur push, pull ou Schedule.
