Esercizio - Creare, esaminare e unire una richiesta pull

  • 5 minuti

Il lavoro per aggiungere una coda al sito Web è stato completato. A questo punto, il team di sviluppo del sito Web è pronto per unire le modifiche al ramo principale. In questo esercizio si creerà e si unirà una richiesta pull per le modifiche.

Durante il processo, si eseguiranno queste operazioni:

  • Creare una richiesta pull.
  • Esaminare la richiesta pull.
  • Completare la richiesta pull.
  • Verificare che le modifiche siano state unite.

Creare una richiesta di pull per unire il ramo della funzionalità

Poiché non è possibile eseguire il push delle modifiche direttamente nel ramo principale del repository, è necessario creare una richiesta pull.

  1. Nel browser passare a Codice.

  2. Selezionare 2 rami per elencare i rami nel repository GitHub.

    Screenshot di GitHub che mostra la pagina del repository con il collegamento all'elenco dei rami evidenziato.

  3. Accanto a add-orders-queue, selezionare l'icona Altro (...), quindi selezionare Nuova richiesta pull.

    Screenshot di GitHub che mostra l'elenco dei rami. Il pulsante relativo alla nuova richiesta pull è evidenziato per il ramo add-orders-queue.

  4. Quando si crea la richiesta pull, si noti che GitHub ha usato automaticamente il messaggio di commit Git come titolo della richiesta pull.

    Aggiornare la descrizione con il testo seguente:

    Questa richiesta pull aggiunge una nuova coda di Archiviazione di Azure per l'elaborazione degli ordini e aggiorna la configurazione del sito Web per includere le informazioni sull'account di archiviazione e sulla coda.

  5. Selezionare Crea richiesta pull.

    Screenshot di GitHub che mostra la pagina di creazione della richiesta pull, con il pulsante per la creazione evidenziato.

  1. Nel browser passare a Repos>File.

    Si noti che Azure DevOps mostra un banner che indica che ci sono modifiche nel ramo add-orders-queue. Il banner offre la creazione di una richiesta pull per tali modifiche.

    Screenshot di Azure DevOps che mostra l'elenco file del repository, incluso un banner in cui viene proposto di creare una richiesta pull.

  2. Selezionare Creare una richiesta pull.

  3. Nella pagina per la creazione di una richiesta pull, si noti che Azure DevOps ha usato automaticamente il messaggio di commit Git come titolo della richiesta pull.

    Aggiornare la descrizione con il testo seguente:

    Questa richiesta pull aggiunge una nuova coda di Archiviazione di Azure per l'elaborazione degli ordini e aggiorna la configurazione del sito Web per includere le informazioni sull'account di archiviazione e sulla coda.

  4. Seleziona Crea.

    Screenshot di Azure DevOps che mostra la pagina di creazione della richiesta pull, con il pulsante per la creazione evidenziato.

Esaminare la richiesta pull

In genere, una richiesta pull viene esaminata da un utente diverso dal suo autore. Per questo esempio si farà finta di essere un altro membro del team e si esaminerà la propria richiesta pull.

  1. Dalla pagina della richiesta pull selezionare la scheda Files changed.

    Screenshot di GitHub che mostra la scheda relativa ai file modificati in una richiesta pull.

    GitHub mostra i file modificati in questa richiesta pull. Si noti che evidenzia tutte le righe che sono state modificate, quindi è possibile visualizzare facilmente ciò che si dovrebbe esaminare.

    Suggerimento

    Si immagini di esaminare la richiesta per il proprio team. Si proporrebbe qualche suggerimento?

  2. Nel file main.bicep modificato passare il puntatore del mouse sulla riga 18 e selezionare il pulsante con il segno più (+).

    Screenshot di GitHub che mostra le modifiche apportate al file main.bicep. Il puntatore del mouse è posizionato sulla riga 18 e il pulsante per l'aggiunta di commenti è evidenziato.

  3. Nella casella dei commenti immettere il testo seguente: Deve essere maiuscolo?

  4. Selezionare Avvia una revisione.

    Screenshot di GitHub che mostra il campo dei commenti, con il pulsante per iniziare una revisione evidenziato.

    Suggerimento

    GitHub non consente di approvare le proprie richieste pull. Qui si aggiungerà un commento alla richiesta pull, ma non la si approverà. Quando si lavora con le richieste pull del proprio team, questo è il punto in cui si dovrebbe approvare la richiesta per indicare che si approva la sua unione.

  5. Selezionare Finish your review.

  6. Nel pannello di revisione visualizzato selezionare Invia recensione.

    Screenshot di GitHub che mostra il pannello per completare una revisione, con il pulsante per inviare una revisione evidenziato.

    GitHub restituisce la scheda Conversazione della richiesta pull.

  1. Dalla pagina della richiesta pull selezionare la scheda File.

    Screenshot di Azure DevOps che mostra i file modificati nella richiesta pull.

    Azure DevOps mostra i file modificati in questa richiesta pull. Si noti che evidenzia tutte le righe che sono state modificate, quindi è possibile visualizzare facilmente ciò che si dovrebbe esaminare.

    Suggerimento

    Si immagini di esaminare la richiesta per il proprio team. Si proporrebbe qualche suggerimento?

  2. Nel file main.bicep modificato passare il puntatore del mouse sulla riga 18 e selezionare il pulsante del commento.

    Screenshot di Azure DevOps che mostra le modifiche apportate al file main.bicep. Il puntatore del mouse è posizionato sulla riga 18 e il pulsante per l'aggiunta di un commento è evidenziato.

  3. Nella casella dei commenti immettere il testo seguente: Deve essere maiuscolo?

  4. Selezionare Commento.

    Screenshot di Azure DevOps che mostra il campo del commento, con il pulsante Commento evidenziato.

    La larghezza della finestra del browser può influire sul modo in cui viene visualizzata la finestra di dialogo commento. Il commento aprirà una finestra di dialogo Discussione anziché il commento inline, come illustrato nello screenshot.

  5. Selezionare Approva.

    Screenshot di Azure DevOps che mostra il pulsante Approva per la richiesta pull.

    Dopo aver selezionato Approva le modifiche per Impostare il completamento automaticamente su Completare. Questa funzionalità verrà usata più avanti in questa unità.

Rispondere alla revisione della richiesta pull

Quando si crea o si esamina una richiesta pull, è possibile partecipare a una conversazione sul suo contenuto. Si supponga di essere l'autore di questo file e di voler rispondere a un commento del revisore.

  1. Rispondere alla revisione della richiesta pull con il commento seguente: No, i nomi delle code di archiviazione devono essere in minuscolo.

  2. Selezionare Commento e quindi Resolve conversation per indicare che la discussione sulla riga è finita.

    Screenshot di GitHub che mostra la risposta a un commento, con i pulsanti per immettere un commento e risolvere una conversazione evidenziati.

  1. Dalla pagina della richiesta pull selezionare la scheda Panoramica.

    Screenshot di Azure DevOps che mostra la scheda Panoramica.

  2. Si supponga ora di essere l'autore di questo file. Rispondere alla revisione della richiesta pull con il commento seguente: No, i nomi delle code di archiviazione devono essere in minuscolo.

  3. Selezionare Rispondi e risolvi per indicare che la discussione sulla riga è finita.

    Screenshot di Azure DevOps che mostra la risposta a un commento, con il pulsante per la risposta e la risoluzione evidenziato.

Completare la richiesta pull

Il team di sviluppo del sito Web ha confermato di essere pronto per inviare gli ordini alla coda, quindi si è pronti per completare e unire la richiesta pull.

La richiesta è stata approvata. Il team di sviluppo del sito Web ha confermato di essere pronto per inviare gli ordini alla coda, quindi si è pronti per completare e unire la richiesta pull.

  1. Selezionare Merge pull request (Unisci la richiesta pull).

    Screenshot di GitHub che mostra una richiesta pull con il pulsante per il merge evidenziato.

  2. GitHub chiede di confermare l'unione. Quando GitHub unisce la richiesta pull, crea un commit e genera automaticamente un messaggio di commit. Selezionare Confirm merge.

    Screenshot di GitHub che mostra una richiesta pull con il pulsante per confermare un merge evidenziato.

    La richiesta pull viene unita e la nuova funzionalità è ora nel ramo principale del repository.

  3. Al termine, è consigliabile eliminare i rami delle funzionalità. L'eliminazione dei rami consente di evitare confusione tra i membri del team in futuro su quali lavori sono ancora in corso. Selezionare Elimina ramo.

    Screenshot di GitHub che mostra una richiesta pull con il pulsante per eliminare un ramo evidenziato.

  1. Selezionare Completo.

    Screenshot di Azure DevOps che mostra il pulsante Completa per una richiesta pull.

  2. Dalla richiesta pull completa, usare le impostazioni predefinite. Selezionare Completa merge.

    Screenshot di Azure DevOps che mostra il pannello di completamento della richiesta pull, con il pulsante per completare un merge evidenziato.

    La richiesta pull viene unita e la nuova funzionalità è ora nel ramo principale del repository.

    Azure DevOps ha eliminato automaticamente il ramo di funzionalità quando la richiesta pull è stata unita. Al termine, è consigliabile eliminare i rami delle funzionalità. L'eliminazione dei rami consente di evitare confusione tra i membri del team in futuro su quali lavori sono ancora in corso.

Verificare le modifiche

Dopo aver unito una richiesta pull, è consigliabile verificare che le modifiche siano state unite correttamente.

  1. Passare a Codice.

  2. Passare al file deploy/main.bicep e quindi al file deploy/modules/appService.bicep.

    Screenshot di GitHub che mostra l'elenco file del repository dopo il merge della richiesta pull.

    Si noti che la coda e le altre modifiche sono ora presenti nei file.

  1. Passare a Repos>File.

  2. Passare al file deploy/main.bicep e quindi al file deploy/modules/appService.bicep.

    Si noti che la coda e le altre modifiche sono ora presenti nei file.