Condividi tramite


Collegare commit GitHub, richieste pull e problemi a elementi di lavoro in Azure Boards

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

Questo articolo illustra come collegare gli elementi di lavoro ai commit e alle richieste pull di GitHub dopo aver connesso il progetto di Azure Boards con un repository GitHub. È possibile usare la sintassi #mention o aggiungere un collegamento di commit o richiesta pull di GitHub direttamente dall'elemento di lavoro di Azure Boards.

Nota

Con l'app Azure Boards per GitHub, Azure Boards e Azure DevOps Services si integrano con repository GitHub.com e GitHub Enterprise Server. Azure DevOps Server 2019 e versioni successive supportano l'integrazione solo con i repository GitHub Enterprise Server. L'integrazione con altri repository Git non è supportata.

Prerequisiti

  • Connessione progetto:

    • Verificare che il progetto di Azure Boards sia connesso al repository GitHub in cui esistono i commit e le richieste pull da collegare a/da. Per altre informazioni, vedere Integrazione di Azure Boards-GitHub.
  • Autorizzazioni:

    • Essere un collaboratore sia al progetto di Azure Boards che al repository GitHub.

Nota

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

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

Nota

Il collegamento a problemi di GitHub richiede Azure DevOps Server 2019 Update 1 o versione successiva.

AB#{ID}

Ad esempio, AB#125 collegamenti all'ID 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 fix, fixese fixede lo applica all'elemento #-mention che segue. Gli elementi di lavoro menzionati passano al primo Stato associato allo stato della categoria del flusso di lavoro risolto . Se non è associato alcuno stato a Resolved, l'elemento di lavoro passa allo stato dello stato della categoria del flusso di lavoro Completato. Per altre informazioni, vedere How workflow category states are used in Azure Boards backlogs and boards .For more information, see How workflow category states are used in Azure Boards backlogs and boards.

Esaminare la tabella di esempi seguente:

Eseguire il commit o il messaggio di richiesta pull Azione
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 .
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 Stato del flusso di lavoro risolto o, se non è definito alcun elemento, la categoria Stato 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 problema 123 di GitHub e all'elemento di lavoro di Azure Boards 234. Non vengono effettuate transizioni.

Nota

Se è stato connesso lo stesso repository GitHub ai progetti definiti in due o più organizzazioni di Azure DevOps, è possibile che venga visualizzato un collegamento di riferimento AB# imprevisto. 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 di Azure DevOps.

Creare un ramo 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 da cui si vuole creare un ramo GitHub.

  2. Selezionare Azioni>elemento di lavoro Nuovo ramo GitHub.

    Screenshot dell'elemento di lavoro Altre azioni selezionare e evidenziare l'opzione Nuovo ramo GitHub.

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

  4. Seleziona Crea.

    Screenshot della finestra di dialogo Crea un ramo GitHub.

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

Nota

Il collegamento a un problema di GitHub richiede Azure DevOps Server 2019 Update 1 o versione successiva.

  1. Aprire l'elemento di lavoro e passare alla scheda Collegamenti .

    Screenshot del modulo dell'elemento di lavoro, scheda Collegamenti, Aggiungi collegamento al problema.

  2. Nella finestra di dialogo Aggiungi collegamento selezionare uno dei tipi di collegamento di GitHub, selezionare un repository GitHub, immettere l'URL del ramo GitHub, eseguire il commit o la richiesta pull e quindi selezionare Aggiungi collegamento.

    Nell'esempio seguente viene aggiunto un collegamento a una richiesta pull di GitHub.

    Screenshot del modulo dell'elemento di lavoro, della scheda Collegamenti, della finestra di dialogo Aggiungi collegamento, del tipo di collegamento di richiesta pull di GitHub selezionato.

    Azure Boards completa un controllo per assicurarsi di aver immesso un collegamento valido. Il repository GitHub collegato deve essere connesso al progetto di Azure Boards o la convalida non riesce.

Nota

Si verifica un ritardo durante il completamento dei collegamenti AB# se si usa Azure DevOps Server e GitHub Enterprise Server. È disponibile una progettazione "push-and-pull" per eseguire il pull dagli eventi GitHub ogni ora sulle modifiche incrementali in commit, richiesta pull e problema.

La sezione Sviluppo all'interno del modulo dell'elemento di lavoro elenca i collegamenti creati ai commit e alle richieste pull di GitHub con l'icona di GitHub.

Screenshot del modulo dell'elemento di lavoro, la sezione Sviluppo mostra i collegamenti a GitHub.

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

Visualizzare gli oggetti GitHub in una scheda

Con le annotazioni di GitHub abilitate nella scheda, è possibile aprire rapidamente i commit di GitHub collegati, le richieste pull o i problemi per altri dettagli. Per altre informazioni, vedere Personalizzare le schede.

Screenshot della scheda che mostra i collegamenti GitHub nelle schede degli elementi di lavoro.

Passaggi successivi