Utilizzare i problemi e le richieste di pull

Questa pagina descrive come lavorare con i problemi e le richieste di pull nell'interfaccia web di Secure Source Manager.

Per accedere all'istanza Secure Source Manager tramite la sua interfaccia web, copia il seguente URL nella barra degli indirizzi del browser.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Sostituisci quanto segue:

  • INSTANCE_ID con il nome dell'istanza.
  • PROJECT_NUMBER con il numero di progetto Google Cloud dell'istanza. Per informazioni sull'identificazione dei progetti, consulta Identificazione dei progetti.
  • LOCATION con la regione dell'istanza.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per lavorare con i problemi e le richieste di pull, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per informazioni sulla concessione dei ruoli Secure Source Manager, consulta Controllo dell'accesso con IAM e Concedere agli utenti l'accesso all'istanza.

Visualizza le richieste di pull

Puoi visualizzare tutte le richieste pull a cui hai accesso o le richieste pull per un repository specifico.

I repository vuoti non hanno una scheda Richieste di pull. Una volta eseguito il push in un repository, puoi visualizzare la scheda delle richieste di pull.

Per visualizzare le richieste di pull o i problemi assegnati a te, vai alla scheda Problemi o Richieste di pull di Secure Source Manager e fai clic su Assegnati a me.

Per visualizzare le richieste di pull per un repository:

  1. Nell'interfaccia web di Secure Source Manager, seleziona il repository.
  2. Nella pagina del repository, fai clic sulla scheda Richieste pull.
  3. Puoi filtrare o ordinare le richieste di pull utilizzando i menu a discesa per Assegnatario, Tipo o Ordina.

Per visualizzare tutte le richieste pull:

  1. Nell'interfaccia web di Secure Source Manager, fai clic sulla scheda Pull request.

  2. Puoi filtrare o ordinare le richieste pull utilizzando i menu a discesa per Assegnatario, Tipo o Ordina.

Creare una richiesta di pull

  1. Nell'interfaccia web di Secure Source Manager, seleziona il repository per cui vuoi creare una richiesta di pull.
  2. Nella pagina del repository, fai clic sulla scheda Pull request.
  3. Fai clic su Nuova richiesta di pull.
  4. Nel menu Unisci in, seleziona il ramo in cui vuoi unire la richiesta di pull.
  5. Nel menu pull from (estrai da), seleziona il ramo da cui estrarre.
  6. Fai clic su Nuova richiesta di pull.
  7. Assegna alla richiesta di pull un titolo e una descrizione e allega eventuali file pertinenti.

  8. Fai clic su Crea richiesta di pull.

    Viene visualizzata la pagina della richiesta di pull, in cui puoi aggiungere revisori, etichette, traguardi e assegnatari.

Modifica i dettagli della richiesta di pull

Puoi aggiungere revisori, etichette, traguardi, assegnatari e una data di scadenza a una richiesta di pull.

Per aggiungere revisori, etichette, obiettivi e assegnatari:

Nella pagina della richiesta di pull, fai clic sull'icona a forma di ingranaggio icona a forma di ingranaggio accanto al dettaglio che vuoi modificare.

Le modifiche vengono salvate automaticamente.

Per aggiornare la data di scadenza:

  1. Fai clic sull'icona del calendario nella sezione Data di consegna e seleziona una data.
  2. Fai clic sull'icona Icona Più Più per salvare la data di scadenza.

Esaminare una richiesta di pull

I revisori possono aggiungere commenti, richiedere modifiche e approvare una richiesta di pull.

Per esaminare una richiesta di pull assegnata a te:

  1. Nell'interfaccia web di Secure Source Manager, fai clic sulla scheda Pull request.
  2. Fai clic su Assegnati a te.

  3. Fai clic sulla richiesta di pull che vuoi esaminare.

    Si apre la pagina Conversazione. Puoi visualizzare tutti i commenti lasciati dall'autore della richiesta di pull o da altri revisori.

  4. Per visualizzare e commentare i file modificati, fai clic sulla scheda File modificati. Puoi modificare il comportamento della visibilità degli spazi vuoti, le opzioni di visualizzazione e di differenze facendo clic sui menu a discesa Spazi vuoti, Visualizzazione divisa/Visualizzazione unificata e Opzioni differenze.

  5. Per lasciare un commento, fai clic sull'icona Più accanto alla riga che vuoi commentare.

  6. Fai clic su Inizia revisione.

  7. Lascia eventuali commenti aggiuntivi facendo clic sull'icona Più sulla riga che vuoi commentare, poi fai clic su Aggiungi commento.

    I commenti supportano lo stile con Markdown.

  8. Per inviare i tuoi commenti, approvare la richiesta di pull o richiedere modifiche, fai clic su Rivedi.

  9. Lascia un commento per riassumere le modifiche o lascia vuoto lo spazio per i commenti e scegli una delle seguenti opzioni:

    • Approva: approva le modifiche.
    • Commenta: invia i tuoi commenti senza approvare la richiesta di pull.

    • Richiedi modifiche: richiedi modifiche alla richiesta di pull.

Unire le richieste di pull

  1. Nella pagina del repository, fai clic sulla scheda Pull request.
  2. Seleziona la richiesta di pull che vuoi unire.
  3. Se non ci sono conflitti, fai clic su Unisci richiesta di pull.

Visualizza problemi

  1. Nell'interfaccia web di Secure Source Manager, seleziona il repository.
  2. Nella pagina del repository, fai clic sulla scheda Problemi.
  3. Puoi filtrare o ordinare i problemi utilizzando i menu per Assegnatario, Tipo o Ordina.

Crea un problema

  1. Nell'interfaccia web di Secure Source Manager, seleziona il repository.
  2. Nella pagina del repository, fai clic sulla scheda Problemi.
  3. Fai clic su Nuovo problema.
  4. Inserisci il titolo e la descrizione del problema, poi fai clic su Crea problema.

  5. Nella pagina dei dettagli del problema puoi assegnare etichette, milestone, assegnatari e specificare un branch o un tag.

Aggiungere diagrammi con Mermaid

Secure Source Manager supporta il rendering dei diagrammi Mermaid nei file Markdown (ad esempio README.md), nelle descrizioni delle richieste di pull, nei problemi e nei commenti.

Per aggiungere un diagramma, utilizza un blocco di codice recintato 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]
```

Fai clic sulla scheda Anteprima nell'editor Markdown per verificare che il diagramma venga visualizzato prima di salvare.

Tipi di diagrammi supportati

Secure Source Manager supporta i seguenti tipi di diagrammi Mermaid:

  • Diagrammi di flusso: graph o flowchart (supporta TD, TB, LR, BT, RL)
  • Diagrammi di sequenza: sequenceDiagram
  • Diagrammi delle classi: classDiagram
  • Diagrammi entità-relazione: erDiagram
  • Diagrammi di stato: stateDiagram o stateDiagram-v2
  • Grafici XY: xychart-beta o xychart

Comportamento e limitazioni del rendering

  • Rendering statico: i diagrammi vengono visualizzati come immagini statiche. Per motivi di sicurezza, le funzionalità interattive (come click callback e descrizioni comando) e gli script esterni sono disattivati.
  • Adattamento del tema: i diagrammi si adattano automaticamente ai temi chiaro e scuro.
  • Accessibilità: i diagrammi sottoposti a rendering includono un testo alternativo compilato con il codice sorgente del diagramma per gli screen reader.
  • Tipi di diagramma non supportati: i tipi di diagramma non supportati mostrano un messaggio di errore e non vengono visualizzati. tra cui Gantt, Mindmap, Pie, Gitgraph, User Journey, Requirement, C4, Timeline, Sankey e Block. Per i tipi di diagramma non supportati, esegui il rendering del diagramma localmente in un'immagine (PNG o SVG) e incorporala utilizzando la sintassi standard delle immagini Markdown.

Passaggi successivi