Utiliser les problèmes et les demandes d'extraction

Cette page explique comment utiliser les problèmes et les demandes 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 :

  • 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 :

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 attribuer des rôles Secure Source Manager, consultez Contrôle des accès avec IAM et Accorder aux utilisateurs l'accès aux instances.

Afficher les demandes d'extraction

Vous pouvez afficher toutes les demandes d'extraction auxquelles vous avez accès ou les demandes d'extraction pour 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 consulter l'onglet des demande d'extraction d'extraction.

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

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 Assigné à, 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.

  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 responsables.

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.

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 icône en forme de roue dentée à côté du détail que vous souhaitez modifier.

Les modifications sont enregistrées automatiquement.

Pour modifier la date limite :

  1. Cliquez sur l'icône de calendrier dans la section Date limite, puis sélectionnez une date.
  2. Cliquez sur l'icône icône Plus 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 Attribué à vous.

  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 d'autres commentaires, cliquez sur l'icône Plus sur la ligne que vous souhaitez commenter, puis sur Ajouter un commentaire.

    Les commentaires sont compatibles avec la mise en forme 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.
    • Commenter : envoyez vos commentaires sans approuver la demande d'extraction.

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

Fusionner les 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 pas de 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 Issues (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.

Ajouter des diagrammes avec Mermaid

Secure Source Manager permet d'afficher les diagrammes Mermaid dans les fichiers Markdown (tels que README.md), les descriptions de demande d'extraction, les problèmes et les commentaires.

Pour ajouter un diagramme, utilisez un bloc de code délimité mermaid :

```mermaid
graph TD
    A[Write Markdown] --> B(Click Preview Tab)
    B --> C{Does it render?}
    C -- Yes --> D[Success]
    C -- No --> E[Check Syntax]
```

Cliquez sur l'onglet Aperçu dans l'éditeur Markdown pour vérifier que votre diagramme s'affiche avant de l'enregistrer.

Types de diagrammes compatibles

Secure Source Manager est compatible avec les types de diagrammes Mermaid suivants :

  • Organigrammes : graph ou flowchart (compatible avec TD, TB, LR, BT, RL)
  • Diagrammes de séquence : sequenceDiagram
  • Diagrammes de classes : classDiagram
  • Diagrammes entité-relation : erDiagram
  • Diagrammes d'état : stateDiagram ou stateDiagram-v2
  • Graphiques XY : xychart-beta ou xychart

Comportement et limites de rendu

  • Rendu statique : les diagrammes sont affichés sous forme d'images statiques. Les fonctionnalités interactives (comme les rappels click et les info-bulles) et les scripts externes sont désactivés pour des raisons de sécurité.
  • Adaptation du thème : les schémas s'adaptent automatiquement aux thèmes clair et sombre.
  • Accessibilité : les schémas affichés incluent un texte alternatif rempli avec le code source du schéma pour les lecteurs d'écran.
  • Types de diagrammes non acceptés : les types de diagrammes non acceptés affichent un message d'erreur et ne sont pas affichés. Il s'agit, entre autres, des diagrammes de Gantt, des cartes mentales, des graphiques à secteurs, des Gitgraph, des parcours utilisateur, des exigences, des C4, des chronologies, des Sankey et des blocs. Pour les types de diagrammes non compatibles, affichez le diagramme localement sous forme d'image (PNG ou SVG) et intégrez-le à l'aide de la syntaxe Markdown standard pour les images.

Étapes suivantes