Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Questo articolo illustra come collegare elementi di lavoro a commit, richieste pull, rami e compilazioni di GitHub dopo aver collegato il progetto di Azure Boards a un repository GitHub. È possibile usare la sintassi #mention per i commit e i rami, usare ! menzioni per fare riferimento alle richieste pull di GitHub dalle discussioni degli elementi di lavoro o aggiungere un collegamento gitHub commit, richiesta pull o ramo direttamente dall'elemento di lavoro di Azure Boards.
Note
Supporto per l'integrazione di GitHub:
- Azure DevOps Services: si integra sia con GitHub.com che con i repository GitHub Enterprise Server tramite l'app Azure Boards per GitHub.
- Azure DevOps Server 2020 e versioni successive: supporta l'integrazione solo con i repository GitHub Enterprise Server.
- Altri repository Git: l'integrazione non è supportata.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Collaboratore sia al progetto di Azure Boards che al repository GitHub. |
| Connessione al progetto | Il progetto Di Azure Boards è connesso al repository GitHub in cui esistono i commit, le richieste pull e il ramo a cui si vuole collegare o da cui si desidera eseguire il collegamento. Per altre informazioni, vedere Integrazione di Azure Boards-GitHub. |
Note
Per visualizzare la sezione Sviluppo e i tipi di collegamento a GitHub, i progetti che usano il modello di processo XML ospitato richiedono aggiornamenti ai tipi di elemento di lavoro. Per altre informazioni, vedere Aggiornare le definizioni XML per selezionare i tipi di elemento di lavoro.
Usare AB# per collegare da GitHub agli elementi di lavoro di Azure Boards
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 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 tenta di associare il nome 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 ulteriori informazioni, vedere Come vengono utilizzati gli stati delle categorie di flusso di lavoro nei backlog e nelle bacheche 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 problema 123 di GitHub e all'elemento di lavoro di Azure Boards 234. Non vengono effettuate transizioni. |
Note
Se hai collegato lo stesso repository GitHub ai progetti definiti in due o più organizzazioni di Azure DevOps, potresti vedere menzioni AB# inaspettate. 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.
Quando si aggiunge un collegamento a un elemento di lavoro usando AB# in una descrizione della richiesta pull, tali collegamenti vengono visualizzati nella sezione Sviluppo della richiesta pull di 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.
Creare un ramo GitHub dall'elemento di lavoro
Per creare un ramo GitHub direttamente da un elemento di lavoro, seguire questa procedura:
Dalla scheda individuare l'elemento di lavoro che si vuole usare per creare un ramo GitHub.
Selezionare
Azioni >Nuovo ramo GitHub.
Nella finestra di dialogo Crea un ramo GitHub immettere il nome del ramo. Selezionare il repository GitHub e il ramo di base.
Fare clic su Crea.
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.
Aggiungere un collegamento dell'elemento di lavoro a un ramo, un commit o una richiesta pull di GitHub
Aprire l'elemento di lavoro e passare all'area Sviluppo .
Selezionare Aggiungi collegamento. Da ogni menu a discesa selezionare il tipo di collegamento, il repository GitHub e la richiesta pull di 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.
Selezionare Aggiungi collegamento.
Azure Boards verifica di aver immesso un collegamento valido. Il repository GitHub collegato deve essere connesso al progetto di Azure Boards o la convalida non riesce.
Note
Se si usa Azure DevOps Server e GitHub Enterprise Server, si verifica un ritardo durante il completamento dei collegamenti AB#. Il processo utilizza una progettazione "push-and-pull" per eseguire il pull dagli eventi di GitHub ogni ora sulle modifiche incrementali relative a commit, pull request e issue.
Aggiornamenti automatici dei collegamenti
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. |
Visualizzare o aprire collegamenti dalla sezione Sviluppo
La sezione Sviluppo nel modulo dell'elemento di lavoro elenca i collegamenti creati ai commit e alle richieste pull di GitHub usando l'icona 
GitHub.
Selezionare il collegamento per aprire la richiesta di commit o pull in GitHub.
Informazioni dettagliate sulle richieste pull di GitHub
Le richieste pull di GitHub collegate nella sezione Sviluppo mostrano dettagli aggiuntivi sullo stato, in modo da poter valutare lo stato di avanzamento senza aprire la richiesta pull 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 a Controlli.
Visualizzare i dettagli dello stato della richiesta pull
Aprire un elemento di lavoro con una richiesta pull di GitHub collegata.
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.
Passare il puntatore del mouse su un indicatore di stato per visualizzare altri dettagli o selezionare il collegamento alla richiesta pull per aprirlo direttamente in GitHub.
Menzionare le richieste pull di GitHub usando !
Usare ! menzioni per fare riferimento e discutere le richieste pull di GitHub direttamente da qualsiasi campo RTF o commento di discussione dell'elemento di lavoro. Quando si digita ! in un campo di testo, compare un selettore che è possibile utilizzare per cercare e selezionare una pull request di 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.
Visualizzare lo stato della compilazione per le pipeline YAML (integrata nella compilazione)
Quando si usa Azure Pipelines YAML per compilare il codice ospitato in un repository GitHub, è possibile creare automaticamente collegamenti di compilazione integrati negli elementi di lavoro associati. Questa funzionalità offre la tracciabilità della compilazione per i repository GitHub, ottenendo la parità con l'esperienza disponibile per Azure Repos.
Per abilitare questa funzionalità:
Aprire la pipeline YAML, selezionare
Altre azioni e quindi selezionare Impostazioni.Nella finestra di dialogo Impostazioni pipeline abilitare Collega 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.
Per altre informazioni sulla configurazione di questa impostazione, vedere Configurare le pipeline per supportare il rilevamento del lavoro.
Visualizzare gli oggetti GitHub in una scheda
Abilitando le annotazioni di GitHub nella scheda, è possibile aprire rapidamente i commit, le richieste pull o i problemi di GitHub collegati per altri dettagli. Per altre informazioni, vedere Personalizzare le schede.
Passaggi successivi
Contenuti correlati
- Integrare Azure Boards con GitHub
- Configurare le pipeline per supportare il tracciamento del lavoro
- Informazioni sull'uso degli stati di categoria del flusso di lavoro nei backlog e nelle bacheche di Azure Boards
- Collegare elementi di lavoro a oggetti
- Risolvere i problemi di integrazione di GitHub e Azure Boards