Creare richieste pull
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Creare pull request per modificare, esaminare e unire il codice in un repository Git . È possibile creare richieste pull dai rami nel repository upstream o dai rami nel fork del repository. Il team può esaminare le richieste pull e inviare commenti e suggerimenti sulle modifiche. I revisori possono esaminare le modifiche proposte, lasciare commenti e votare per approvare o rifiutare le pull request. A seconda dei criteri dei rami e di altri requisiti, la richiesta pull potrebbe dover soddisfare vari criteri prima di poter completare il della richiesta pull e unire le modifiche nel ramo di destinazione.
Per le linee guida sulle PR e le considerazioni sulla gestione, consultare Informazioni sulle PR.
Prerequisiti
Categoria | Requisiti |
---|---|
livelli di accesso | - Visualizzare o esaminare le Pull Request (PR): almeno Basic access. Per i progetti pubblici, gli utenti l'accesso degli stakeholder hanno accesso completo ad Azure Repos. |
Autorizzazioni | - Contribuire a una richiesta pull: membro del Reader gruppo di sicurezza o delle autorizzazioni corrispondenti. - Creare e completare una pull request: membro del gruppo di sicurezza Collaboratori o con autorizzazioni corrispondenti. |
Servizi | Repos abilitato. |
Strumenti | CLI di Azure DevOps. |
Categoria | Requisiti |
---|---|
livelli di accesso | - Visualizzare o esaminare le richieste di pull: almeno accesso di base. |
Autorizzazioni | - Contribuire a una richiesta pull: membro del Reader gruppo di sicurezza o delle autorizzazioni corrispondenti. - Creare e completare una pull request: membro del gruppo di sicurezza dei collaboratori o autorizzazioni corrispondenti. |
Servizi | Repos abilitato. |
Per ulteriori informazioni sulle autorizzazioni e sui livelli di accesso, vedere Autorizzazioni predefinite del repository Git e del ramo e Informazioni sui livelli di accesso.
Creare una richiesta pull
È possibile creare una nuova richiesta pull dal sito Web del progetto Azure DevOps, da Visual Studio o dall'interfaccia della riga di comando di Azure DevOps.
Dalla pagina web del progetto Azure DevOps, è possibile creare una nuova pull request da:
- pagina Richieste pull.
- Un ramo di funzionalità di cui è stato eseguito il push nel repository.
- Una richiesta pull esistente usando il cherry-pick.
- Controllo di sviluppo in un elemento di lavoro collegato di Azure Boards.
Crea una richiesta pull dalla pagina Richieste pull
È possibile creare richieste pull per qualsiasi ramo dalla pagina richieste pull del progetto sul Web.
Nella pagina >Pull requests, selezionare Nuova richiesta pull in alto a destra.
Selezionare il ramo con le modifiche e il ramo in cui si desidera unire le modifiche, ad esempio il ramo principale.
Inserisci i dettagli della pull request e crea la pull request.
Creare una pull request da un branch pushato
Dopo aver eseguito il push o l'aggiornamento di un ramo funzionale, Azure Repos visualizza un prompt per creare una richiesta di pull.
Nella pagina delle pull request:
Nella pagina file:
Selezionare Crea una richiesta pull per passare a una pagina in cui è possibile immettere i dettagli della richiesta pull e creare la richiesta pull.
Crea una richiesta pull da un elemento di lavoro collegato
È possibile creare una pull request direttamente da un elemento di lavoro di Azure Boards collegato a un branch.
In Azure Boards, da backlog o query nella visualizzazione Lavoro, aprire un elemento di lavoro collegato al ramo.
Nell'area Sviluppo dell'elemento di lavoro, selezionare Crea un pull request.
Il collegamento consente di passare a una pagina in cui puoi immettere i dettagli della pull request e creare la pull request.
Aggiungere aggiornamenti con cherry-pick
È possibile copiare i commit da un ramo a un altro usando cherry-pick. A differenza di un merge o di un rebase, cherry-pick applica solo le modifiche dai commit selezionati, anziché tutte le modifiche in un ramo.
Per selezionare le modifiche da una richiesta pull completata, selezionare cherry-pick nella pagina panoramica della richiesta pull. Per copiare le modifiche da una richiesta pull attiva, selezionare l'opzione Cherry-pick dal menu Altre opzioni della PR. Questa azione crea un nuovo ramo con le modifiche copiate. È quindi possibile creare una nuova richiesta pull dal nuovo ramo. Per istruzioni dettagliate, vedere Copia le modifiche con cherry-pick.
Cambiare i rami di origine e di destinazione della richiesta pull
Prima della prima volta che si salva una richiesta pull, è possibile cambiare i rami di origine e di destinazione della richiesta pull selezionando l'icona Cambia origine e rami di destinazione accanto ai nomi dei rami. Quando la richiesta pull è attiva, questa icona scompare, ma è comunque possibile modificare il ramo di destinazione della richiesta pull.
Usare i modelli di richiesta pull
Un modello di pull request è un file contenente testo Markdown che popola la descrizione del PR quando si crea un PR. Le descrizioni delle pull request valide indicano ai revisori cosa aspettarsi e possono aiutare a tenere traccia delle attività come l'aggiunta di unit test e l'aggiornamento della documentazione. Il team può creare un modello di richiesta pull predefinito che aggiunge testo a tutte le nuove descrizioni delle richieste pull nel repository. È anche possibile selezionare tra modelli specifici del ramo o altri modelli definiti dal team. Per ulteriori informazioni sulla creazione e sull'uso di modelli per le richieste di pull, vedere Migliorare le descrizioni delle richieste di pull utilizzando i modelli.
Se il repository ha un modello predefinito, tutte le pull request nel repository includono il testo della descrizione del modello predefinito durante la creazione. Per aggiungere altri modelli, selezionare Aggiungi un modello e quindi scegliere un modello dall'elenco a discesa. È possibile modificare il testo del modello nella descrizione, rimuoverlo o aggiungere altro testo.
Creare bozze di richieste pull
Se la richiesta pull non è pronta per la revisione, puoi creare una bozza di richiesta pull per indicare il lavoro in corso. Quando il PR è pronto per la revisione, è possibile pubblicarlo e iniziare o riprendere il processo di revisione.
Le bozze di richieste pull presentano le seguenti differenze rispetto alle richieste pull pubblicate.
Le politiche di convalida della build non vengono eseguite automaticamente. È possibile accodare manualmente le convalide di compilazione selezionando il menu altre opzioni nella PR.
Il voto è disabilitato in modalità bozza.
I revisori obbligatori non vengono aggiunti automaticamente. Le notifiche vengono inviate solo ai revisori che aggiungi esplicitamente alla bozza di pull request.
Le richieste pull bozza vengono visualizzate nell'elenco delle richieste pull con una notifica bozza.
Per creare una bozza di richiesta pull, selezionare la freccia accanto a Crea e selezionare Crea come bozza nella creazione della richiesta pull. Non è necessario usare prefissi del titolo, ad esempio WIP
o DO NOT MERGE
.
Quando sei pronto per esaminare e completare la pull request, seleziona Pubblica in alto a destra nella pull request. La pubblicazione di una Pull Request assegna i revisori necessari, valuta le politiche e avvia la votazione.
Per modificare una richiesta pull pubblicata esistente in una bozza, scegliere Segna come bozza. Se si contrassegna una richiesta pull come bozza, vengono rimossi tutti i voti esistenti.
Aggiungere o modificare il titolo e la descrizione della richiesta pull
Nella pagina Nuova richiesta pull, inserisci un Titolo e una Descrizione dettagliata delle modifiche, in modo che altri possano vedere quali problemi risolvono le modifiche. In una nuova richiesta pull come nelle richieste pull esistenti è possibile visualizzare i file di e commit nella richiesta pull in schede separate. È possibile aggiungere revisori, collegare elementi di lavoro e aggiungere tag alla pull request.
Quando sei pronto per far rivedere le tue modifiche, seleziona Crea per creare la richiesta di pull.
P R.
P R.
Non preoccuparti se non hai tutti gli elementi di lavoro, i revisori o i dettagli pronti quando crei il tuo pull request. È possibile aggiungere o aggiornare questi elementi dopo aver creato la pull request.
Modificare il titolo e la descrizione della PR (richiesta pull)
Mantenere aggiornato il titolo e la descrizione del pull request in modo che i revisori possano comprendere le modifiche nel pull request.
È possibile aggiornare il titolo di una pull request esistente selezionando il titolo corrente e modificando il testo. Selezionare l'icona salva per salvare le modifiche oppure selezionare l'icona Annulla per annullare le modifiche.
Modifica la descrizione del pull request selezionando l'icona Modifica nella sezione Descrizione.
Aggiungere revisori a una pull request
Puoi aggiungere revisori nella sezione Revisori di un pull request nuovo o esistente. È anche possibile cambiare i revisori facoltativi in obbligatori, rendere facoltativi i revisori necessari o rimuoverli, a meno che non siano richiesti dai criteri.
I criteri di ramo possono richiedono un numero minimo di revisori o includono automaticamente determinati revisori facoltativi o obbligatori nelle richieste pull. Non è possibile rimuovere i revisori richiesti dai criteri di ramo, ma è possibile modificare i revisori facoltativi in modo che siano necessari o rimuoverli.
Per vedere la policy di ramo che ha aggiunto automaticamente un revisore, seleziona Altre opzioni accanto al revisore nella sezione Revisori della pagina Panoramica della richiesta pull.
Se l'utente o il gruppo che vuoi esaminare la tua richiesta pull non sono membri del tuo progetto, aggiungili al progetto prima che tu li possa aggiungere come revisori.
Per aggiungere revisori a una nuova pull request, seguire questa procedura:
- Nella pagina Nuova richiesta pull, in Revisoriselezionare Cerca utenti e gruppi da aggiungere come revisori.
- Quando si immette un nome o un indirizzo di posta elettronica, un elenco a discesa mostra un elenco di utenti e gruppi corrispondenti. Selezionare i nomi dall'elenco da aggiungere come revisori facoltativi.
- Per aggiungere revisori necessari, selezionare Aggiungi revisori necessarie quindi selezionare Ricerca per aggiungere i revisori necessari per cercare e selezionare i nomi.
Per aggiungere revisori a una richiesta pull esistente, seguire questa procedura:
Nella sezione Reviewer della Pagina Panoramica , selezionare l'opzione Aggiungie quindi selezionare il Revisore obbligatorio o il Revisore facoltativo.
Quando si immette un nome o un indirizzo di posta elettronica, viene visualizzato un elenco di utenti o gruppi corrispondenti. Selezionare i nomi da aggiungere come revisori.
Per modificare un revisore tra obbligatorio e facoltativo oppure per rimuovere un revisore, selezionare Altre opzioni (⋮) a destra del nome del revisore. Per visualizzare l'appartenenza di un gruppo o di un team designato come revisore, selezionare l'icona del gruppo.
Collegare elementi di lavoro a una richiesta pull
Per collegare elementi di lavoro a una nuova richiesta pull, seguire questa procedura:
- Nella pagina Nuova richiesta pull, in Elementi di lavoro da collegareselezionare Cerca elementi di lavoro in base all'ID o al titolo.
- Iniziare a immettere un ID o un titolo dell'elemento di lavoro e selezionare l'elemento di lavoro da collegare dall'elenco a discesa visualizzato.
- La ricerca per titolo restituisce elementi di lavoro filtrati in base allo stato; sono esclusi tutti gli elementi di lavoro con stati classificati come Completato e Rimosso.
- Questi elementi di lavoro vengono filtrati anche in base alla data e all'utente, visualizzando solo gli elementi creati o aggiornati negli ultimi 30 giorni. Devono essere creati da, assegnati all'utente corrente, o autorizzati come tale.
Per collegare elementi di lavoro a una pull request esistente, seguire i seguenti passaggi:
Nella scheda Panoramica , nell'area elementi di lavoro, selezionare +.
Immettere l'ID dell'elemento di lavoro o cercare il titolo dell'elemento di lavoro. Selezionare l'elemento di lavoro dall'elenco visualizzato.
Rimuovere un collegamento all'elemento di lavoro selezionando l'icona x accanto all'elemento di lavoro. La rimozione di un collegamento rimuove solo il collegamento tra l'elemento di lavoro e la pull request. I collegamenti creati nel ramo o dai commit rimangono nell'elemento di lavoro.
Aggiungere tag a una pull request
Usare i tag per evidenziare dettagli importanti e aiutare a organizzare le pull request. I tag possono comunicare informazioni aggiuntive ai revisori, ad esempio che il pull request è ancora in corso o è un hotfix per la prossima versione.
Per aggiungere un tag durante la creazione di una richiesta pull, digitare un nome di tag nella sezione Tag. Dopo aver creato la richiesta pull, è possibile gestire i tag nella sezione tag.
Aggiungere allegati ai pull request
È possibile allegare file, comprese le immagini, a una pull request durante o dopo la sua creazione. Selezionare l'icona della graffetta sotto il campo Descrizione oppure trascinare i file direttamente nel campo Descrizione della richiesta pull.
Modificare il ramo di destinazione di una richiesta pull attiva
Per la maggior parte dei team, quasi tutte le pull request sono destinate a un ramo predefinito, ad esempio main
o develop
. Se capita di dover puntare a un ramo diverso, è facile dimenticare di modificare il ramo di destinazione quando si crea la pull request. In questo caso, è possibile modificare il ramo di destinazione di una Pull Request attiva.
- Selezionare Altre azioni in alto a destra nella pagina PR Panoramica e quindi selezionare Modifica ramo di destinazione dal menu a discesa.
- Nel riquadro Cambia ramo di destinazione selezionare Scegliere un ramo di destinazione, selezionare il nuovo ramo e quindi selezionare Modifica.
Invia notifiche di pull request tramite email ai destinatari
È possibile condividere una richiesta pull tramite posta elettronica per notificare ai revisori e comunicare con i membri del team. Per condividere un PR (pull request):
Selezionare Altre opzioni nella pagina Panoramica, e quindi selezionare Condividi richiesta pull.
Nella schermata Condividi richiesta pull aggiungere i destinatari digitando i relativi nomi nel campo A: e selezionando tra i nomi utente visualizzati. È anche possibile rimuovere i destinatari.
Aggiungere un messaggio facoltativo nel campo Note (facoltativo) e quindi selezionare Invia. I destinatari ricevono un messaggio di posta elettronica che attira la loro attenzione e contiene un link alla richiesta pull.
Nota
Quando si usa la funzionalità di posta elettronica predefinita, è possibile inviare messaggi di posta elettronica solo agli indirizzi dei singoli membri del progetto. L'aggiunta di un gruppo di team o di un gruppo di sicurezza alla riga A: non è supportata. Se si aggiunge un indirizzo di posta elettronica non riconosciuto, viene visualizzato un messaggio che indica che uno o più destinatari non dispongono delle autorizzazioni per leggere la richiesta pull inviata tramite posta elettronica.
Affinché la funzionalità di posta elettronica funzioni, l'amministratore deve configurare un server SMTP.