Condividi tramite

Installare l'app Azure Boards per GitHub

  • Articolo

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

Installare l'app di Azure Boards per collegare Azure Boards ai tuoi repository GitHub. Quando si connettono progetti di Azure Boards con repository GitHub.com, è supportato il collegamento tra i commit di GitHub e le richieste pull agli elementi di lavoro. È possibile usare GitHub per lo sviluppo di software durante l'uso di Azure Boards per pianificare e tenere traccia del lavoro.

Per una panoramica dell'integrazione supportata dall'app Azure Boards per GitHub, vedere Integrazione di Azure Boards-GitHub. Dopo aver installato l'app Azure Boards per GitHub nell'account GitHub o nell'organizzazione, scegliere i repository GitHub a cui connettersi dal progetto.

Prerequisiti

Categoria Requisiti
autorizzazioni - Membro del gruppoamministratori della raccolta progetti di. Se hai creato il progetto, hai le autorizzazioni.
- Amministratore o Proprietario dell'organizzazione GitHub per installare l'app Azure Boards.
- Leggere le autorizzazioni di per il repository GitHub.
L'appartenenza al progetto membro del progetto.

Importante

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

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

Concedere l'accesso all'organizzazione Azure Boards

Per concedere a GitHub l'accesso all'organizzazione Azure DevOps, seguire questa procedura.

  1. Dal portale Web GitHub aprire Impostazioni dal menu del profilo.

    Screenshot del profilo aperto. Scegliere Impostazioni.

  2. Selezionare Applicazioni in Integrazioni.

  3. Selezionare App GitHub autorizzate>Azure Boards.

    Scheda Screenshot delle App OAuth autorizzate, scegli 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.

    Screenshot delle impostazioni di accesso dell'organizzazione, con organizzazioni che non hanno accesso.

Installare e configurare l'app Azure Boards

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

  2. Scegli Configura un piano.

    Screenshot di GitHub Marketplace, pulsante Configura un piano.

  3. Scegliere l'organizzazione GitHub che si vuole connettere ad Azure Boards.

    Screenshot che mostra la finestra di dialogo Installa Azure Boards.

  4. Scegliere i repository da connettere ad Azure Boards.

    Nell'esempio seguente si sceglie di connettersi a tutti i repository.

    Screenshot che mostra tutti i repository selezionati.

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

    Screenshot della finestra di dialogo di configurazione della connessione.

    È 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.

  6. Per connettersi con GitHub.com, autorizzare l'organizzazione di Azure Boards.

    Screenshot della finestra di dialogo di autorizzazione di Azure Boards.

  7. Verificare i repository GitHub.com da connettere. Selezionare ogni repository a cui connettersi. Deselezionare tutti i repository che non si desidera partecipare all'integrazione.

    Screenshot della finestra di dialogo Conferma repository GitHub.

Usare la connessione

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

  1. Nel tuo pannello, seleziona Nuovo elemento di lavoro per inserire un nuovo elemento di lavoro denominato "Aggiungi badge a README" - Problema (Basic), User Story (Agile) o Product Backlog Item (Scrum), in base al modello di processo utilizzato dal tuo 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. Selezionare GitHub Pull Request dal menu a discesa del tipo di collegamento.

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

  5. Selezionare Aggiungi collegamento.

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

    Le azioni seguenti vengono eseguite automaticamente in background:

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

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

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

    La richiesta pull di GitHub viene aperta in una nuova scheda del browser.

  7. Selezionare Merge pull request.

    Screenshot della richiesta pull di esempio in GitHub.

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

    Screenshot del repository GitHub con il badge aggiunto.

    Per altre informazioni, vedere Configurare le notifiche di stato da aggiungere ai file README di GitHub.

Configurare altri progetti o repository

È possibile configurare altri progetti di Azure Boards/Azure DevOps, repository GitHub.com o modificare la configurazione corrente dalla pagina dell'app Azure Boards. Per altre informazioni, vedere Modificare l'accesso al repository GitHub o sospendere o disinstallare l'integrazione.

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 Connessioni GitHub.

  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 del menu di connessione di GitHub di Altre opzioni.

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

    Screenshot della rimozione della conferma della connessione GitHub.

Modificare l'accesso al repository

  1. Accedere a GitHub e aprire le impostazioni del profilo dell'organizzazione.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Vai a App GitHub installate>Azure Boards>Configura.
    Screenshot dell'apertura dell'account organizzazione, delle app GitHub installate, di Azure Boards, della configurazione.

    Verrà visualizzata la pagina di configurazione di 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 i repository selezionati, selezionare i repository che si desidera per l'integrazione con Azure Boards.

    Screenshot dell'accesso al repository, scegliere Solo 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 della sezione Configurazione di Azure Boards, Area di pericolo.

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

    Screenshot della conferma della sospensione.

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

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

    Screenshot della 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 GitHub di Azure Boards. È consigliabile rimuovere i repository in Azure Boards che non possono più connettersi a GitHub. Per ulteriori 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 progetto Connessioni>GitHub. Scegliere Rimuovi connessione per rimuovere tutte le connessioni GitHub stabilite in precedenza. Per ulteriori informazioni, vedere Aggiungere/rimuovere repository GitHub.

Screenshot dell'app GitHub di Azure Boards disinstallata.

Passaggi successivi

Collega commit, pull request e rami di GitHub agli elementi di lavoro