Installare l'app Azure Boards per GitHub

servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

In questa guida introduttiva, installa l'app Azure Boards per GitHub per connettere Azure Boards ai repository GitHub. Quando si collegano i progetti di Azure Boards con i repository di GitHub.com, si abilita il collegamento tra commit GitHub e pull request agli item di lavoro. È possibile usare GitHub per lo sviluppo di software durante l'uso di Azure Boards per pianificare e tenere traccia del lavoro. Dopo aver installato l'app Azure Boards per GitHub nell'account o nell'organizzazione GitHub, scegliere a quali repository GitHub connettersi dal progetto.

Per una panoramica dell'integrazione supportata dall'app Azure Boards per GitHub, vedere integrazione Azure Boards-GitHub.

Prerequisites

Installare e configurare l'app Azure Boards

I passaggi seguenti illustrano una sequenza di installazione tipica. Seguire le istruzioni visualizzate per completare la configurazione.

1. Passare all'app Azure Boards nel GitHub Marketplace.

2. In Piani e prezzi, in Gratuito, selezionare Installa.

3. In Installa & Autorizzare Azure Boards, scegliere i repository da connettere a Azure Boards e quindi selezionare Installa e Autorizzare.

   In questo esempio vengono usati tutti i repository:

   

4. Scegliere l'organizzazione Azure DevOps e il progetto di Azure Boards da connettere a GitHub.com.

   

   È possibile connettere un solo progetto alla volta. Per connettere altri progetti, vedere Configurare altri progetti o repository.

Concedere l'accesso all'organizzazione Azure Boards

Per concedere GitHub l'accesso all'organizzazione Azure DevOps, completare la procedura seguente.

1. Dal portale Web di GitHub aprire Settings dal menu del profilo.

   

2. Selezionare Applicazioni in Integrazioni.

3. Selezionare App GitHub autorizzate>Azure Boards.

   

4. In Accesso all'organizzazione risolvere eventuali problemi che potrebbero verificarsi. Selezionare Concedi per concedere l'accesso a tutte le organizzazioni che mostrano la presenza di una richiesta di Accesso in sospeso.

   

Controllare i criteri di accesso alle applicazioni di terze parti

Assicurarsi che l'organizzazione GitHub consenta l'accesso alle applicazioni di terze parti per l'app Azure Boards. Se l'accesso di terze parti è limitato, l'aggiunta di repository da Azure DevOps può visualizzare un elenco vuoto o generare un errore.

Per abilitare l'accesso:

1. In GitHub, apri la tua organizzazione e vai a Impostazioni>Criteri per le app OAuth.

2. Approvare l'app Azure Boards specificamente (scelta consigliata) o rimuovere restrizioni per tutte le applicazioni di terze parti.

   

Collegare elementi di lavoro alle richieste pull di GitHub

Dopo aver configurato l'integrazione tra Azure Boards e GitHub, puoi collegare i tuoi elementi di lavoro alle pull request e ai commit di GitHub.

L'esempio seguente illustra l'integrazione creando un elemento di lavoro e collegandolo a una richiesta pull:

1. Nella scheda selezionare Nuovo elemento di lavoro per creare un elemento di lavoro. Per questo esempio, usare il titolo "Aggiungi badge a README". Il tipo di elemento di lavoro dipende dal processo: Issue (Basic), User Story (Agile) o Product Backlog Item (Scrum).

   Il nuovo elemento di lavoro viene visualizzato nella scheda.

2. Aprire l'elemento di lavoro e passare alla sezione Sviluppo .

3. Selezionare Aggiungi collegamento e quindi selezionare GitHub Richiesta pull dal menu Tipo di collegamento.

4. Selezionare il repository e immettere l'ID della pull request. È anche possibile aggiungere un commento facoltativo.

5. Selezionare Aggiungi collegamento per creare la connessione.

   Azure Boards esegue automaticamente le azioni seguenti in background:

   • Aggiunge un badge al file README del primo repository nell'elenco dei repository GitHub connessi
   • Crea un commit GitHub per l'aggiornamento del badge
   • Crea una richiesta pull GitHub per unire le modifiche al file README
   • Collega il commit GitHub e la richiesta pull all'elemento di lavoro

6. Nell'elemento di lavoro selezionare il collegamento alla richiesta pull per aprirlo in GitHub.

7. Selezionare Unisci pull request in GitHub.

8. Nel tuo repository GitHub, apri il file README per verificare che il badge sia stato aggiunto. Per altre informazioni, vedere Configurare le notifiche di stato da aggiungere ai file README GitHub.

Configurare altri progetti o repository

È possibile configurare altri progetti Azure Boards/Azure DevOps, GitHub.com repository o modificare la configurazione corrente dalla pagina dell'app Azure Boards. Per altre informazioni, vedere Aggiungere o rimuovere repository oppure rimuovere una connessione da Azure Boards.

Aggiungere o rimuovere repository o rimuovere una connessione da Azure Boards

Se si verifica un problema con una connessione, rimuovere la connessione e ricominciare con una nuova connessione.

Modificare l'accesso al repository

1. Dal portale Web di GitHub aprire Settings dal menu del profilo.

2. Selezionare Applicazioni di integrazione>. In Installato GitHub Apps selezionare Configura.

   

   Verrà visualizzata la pagina di configurazione Azure Boards.

3. Scorrere verso il basso fino alla sezione Accesso al repository.

4. Scegliere l'opzione desiderata, Tutti i repository o Selezionare solo i repository.

   Se si sceglie Solo selezionare i repository, selezionare i repository che si desidera includere nell'integrazione con Azure Boards.

   

5. Seleziona Salva.

Sospendere o disinstallare l'integrazione di Azure Boards

1. A partire dal passaggio 2 della procedura precedente, scorrere verso il basso fino alla sezione Zona di pericolo.

   

2. Per sospendere l'integrazione, selezionare Sospendi. Nella finestra di conferma selezionare OK per confermare la sospensione.

   

   Per riattivare l'integrazione, selezionare Riattiva.

3. Per disinstallare l'app Azure Boards, selezionare Disinstalla e quindi selezionare OK nella finestra di conferma popup.

   

Aggiornare le connessioni Azure Boards-GitHub

Se si modificano i repository supportati dall'app Azure Boards per GitHub, è possibile che venga reindirizzato alle connessioni Azure Boards GitHub. È consigliabile rimuovere i repository in Azure Boards che non possono più connettersi a GitHub. Per altre informazioni, vedere Aggiungere o rimuovere repository GitHub.

Se si disinstalla l'app Azure Boards per GitHub, il messaggio seguente viene visualizzato in Azure Boards, Impostazioni del progetto>GitHub. Selezionare Rimuovi connessione per rimuovere tutte le connessioni GitHub effettuate in precedenza. Per altre informazioni, vedere Aggiungere o rimuovere repository GitHub.

Risolvere i problemi di integrazione

Elenco di repository vuoto durante l'aggiunta di repository

Se l'elenco dei repository viene visualizzato vuoto in Azure DevOps:

• Verificare che l'organizzazione GitHub abbia abilitato l'accesso alle app di terze parti.
• Assicurarsi di concedere Azure Boards l'autorizzazione per accedere all'organizzazione in Concedere l'accesso all'organizzazione Azure Boards.
• In GitHub, controlla le impostazioni dell'organizzazione > App GitHub installate > Azure Boards > Accesso dell'organizzazione. Se lo stato mostra "Richiesta di accesso in sospeso", selezionare Concedi per approvare.

"Richiesta di accesso in sospeso" in stato bloccato

Se l'accesso all'organizzazione rimane in sospeso:

• Per approvare la richiesta, è necessario essere un amministratore o un proprietario dell'organizzazione GitHub.
• Selezionare Concedi nella sezione Accesso all'organizzazione delle impostazioni delle app autorizzate.
• Se il problema persiste, disinstallare l'app Azure Boards e reinstallarla seguendo la procedura descritta in Installare e configurare l'app Azure Boards.

Badge non visualizzato dopo il collegamento di una pull request

Se il badge non viene visualizzato nel file README dopo aver collegato una pull request:

• Il badge viene visualizzato solo quando colleghi la pull request e il repository è il primo nel tuo elenco degli elementi connessi.
• Verifica che la PR che hai collegato sia ancora aperta (le PR sottoposte a merge non attivano la creazione del badge).
• Verifica che Azure Boards abbia accesso in scrittura al repository.

Errori di autenticazione o autorizzazioni

Se vengono visualizzati errori di autenticazione durante l'installazione:

• Verificare di essere un proprietario o un amministratore dell'organizzazione in GitHub.
• Assicurarsi che l'organizzazione GitHub non abbia limitato l'accesso alle applicazioni di terze parti.
• Verificare di disporre delle autorizzazioni di lettura per il repository che si vuole connettere.
• Prova a disconnetterti da GitHub e ad accedere di nuovo, quindi riprova l'autorizzazione.

Passo successivo

Contenuti correlati

• Promuovere lo sviluppo Git da un elemento di lavoro
• Modificare l'accesso al repository di GitHub, oppure sospendere o disinstallare l'integrazione
• Configurare le notifiche di stato da aggiungere ai file README GitHub