Condividi tramite

Collega commit, pull request, branch e problemi di GitHub agli elementi di lavoro in Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Questo articolo illustra come collegare elementi di lavoro a GitHub commit, richieste pull, rami e compilazioni dopo aver collegato il progetto Azure Boards a un repository GitHub. È possibile usare la sintassi #mention per i commit e i rami, usare ! per menzionare le richieste pull di GitHub dalle discussioni degli elementi di lavoro, oppure aggiungere un collegamento a un commit, una richiesta pull o un ramo di GitHub direttamente dall'elemento di lavoro di Azure Boards.

Note

supporto per l'integrazione di GitHub:

  • Azure DevOps Services: si integra sia con i repository GitHub.com che con GitHub Enterprise Server tramite l'app Azure Boards per GitHub.
  • Azure DevOps Server 2020 e versioni successive: supporta l'integrazione solo con i repository di GitHub Enterprise Server.
  • Altri repository Git: l'integrazione non è supportata.

Prerequisites

Category Requirements
Permissions Contributor sia nel progetto di Azure Boards che nel repository di GitHub.
Connessione al progetto Il progetto di Azure Boards è connesso al repository GitHub in cui esistono i commit, le pull request e il ramo che si vuole collegare. Per altre informazioni, vedere integrazione Azure Boards-GitHub.

Note

Per visualizzare la sezione Sviluppo e i tipi di collegamento GitHub, i progetti che utilizzano il modello di processo XML ospitato necessitano di aggiornamenti ai tipi di elementi di lavoro. Per altre informazioni, vedere Aggiornare le definizioni XML per selezionare i tipi di elemento di lavoro.

Da un GitHub commit, una richiesta pull o un problema, usare la sintassi seguente per creare un collegamento all'elemento di lavoro Azure Boards. Immettere AB#ID all'interno del testo di un messaggio di commit. In alternativa, per una pull request o un problema, inserire AB#ID nella descrizione. L'uso AB#ID di in un commento o in un titolo della richiesta pull non crea un collegamento nell'elemento di lavoro.

AB#{ID}

Ad esempio, AB#125 collega all'ID dell'elemento di lavoro 125.

È anche possibile immettere un messaggio di commit o di richiesta pull per eseguire la transizione dell'elemento di lavoro. Il sistema riconosce {state} o {state category}, insieme a fix, fixes, fixed, e lo applica all'elemento #-mention che segue.

Quando una descrizione di una richiesta pull include un nome di stato valido, ad esempio , Closed AB#1234il sistema aggiorna l'elemento di lavoro a cui si fa riferimento a tale stato specifico. Se il nome dello stato non viene riconosciuto direttamente, Azure Boards prova a corrispondere a una categoria del flusso di lavoro come Resolved o Completed. Se viene trovata una corrispondenza, l'elemento di lavoro passa al primo stato disponibile definito in tale categoria.

Per impostazione predefinita, gli elementi di lavoro a cui si fa riferimento con fix, fixeso fixed passano al primo stato associato alla categoria Risolto . Se tale stato non esiste nel processo corrente, il sistema passa invece l'elemento di lavoro al primo stato nella categoria Completato .

Important

È comunque possibile collegare elementi di lavoro e indirizzare altri rami, ma le regole di transizione dello stato non si applicano a meno che la pull request non venga integrata nel ramo predefinito.

Per altre informazioni, vedere Come vengono usati gli stati delle categorie del flusso di lavoro nei backlog e schede di Azure Boards.

Esaminare la tabella di esempi seguente:

Messaggio di commit o di pull request Action
Fixed AB#123 Collega e passa l'elemento di lavoro alla categoria Stato del flusso di lavoro risolto oppure, se non è definito alcun elemento, la categoria Stato del flusso di lavoro completato .
Closed AB#123 Collega e passa l'elemento di lavoro allo stato Chiuso del flusso di lavoro. Se non è definito alcun oggetto , non vengono effettuate transizioni.
Adds a new feature, fixes AB#123. Collega e passa l'elemento di lavoro alla categoria Stato del flusso di lavoro risolto oppure, se non è definito alcun elemento, la categoria Stato del flusso di lavoro completato .
Fixes AB#123, AB#124, and AB#126 Collegamenti agli elementi di lavoro di Azure Boards 123, 124 e 126. Esegue la transizione solo del primo elemento, 123, alla categoria dello stato del flusso di lavoro Risolto oppure, se nessuna è definita, alla categoria dello stato del flusso di lavoro Completato.
Fixes AB#123, Fixes AB#124, Fixes AB#125 Collegamenti agli elementi di lavoro di Azure Boards 123, 124 e 126. Esegue la transizione di tutti gli elementi alla categoria Stato del flusso di lavoro risolto oppure, se non è definito alcun elemento, la categoria Stato flusso di lavoro completato .
Fixing multiple bugs: issue #123 and user story AB#234 Collegamenti al ticket GitHub 123 e ad Azure Boards work item 234. Non vengono effettuate transizioni.

Note

Se hai collegato lo stesso repository di GitHub ai progetti definiti in due o più organizzazioni Azure DevOps, potresti vedere collegamenti imprevisti menzione AB#. Per altre informazioni, vedere Risolvere i problemi di connessione. Per questo motivo, è consigliabile connettere un repository GitHub solo ai progetti definiti in una singola organizzazione Azure DevOps.

Quando si aggiunge un collegamento a un elemento di lavoro usando AB# in una descrizione della richiesta pull, tali collegamenti vengono visualizzati nella sezione Development della richiesta pull GitHub. Questi collegamenti sono disponibili solo quando si usa AB# nella descrizione della richiesta pull. Non vengono visualizzati se si collega alla richiesta pull direttamente dall'elemento di lavoro. La rimozione del AB# riferimento dalla descrizione lo rimuove anche dalla sezione Sviluppo.

Screenshot dei collegamenti AB# nella sezione sviluppo della pull request su GitHub.

Creare branch GitHub dall'elemento di lavoro

Per creare un ramo GitHub direttamente da un elemento di lavoro, seguire questa procedura:

  1. Dalla scheda individuare l'elemento di lavoro che si vuole usare per creare un ramo GitHub.

  2. Selezionare Azioni sugli elementi di lavoro>Nuovo branch GitHub.

    Screenshot dell'elemento di lavoro con l'opzione

  3. Nella finestra di dialogo Creare un ramo GitHub immettere il nome del ramo. Selezionare il repository di GitHub e il ramo di base.

  4. Fare clic su Crea.

    Screenshot della finestra di dialogo Crea un ramo GitHub.

    Azure Boards crea il ramo nel repository di GitHub specificato e lo collega all'elemento di lavoro. Per altre informazioni, vedere integrazione Azure Boards-GitHub.

  1. Aprire l'elemento di lavoro e passare all'area Sviluppo .

  2. Selezionare Aggiungi collegamento. In ogni menu a discesa, selezionare il tipo di link, il repository GitHub e la richiesta di pull su GitHub. È possibile cercare ed eseguire il drill-down all'interno del repository per trovare e selezionare una richiesta o un commit pull specifici, senza dover copiare e incollare un URL.

  3. Selezionare Aggiungi collegamento.

    Screenshot che mostra la sequenza in cinque passaggi per l'aggiunta di un collegamento di richiesta pull all'elemento di lavoro.

    Azure Boards verifica che sia stato immesso un collegamento valido. Il repository collegato a GitHub deve essere connesso al progetto Azure Boards o la convalida non riesce.

Note

Se si usano Azure DevOps Server e GitHub Enterprise Server, si verifica un ritardo durante il completamento dei collegamenti AB#. Il processo utilizza un design "push-and-pull" per eseguire il pull dagli eventi GitHub ogni ora sulle modifiche incrementali nei commit, Pull Request e Issue.

Diversi eventi aggiornano automaticamente i collegamenti nel modulo dell'elemento di lavoro, quindi non è necessario crearli manualmente. Questi eventi includono:

evento GitHub Action
Collegamento al ramo Quando viene creata una richiesta pull da un ramo, viene automaticamente collegata all'elemento di lavoro.
Eseguire il merge del commit Dopo aver unito la richiesta pull, il commit di merge risultante si collega automaticamente all'elemento di lavoro.
Elimina ramo Se il ramo viene eliminato (in genere dopo l'unione), il collegamento viene rimosso automaticamente dall'elemento di lavoro.

La sezione Sviluppo nel modulo dell'elemento di lavoro elenca i link creati per i commit e le pull request di GitHub utilizzando l'icona GitHub .

Screenshot del modulo dell'elemento di lavoro, nella sezione Sviluppo vengono mostrati i collegamenti GitHub.

Selezionare il collegamento per aprire la richiesta di commit o pull in GitHub.

GitHub informazioni dettagliate sulle richieste pull

Richieste pull di GitHub collegate nella sezione Sviluppo mostrano dettagli di stato aggiuntivi, per valutare i progressi senza aprire la pull request in GitHub.

Prerequisiti per gli approfondimenti sulle richieste pull

Per visualizzare informazioni dettagliate sulle richieste pull, passare all'app Azure Boards in GitHub e accettare le autorizzazioni aggiornate per l'accesso in lettura e scrittura alle Verifiche.

Screenshot della finestra di dialogo delle autorizzazioni dell'app Azure Boards GitHub che mostra le autorizzazioni di controllo aggiornate.

Visualizzare i dettagli dello stato della richiesta pull

  1. Aprire un elemento di lavoro che ha una pull request di GitHub collegata.

  2. Nella sezione Sviluppo trovare la richiesta pull collegata. Accanto al collegamento alla richiesta pull vengono visualizzati i dettagli di stato seguenti:

    • Stato bozza: indica se la richiesta pull è ancora una bozza.
    • Verifica stato: indica se la richiesta pull deve essere esaminata, è stata approvata o ha richiesto modifiche.
    • Controlla lo stato: indica se i controlli CI vengono superati, hanno esito negativo o in sospeso.

    Screenshot della sezione Sviluppo che mostra una pull request GitHub collegata con indicatori di dettaglio dello stato chiuso, revisione e controllo.

  3. Passare il puntatore del mouse su un indicatore di stato per visualizzare altri dettagli oppure selezionare il collegamento della richiesta pull per aprirlo direttamente in GitHub.

Menzionare le pull request di GitHub usando !

Usare ! menzioni per fare riferimento alle pull request di GitHub e discuterne direttamente da qualsiasi campo di testo avanzato o commento di discussione relativo a un elemento di lavoro. Quando si digita ! in un campo di testo, viene visualizzata una selezione che consente di cercare e selezionare una richiesta pull GitHub da un repository connesso. La richiesta pull selezionata viene inserita come collegamento selezionabile.

Questa funzionalità semplifica il riferimento alle richieste pull correlate nelle descrizioni degli elementi di lavoro, nei criteri di accettazione o nei thread di discussione senza copiare manualmente gli URL.

Gif che mostra come usare la menzione ! per fare riferimento a un pull request GitHub da una discussione di un elemento di lavoro.

Visualizzare lo stato della compilazione per le pipeline YAML (integrata nella compilazione)

Quando si usa Azure Pipelines YAML per compilare codice ospitato in un repository di GitHub, è possibile creare automaticamente Integrated in build collegamenti per gli elementi di lavoro associati. Questa funzionalità fornisce la tracciabilità della compilazione per GitHub repository, ottenendo la parità con l'esperienza disponibile per Azure Repos.

Per abilitare questa funzionalità:

  1. Aprire la pipeline YAML, selezionare Altre azioni e quindi selezionare Impostazioni.

  2. Nella finestra di dialogo Impostazioni pipeline abilitare Collega automaticamente nuovi elementi di lavoro in questa compilazione.

    Screenshot della finestra di dialogo delle impostazioni della pipeline YAML che mostra l'opzione per collegare automaticamente nuovi elementi di lavoro in questa compilazione.

Al termine della compilazione, nella sezione Sviluppo di ogni elemento di lavoro associato viene visualizzato automaticamente un collegamento Integrato nella compilazione, offrendo al team una tracciabilità completa dall'elemento di lavoro alla compilazione.

Screenshot dell'elemento di lavoro che mostra il collegamento integrato nella build nella sezione Sviluppo.

Per altre informazioni sulla configurazione di questa impostazione, vedere Configurare le pipeline per supportare il rilevamento del lavoro.

Visualizzare gli oggetti GitHub su una lavagna

Abilitando le annotazioni GitHub sul pannello, è possibile aprire rapidamente i commit GitHub collegati, le pull request o i problemi per maggiori dettagli. Per altre informazioni, vedere Personalizzare le schede.

Screenshot della bacheca che mostra collegamenti GitHub sulle schede degli elementi di lavoro.

Passaggi successivi

Configurare le notifiche di stato

Contenuti correlati

  • Last updated on