Utiliser les problèmes et les demandes d'extraction

Cette page explique comment utiliser les problèmes et les requêtes d'extraction dans l'interface Web Secure Source Manager.

Pour accéder à l'instance Secure Source Manager via son interface Web, copiez l'URL suivante dans la barre d'adresse de votre navigateur.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Remplacez les éléments suivants :

• Remplacez INSTANCE_ID par le nom de l'instance.
• PROJECT_NUMBER par le numéro de projet Google Cloudde l'instance. Pour savoir comment identifier des projets, consultez Identifier des projets.
• LOCATION par la région de l'instance.

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser les problèmes et les demandes d'extraction, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Accesseur d'instances Secure Source Manager (roles/securesourcemanager.instanceAccessor) sur l'instance Secure Source Manager
• Rédacteur de dépôts Secure Source Manager (roles/securesourcemanager.repoWriter) sur le dépôt

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour savoir comment accorder des rôles Secure Source Manager, consultez Contrôle des accès avec IAM et Accorder aux utilisateurs l'accès à l'instance.

Afficher les demandes d'extraction

Vous pouvez afficher toutes les demandes d'extraction auxquelles vous avez accès ou celles d'un dépôt spécifique.

Les dépôts vides ne comportent pas d'onglet Pull requests (Demandes d'extraction). Une fois que vous avez envoyé le code à un dépôt, vous pouvez afficher l'onglet "demande d'extraction".

Pour afficher les demandes d'extraction ou les problèmes qui vous ont été attribués, accédez à l'onglet Problèmes ou Demandes d'extraction de Secure Source Manager, puis cliquez sur Qui me sont attribués.

Pour afficher les demandes d'extraction d'un dépôt :

1. Dans l'interface Web Secure Source Manager, sélectionnez votre dépôt.
2. Sur la page de votre dépôt, cliquez sur l'onglet Pull requests (Demandes d'extraction).
3. Vous pouvez filtrer ou trier les demandes d'extraction à l'aide des menus déroulants Responsable, Type ou Trier.

Pour afficher toutes les demandes d'extraction :

1. Dans l'interface Web Secure Source Manager, cliquez sur l'onglet Demandes d'extraction.

   Remarque : Vous devez disposer du rôle Lecteur de dépôt (roles/securesourcemanager.repoReader) sur un dépôt pour pouvoir afficher les demandes d'extraction de ce dépôt.

2. Vous pouvez filtrer ou trier les demandes d'extraction à l'aide des menus déroulants Assigné à, Type ou Trier.

Créer une demande d'extraction

1. Dans l'interface Web Secure Source Manager, sélectionnez le dépôt pour lequel vous souhaitez créer une demande d'extraction'extraction.
2. Sur la page du dépôt, cliquez sur l'onglet Pull requests (Demandes d'extraction).
3. Cliquez sur New pull request (Nouvelle demande d'extraction).
4. Dans le menu Fusionner dans, sélectionnez la branche dans laquelle vous souhaitez fusionner la demande d'extraction.
5. Dans le menu pull from (extraire de), sélectionnez la branche à partir de laquelle effectuer l'extraction.
6. Cliquez sur New pull request (Nouvelle demande d'extraction).
7. Donnez un titre et une description demande d'extraction, et joignez les fichiers pertinents.

8. Cliquez sur Create pull request (Créer une demande d'extraction).

   Vous êtes redirigé vers la page de la demande d'extraction, où vous pouvez ajouter des réviseurs, des libellés, des jalons et des cessionnaires.

Modifier les détails d'demande d'extraction d'extraction

Vous pouvez ajouter des examinateurs, des libellés, des jalons, des responsables et une date limite à une demande d'extraction;extraction.

Remarque : Aucune notification par e-mail n'est envoyée aux réviseurs ni aux personnes chargées de la tâche dans cette version.

Pour ajouter des examinateurs, des libellés, des jalons ou des responsables :

Sur la page de la demande d'extraction, cliquez sur l'icône en forme de roue dentée  à côté de l'information que vous souhaitez modifier.

Les modifications sont enregistrées automatiquement.

Pour modifier la date limite :

1. Cliquez sur l'icône Agenda dans la section Date limite, puis sélectionnez une date.
2. Cliquez sur l'icône Plus   pour enregistrer la date limite.

Examiner une demande d'extraction;extraction

Les réviseurs peuvent ajouter des commentaires, demander des modifications et approuver une demande d'extraction;extraction.

Pour examiner une demande d'extraction qui vous a été attribuée :

1. Dans l'interface Web Secure Source Manager, cliquez sur l'onglet Demandes d'extraction.
2. Cliquez sur Qui vous sont attribuées.

3. Cliquez sur la demande d'extraction que vous souhaitez examiner.

   La page Conversation s'ouvre. Vous pouvez consulter les commentaires laissés par l'auteur de la demande d'extraction;extraction ou par d'autres réviseurs.

4. Pour afficher les fichiers modifiés et les commenter, cliquez sur l'onglet Fichiers modifiés. Vous pouvez modifier le comportement de la visibilité des espaces blancs, ainsi que les options d'affichage et de comparaison en cliquant sur les menus déroulants Espaces blancs, Vue fractionnée/Vue unifiée et Options de comparaison.

5. Pour laisser un commentaire, cliquez sur l'icône Plus à côté de la ligne que vous souhaitez commenter.

6. Cliquez sur Commencer l'examen.

7. Pour ajouter des commentaires, cliquez sur l'icône Plus sur la ligne que vous souhaitez commenter, puis cliquez sur Ajouter un commentaire.

   Les commentaires peuvent être mis en forme avec Markdown.

8. Pour envoyer vos commentaires, approuver la demande d'extraction ou demander des modifications, cliquez sur Examiner.

9. Laissez un commentaire pour résumer vos modifications ou laissez l'espace de commentaire vide, puis sélectionnez l'une des options suivantes :

   • Approuver : approuvez les modifications.
   • Commentaire : envoyez vos commentaires sans approuver la demande d'extraction.

   • Demander des modifications : demandez des modifications à la demande d'extraction.

     Remarque : Si vous commentez votre propre demande d'extraction#39;extraction, vous ne pouvez pas l'approuver ni demander à ce qu'elle soit modifiée.

Fusionner des demandes d'extraction

1. Sur la page du dépôt, cliquez sur l'onglet Pull requests (Demandes d'extraction).
2. Sélectionnez la demande d'extraction que vous souhaitez fusionner.
3. S'il n'y a aucun conflit, cliquez sur Merge pull request (Fusionner la demande d'extraction).

Afficher les problèmes

1. Dans l'interface Web Secure Source Manager, sélectionnez votre dépôt.
2. Sur la page de votre dépôt, cliquez sur l'onglet Problèmes.
3. Vous pouvez filtrer ou trier les problèmes à l'aide des menus Responsable, Type ou Trier.

Créer un problème

1. Dans l'interface Web Secure Source Manager, sélectionnez votre dépôt.
2. Sur la page du dépôt, cliquez sur l'onglet Problèmes.
3. Cliquez sur Nouveau problème.
4. Saisissez le titre et la description du problème, puis cliquez sur Créer un problème.

5. Sur la page "Détails du problème", vous pouvez attribuer des libellés, des jalons et des responsables, et spécifier une branche ou un tag.

   Remarque : Aucune notification par e-mail n'est disponible dans cette version.

Étapes suivantes

• Utilisez la gestion du code source Git avec Secure Source Manager.