Condividi tramite

Installare l'app Azure Boards per GitHub

Azure DevOps Services | 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

Category Requirements
Permissions - Membro del gruppoamministratori della raccolta progetti di. Se hai creato il progetto, hai le autorizzazioni.
- Administrator o proprietario dell'organizzazione GitHub per installare l'applicazione Azure Boards.
- Permessi di lettura per il repository GitHub.
Appartenenza al progetto membro del progetto.

Important

Se il repository è già connesso usando un altro tipo di autenticazione, ad esempio OAuth, è necessario rimuovere il repository dalla connessione esistente prima di riconnetterlo usando l'app GitHub. Seguire la procedura descritta in Aggiungi o rimuovi repository GitHub più avanti in questo articolo prima di configurare l'app GitHub.

È possibile connettere un'organizzazione Azure DevOps a più repository GitHub se si è un amministratore per tali repository. Non è consigliabile connettere un repository GitHub a più organizzazioni Azure DevOps.

Installare e configurare l'app Azure Boards

La sequenza di installazione può variare a causa della configurazione dell'account. Se necessario, seguire le istruzioni visualizzate tra i passaggi seguenti.

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

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

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

    In questo esempio vengono usati tutti i repository:

    Screenshot che mostra la pagina Installa e autorizza con tutti i repository selezionati.

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

    Screenshot mostra la pagina Configura il progetto Azure Boards in cui si seleziona un'organizzazione e project.

    È possibile connettere un solo progetto alla volta. Se si vogliono connettere altri progetti, è possibile farlo in un secondo momento, come descritto in Configurare altri progetti o repository più avanti in questo articolo.

Fornire accesso di Azure Boards all'organizzazione

Se necessario, per concedere GitHub l'accesso all'organizzazione Azure DevOps, seguire questa procedura.

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

    La screenshot mostra l'opzione Impostazioni nel tuo profilo.

  2. Selezionare Applicazioni in Integrazioni.

  3. Selezionare App GitHub autorizzate>Azure Boards.

    Lo screenshot mostra le app autorizzate di GitHub con Azure Boards in evidenza.

  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.

    Screenshot che mostra l'accesso alle organizzazioni con organizzazioni prive di accesso.

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 su Impostazioni > policy dell'app OAuth.

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

    Screenshot che mostra la politica di accesso alle applicazioni di terze parti.

Annotazioni

Per modificare questa impostazione, è necessario essere un proprietario o un amministratore dell'organizzazione.

Usare la connessione

A questo punto, l'integrazione Azure Boards-GitHub è completa. È possibile ignorare i passaggi successivi o eseguirli per comprendere le funzionalità supportate con la connessione.

  1. Nella scheda selezionare Nuovo elemento di lavoro per immettere un nuovo elemento di lavoro denominato "Aggiungi badge a README"- Problema (Basic), User Story (Agile) o Product Backlog Item (Scrum) a seconda del modello di processo usato dal progetto Azure Boards.

    Nella bacheca viene visualizzato un elemento di lavoro intitolato Add badge to README (Aggiungi badge a README ).

  2. Aprire l'elemento di lavoro, passare alla sezione Sviluppo e selezionare Aggiungi collegamento.

  3. Da TipoLink selezionare GitHub Pull Request.

  4. Selezionare il repository e inserire l'ID della richiesta di pull e un commento facoltativo.

  5. Selezionare Aggiungi collegamento.

    Screenshot che mostra l'azione Aggiungi collegamento nella user story, includendo la selezione del repository e le caselle vuote per l'input dell'ID della pull request e del commento facoltativo.

    Le azioni seguenti vengono eseguite automaticamente in background:

    • Aggiunge un badge al file README del primo repository nella lista dei repository GitHub collegati.
    • Crea un commit GitHub per l'aggiornamento eseguito aggiungendo la notifica al file README.
    • Crea una GitHub richiesta pull per unire le modifiche apportate al file README.
    • Collega il commit e la richiesta pull GitHub all'elemento di lavoro creato nel passaggio 1.

  6. Seleziona il primo collegamento alla pull request dall'elemento di lavoro.

    Screenshot mostra il modulo di problema per la richiesta pull aperta in GitHub.

    La richiesta pull di GitHub si apre in una nuova scheda del browser.

  7. Selezionare Merge pull request.

    La screenshot mostra il pull request di esempio in GitHub.

  8. Passare al file README del repository e visualizzare la notifica aggiunta.

    Screenshot mostra il repository GitHub con badge aggiunto.

    Per altre informazioni, vedere Aggiungi notifiche di stato per il repository 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, è consigliabile rimuovere la connessione e ricominciare con una nuova connessione.

  1. Dal progetto in Azure DevOps passare a Impostazioni progetto>GitHub connessioni.

  2. Per aggiungere o rimuovere repository, selezionare i puntini di sospensione Altre opzioni per la connessione e scegliere Aggiungi repository o Rimuovi repository dal menu.

    Screenshot mostra il menu di connessione GitHub sotto 'Altre opzioni'.

  3. Per rimuovere tutti i repository e la connessione, scegliere l'opzione Rimuovi connessione . Scegliere quindi Rimuovi per confermare.

    Lo screenshot mostra la conferma della rimozione della connessione GitHub.

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.

    Screenshot mostra le app GitHub installate con Azure Boards e l'opzione 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.

    Screenshot che mostra l'accesso al repository, in cui è possibile scegliere i repository selezionati.

  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.

    Screenshot che mostra la sezione Zona di pericolo, con opzioni per sospendere e disinstallare.

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

    Screenshot che mostra la finestra di dialogo di conferma della sospensione.

    Per annullare la sospensione dell'integrazione, scegliere Annulla sospensione.

  3. Per disinstallare l'app Azure Boards, scegliere Uninstall e quindi scegliere OK dalla finestra di conferma popup.

    Screenshot che mostra la finestra di dialogo di conferma della disinstallazione.

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. Scegliere Rimuovi connessione per rimuovere tutte le connessioni GitHub effettuate in precedenza. Per altre informazioni, vedere Aggiungere o rimuovere repository GitHub.

Lo screenshot mostra l'app Azure Boards GitHub disinstallata.

Passaggi successivi

Link commit, pull request e branch di GitHub agli elementi di lavoro

Contenuti correlati

  • Last updated on