Completare, abbandonare o ripristinare le richieste pull

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Dopo che tutti i revisori necessari approvano la richiesta pull e la richiesta pull soddisfa tutti i requisiti dei criteri di ramo , è possibile unire le modifiche nel ramo di destinazione e completare la richiesta pull. In alternativa, se si decide di non procedere con le modifiche nella richiesta pull, è possibile abbandonare la richiesta pull.

Per risolvere le modifiche dei revisori e rispondere ai commenti di revisione e risolverli, vedere Risolvere i commenti.

Prerequisiti

• I repository devono essere abilitati nel progetto. Se l'hub Repos e le pagine associate non vengono visualizzate, vedere Attivare o disattivare un servizio Azure DevOps per riabilitare Repos.

• Per completare la richiesta pull, è necessario essere membri del gruppo di sicurezza Collaboratori o disporre delle autorizzazioni corrispondenti nel progetto in cui si trova la richiesta pull.

• Per contribuire a una richiesta pull, è necessario essere membri del gruppo di sicurezza Lettori o disporre delle autorizzazioni corrispondenti.

• Per visualizzare o esaminare le richieste pull, è necessario avere accesso Basic o superiore al progetto Azure DevOps.

• Se non sei membro del progetto a cui vuoi contribuire, aggiungi.

  Nota

  Per i progetti pubblici, gli utenti a cui è concesso l'accesso degli stakeholder hanno accesso completo ad Azure Repos.

• Per altre informazioni sulle autorizzazioni e l'accesso, vedere Repository Git predefinito e autorizzazioni di ramo e Informazioni sui livelli di accesso.

• In Azure DevOps Services è possibile gestire le richieste pull e altre risorse dall'interfaccia della riga di comando di Azure con l'estensione azure-devops . Per informazioni su come usare l'interfaccia della riga di comando di Azure DevOps Services, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps. I comandi dell'interfaccia della riga di comando di Azure Repos per le richieste pull usano az repos pr.

Controllare le modifiche di merge

Al termine di una richiesta pull, Git aggiunge un nuovo commit di merge alla fine del ramo principale. Questo commit di merge collega le cronologie precedenti del ramo principale e del ramo di origine della richiesta pull. Per visualizzare il commit di merge di anteprima e verificare la presenza di conflitti di unione, selezionare il menu Altre opzioni in alto a destra in una pagina Panoramica della richiesta pull e quindi selezionare Visualizza modifiche unione.

Se il ramo di destinazione è stato modificato dopo la creazione della richiesta pull, selezionare Riavvia unione per creare un nuovo commit di merge di anteprima e aggiornare la visualizzazione delle differenze di modifica unione.

Esaminare i criteri dei rami

Teams può impostare criteri di succursale che richiedono richieste pull in rami protetti per soddisfare criteri specifici prima che le richieste pull possano essere unite. È possibile visualizzare i criteri dei rami in vigore per la richiesta pull, indipendentemente dal fatto che siano necessari per l'unione e se la richiesta pull sta passando o non riesce.

Browser

La scheda Panoramica pull riepiloga i criteri dei rami che passano o hanno esito negativo per la richiesta pull. La panoramica elenca solo i criteri non riusciti, ma è possibile visualizzare tutti i controlli dei criteri selezionando Visualizza <n> controlli.

Nella pagina Panoramica della richiesta pull i requisiti dei criteri di ramo hanno un'icona . Selezionare Altre opzioni accanto al requisito e quindi selezionare Visualizza criterio per passare alla pagina Criteri di ramo del ramo in Project Impostazioni.

Visual Studio

È possibile aprire una richiesta pull in Visual Studio e quindi esaminare i criteri dei rami come descritto nella scheda Browser.

Per aprire una richiesta pull da Visual Studio, nel menu Git selezionare <il servizio>>Git Visualizza richieste pull e selezionare una richiesta pull per aprirla.

Visual Studio 2019 versione 16.8 e versioni successive offre un'esperienza di controllo della versione Git mantenendo al tempo stesso l'interfaccia utente git di Team Explorer . Per usare Team Explorer, deselezionare Strumenti>Opzioni>anteprima Funzionalità>Nuova esperienza utente Git dalla barra dei menu. È possibile eseguire l'esercizio delle funzionalità Git da entrambe le interfacce in modo intercambiabile.

Per accedere alle richieste pull da Visual Studio Team Explorer:

1. Connessione al progetto da Visual Studio.

2. Selezionare Visualizza>Team Explorer per aprire Team Explorer. È anche possibile premere CTRL+\, CTRL+M.

3. Da Home selezionare Richieste pull per visualizzare gli elenchi di richieste pull aperte dall'utente o assegnate all'utente.

4. Per aprire una richiesta pull nel portale Web e visualizzare i criteri in vigore, fare clic con il pulsante destro del mouse sulla richiesta pull e scegliere Apri nel browser.

Interfaccia della riga di comando di Azure DevOps

Per visualizzare tutti i criteri di ramo applicati per una richiesta pull, usare az repos pr policy list con il parametro obbligatorio id .

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

Parametri

Parametro	Descrizione
--id	ID della richiesta pull. Obbligatorio.
--detect	Rilevare automaticamente l'organizzazione. Valori accettati: false, true.
--org --organization	URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=<ORG_URL>. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.
--query-examples	Stringa JMESPath consigliata. È possibile copiare una delle query e incollarla dopo il --query parametro tra virgolette doppie per visualizzare i risultati. È possibile aggiungere una o più parole chiave posizionali in modo che i suggerimenti siano basati su queste parole chiave.
--skip	Numero di criteri da ignorare.
--subscription	Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s <NAME_OR_ID>.
--top	Numero massimo di criteri da elencare.

Esempio

Ad esempio, per visualizzare i criteri applicati alla richiesta pull #28, eseguire il comando seguente:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

Completare una richiesta pull

Dopo aver risolto eventuali conflitti di merge e la richiesta pull soddisfa tutti i criteri di ramo e ha tutte le approvazioni necessarie, è possibile completare la richiesta pull.

Browser

1. Selezionare Completa in alto a destra per completare la richiesta pull. In alternativa, selezionare la freccia a discesa accanto al pulsante Completa e selezionare una delle opzioni.

   

   • Completa: completare la richiesta pull e unire le modifiche al ramo di destinazione.
   • Impostare il completamento automatico: configurare la richiesta pull per completare e unire una volta soddisfatti tutti i criteri di ramo necessari.
   • Contrassegna come bozza: restituisce la richiesta pull allo stato bozza e rimuove tutti i voti.
   • Abbandono: chiudere la richiesta pull senza unire le modifiche.

2. Nel riquadro Completa richiesta pull, in Tipo di unione selezionare una delle opzioni di unione.

   

   • Merge (senza avanzamento rapido): unisci con una cronologia non lineare che mantiene tutti i commit.
   • Commit di squash: unisci con una cronologia lineare che combina tutti i commit di origine in un singolo commit nella destinazione o lo squash unisce la richiesta pull. Tenere presente che verrà creato un nuovo commit per il ramo di destinazione senza mantenere la cronologia dei commit dal ramo di origine.
   • Rebase e fast-forward: rebase the source commits on the target and fast-forward ( Ribase the source commits on the target and fast-forward).
   • Unione semi-lineare: esegue il commit dell'origine di rebase nella destinazione e crea un'unione a due elementi padre.

   Nota

   I criteri esistenti vengono applicati. Ad esempio, se il ramo dispone attualmente di un criterio "solo merge squash", è necessario modificare tale criterio se si vuole usare un altro tipo di unione.

3. Selezionare una delle opzioni di post-completamento seguenti. Alcune opzioni non sono disponibili per alcuni tipi di merge.

   • Completare gli elementi di lavoro associati dopo l'unione: completare tutti gli elementi di lavoro collegati.
   • Eliminare <il nome> del ramo dopo l'unione: eliminare il ramo di origine della richiesta pull dopo l'unione.
   • Personalizzare il messaggio di commit di merge: aggiungere un messaggio di commit di merge personalizzato. Se si seleziona questa opzione, aggiornare il messaggio di commit di merge .
   • Eseguire l'override dei criteri dei rami e abilitare l'unione. Forzare l'unione anche se la richiesta pull non soddisfa tutti i criteri di ramo. Questa opzione è disponibile solo se si dispone dell'autorizzazione esentata dall'imposizione dei criteri.

4. Selezionare Completa merge.

Al termine dell'unione, tutti gli elementi di lavoro collegati vengono aggiornati automaticamente per visualizzare il completamento della richiesta pull.

Visual Studio

Per completare una richiesta pull, aprire la richiesta pull nel browser e nella pagina Panoramica selezionare Completa o imposta altre opzioni.

Per aprire una richiesta pull da Visual Studio, nel menu Git selezionare <il servizio>>Git Visualizza richieste pull e selezionare una richiesta pull per aprirla.

Per accedere alle richieste pull da Visual Studio 2019 Team Explorer:

1. Connessione al progetto da Visual Studio.

2. Selezionare Visualizza>Team Explorer per aprire Team Explorer. È anche possibile premere CTRL+\, CTRL+M.

3. Da Home selezionare Richieste pull per visualizzare gli elenchi di richieste pull aperte dall'utente o assegnate all'utente.

4. Per aprire una richiesta pull nel portale Web, fare clic con il pulsante destro del mouse sulla richiesta pull e scegliere Apri nel browser.

Interfaccia della riga di comando di Azure DevOps

Per completare una richiesta pull e unire le modifiche, usare az repos pr update per aggiornare la richiesta --status pull a completed.

Ad esempio, per completare la richiesta pull n. 21, usare:

az repos pr update --id 21 --status completed

Impostare le opzioni di completamento

È possibile impostare le opzioni di completamento delle richieste pull quando si crea una richiesta pull con az repos pr createo si aggiornano le opzioni di creazione nelle richieste pull esistenti con az repos pr update.

Le opzioni di completamento della richiesta pull includono:

• bypass-policy {false, true}: se ignorare i criteri necessari e completare la richiesta pull una volta che può essere unita.
• bypass-policy-reason: motivo per ignorare i criteri richiesti.
• delete-source-branch {false, true}: indica se eliminare il ramo di origine dopo il completamento e il merge della richiesta pull.
• merge-commit-message: personalizzare il messaggio di commit di merge.
• squash {false, true}: indica se eseguire il commit dell'origine in un singolo commit di destinazione per l'unione.
• transition-work-items {false, true}: indica se risolvere gli elementi di lavoro collegati quando viene eseguita l'unione della richiesta pull.

Per impostare le opzioni di completamento e completare una richiesta pull esistente, usare az repos pr update con il parametro obbligatorio id .

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Parametri

Parametro	Descrizione
--id	ID della richiesta pull. Obbligatorio.
--auto-complete	Impostare la richiesta pull da completare automaticamente quando tutti i criteri sono stati superati e il ramo di origine può essere unito al ramo di destinazione. Valori accettati: false, true.
--bypass-policy	Ignorare i criteri necessari e completare la richiesta pull una volta che può essere unita. Valori accettati: false, true.
--bypass-policy-reason	Motivo per ignorare i criteri richiesti.
--delete-source-branch	Eliminare il ramo di origine dopo che la richiesta pull è stata completata e unita nel ramo di destinazione. Valori accettati: false, true.
--description -d	Nuova descrizione per la richiesta pull. Può includere Markdown. Ogni valore è una nuova riga. Ad esempio: --description "First Line" "Second Line".
--detect	Rilevare automaticamente l'organizzazione. Valori accettati: false, true.
--draft	Convertire la richiesta pull in modalità bozza o pubblicarla. Valori accettati: false, true.
--merge-commit-message	Messaggio da visualizzare quando vengono uniti i commit.
--org --organization	URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=<ORG_URL>. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.
--squash	Eseguire lo squash dei commit nel ramo di origine durante l'unione nel ramo di destinazione. Valori accettati: false, true.
--status	Impostare il nuovo stato della richiesta pull. Valori accettati: abandoned, active, completed.
--subscription	Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s <NAME_OR_ID>.
--title	Nuovo titolo per la richiesta pull.
--transition-work-items	Eseguire la transizione di tutti gli elementi di lavoro collegati alla richiesta pull nello stato logico successivo, ad esempio Risolto. Valori accettati: false, true.

Esempio

L'esempio seguente completa la richiesta pull n. 21, elimina il ramo di origine, risolve gli elementi di lavoro collegati e aggiunge un messaggio di commit di merge:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Ribase durante il completamento della richiesta pull

Durante il completamento della richiesta pull non sono possibili alcune situazioni:

• Se un criterio nel ramo di destinazione impedisce l'uso di strategie di ribase, è necessaria l'autorizzazione Override dei criteri dei rami per la ribase.
• Se il ramo di origine della richiesta pull dispone di criteri, non è possibile ripristinarlo. La ribasatura modifica il ramo di origine senza passare attraverso il processo di approvazione dei criteri.
• Se è stata usata l'estensione dei conflitti di merge per risolvere i conflitti di merge, non è possibile eseguire nuovamente la base. Le risoluzioni dei conflitti applicate a un'unione a tre vie raramente hanno esito positivo o valido quando si ribasano singolarmente tutti i commit della richiesta pull.

In tutti questi casi, è comunque possibile ribasere il ramo in locale e quindi eseguire il push upstream o unire le modifiche al termine della richiesta pull.

Problema di base di unione multipla

In alcuni casi, una richiesta pull ha più di una vera base di merge e questa situazione può causare problemi di sicurezza. Se i file nella richiesta pull hanno versioni diverse tra le basi di merge, si genera un avviso che indica la presenza di una base di merge multipla. Per altre informazioni e correzione, vedere Più basi di merge.

Risolvere i conflitti di unione

Le modifiche apportate ai file nel ramo possono essere in conflitto con le modifiche in un altro ramo. Quando non è chiaro come unire le modifiche, Git mostra i file in conflitto nella pagina Panoramica della richiesta pull. È necessario risolvere eventuali conflitti di unione tra il ramo pr e il ramo di destinazione prima di poter unire una richiesta pull o impostare la richiesta pull su completamento automatico. Per istruzioni sulla risoluzione dei conflitti di merge, vedere Risolvere i conflitti di merge.

Impostare una richiesta pull per il completamento automatico

Browser

Selezionare Imposta completamento automatico nell'elenco a discesa Completa per completare e unire le modifiche della richiesta pull non appena le condizioni soddisfano tutti i criteri dei rami. Al termine della richiesta pull, si riceve una notifica tramite posta elettronica. Se un conflitto o un errore impedisce il completamento della richiesta pull, invia una notifica tramite posta elettronica al problema.

Nota

L'opzione Imposta completamento automatico è disponibile in Azure Repos e TFS 2017 e versioni successive quando si dispone di criteri di ramo. Se non viene visualizzato Impostare il completamento automatico, non sono presenti criteri di ramo. Per altre informazioni, vedere Criteri di ramo.

Per impostazione predefinita, una richiesta pull impostata su completamento automatico attende solo sui criteri richiesti. Nel pannello Abilita completamento automatico è possibile scegliere di attendere anche i criteri facoltativi.

A partire da TFS 2018 Update 2, nella pagina Panoramica della richiesta pull viene visualizzato l'elenco dei criteri in sospeso che la richiesta pull è in attesa. Se si imposta un criterio da richiedere nel pannello Abilita completamento automatico, è possibile impostarlo su facoltativo nella pagina Panoramica .

Selezionare Annulla completamento automatico per disattivare il completamento automatico.

Una richiesta pull impostata sul completamento automatico visualizza un badge di completamento automatico nella pagina Richieste pull.

Visual Studio

Aprire una richiesta pull nel portale Web. Nella pagina Panoramica selezionare Imposta completamento automatico.

Per aprire una richiesta pull da Visual Studio, nel menu Git selezionare <il servizio>>Git Visualizza richieste pull e selezionare una richiesta pull per aprirla.

Per accedere alle richieste pull da Visual Studio 2019 Team Explorer:

1. Connessione al progetto da Visual Studio.

2. Selezionare Visualizza>Team Explorer per aprire Team Explorer. È anche possibile premere CTRL+\, CTRL+M.

3. Da Home selezionare Richieste pull per visualizzare gli elenchi di richieste pull aperte dall'utente o assegnate all'utente.

4. Per aprire una richiesta pull nel portale Web e visualizzare i criteri in vigore, fare clic con il pulsante destro del mouse sulla richiesta pull e scegliere Apri nel browser.

Interfaccia della riga di comando di Azure DevOps

Impostare il completamento automatico per completare automaticamente una richiesta pull quando passa tutte le approvazioni e i criteri di ramo necessari. È possibile impostare il completamento automatico alla creazione della richiesta pull o aggiornare una richiesta pull esistente.

• Per impostare il completamento automatico al momento della creazione della richiesta pull, usare az repos pr create --auto-complete true.
• Per aggiornare una richiesta pull esistente al completamento automatico, usare az repos pr update --id <PR Id> --auto-complete true.

Abbandonare o riattivare una richiesta pull

Browser

Per abbandonare le modifiche e la richiesta pull senza unire, selezionare Abbandona dall'elenco a discesa nel pulsante Completa . È comunque possibile visualizzare la richiesta pull abbandonata e rimane collegata agli elementi di lavoro.

Per riattivare una richiesta pull abbandonata in qualsiasi momento, aprire la richiesta pull dalla scheda Abbandonata nella visualizzazione Richiesta pull e selezionare Riattiva in alto a destra.

Visual Studio

Aprire una richiesta pull nel portale Web. Nella pagina Panoramica selezionare Abbandona.

Per aprire la richiesta pull nel portale Web, usare la procedura descritta in Completare una richiesta pull.

Interfaccia della riga di comando di Azure DevOps

Per abbandonare una richiesta pull senza unire le modifiche, usare az repos pr update --id <PR Id> –-status abandoned. È possibile riattivare la richiesta pull impostando lo stato su active.

Ripristinare una richiesta pull completata

Per annullare le modifiche da una richiesta pull, seguire questa procedura. Per altre informazioni, vedere Annullare le modifiche.

1. Aprire la richiesta pull completata e selezionare Ripristina. Questa azione crea un nuovo ramo con modifiche che annullano la richiesta pull in un ramo di destinazione esistente nel repository.

2. Nel riquadro Ripristina richiesta pull:

   1. In Ramo di destinazione selezionare il ramo in cui si desidera annullare le modifiche della richiesta pull.
   2. In Nome ramo argomento obbligatorio modificare il nome del ramo di aggiornamento pull, se necessario.
   3. Selezionare Ripristina.

3. Nella schermata Nuova richiesta pull selezionare Crea.

4. Unire la nuova richiesta pull per completare il ripristino.

Nota

Il ramo creato durante questo ripristino ha un singolo commit che ripristina tutte le modifiche apportate al file dalla richiesta pull originale. Il ramo non contiene un commit ripristinato per ognuno dei commit nella richiesta pull originale.

Passaggi successivi

Copiare le modifiche con cherry-pick

Articoli correlati

• Notifiche di aggiornamento delle richieste pull
• Informazioni sulle richieste pull e sulle autorizzazioni