Installare l'app Azure Boards per GitHub

  • Articolo

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

Installare l'app Azure Boards per GitHub per connettere Azure Boards ai 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

Autorizzazioni:

  • Per installare l'app Azure Boards, è necessario essere un amministratore o un proprietario dell'organizzazione GitHub.
  • È necessario disporre delle autorizzazioni di lettura per il repository GitHub.
  • È necessario essere membri del gruppo Project Collection Administrators. Se il progetto è stato creato, si dispone già di queste autorizzazioni.

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

    Screenshot della scheda App OAuth autorizzate, scegliere 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 dell'accesso dell'organizzazione con le organizzazioni senza accesso.

Installare e configurare l'app Azure Boards

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

  2. Selezionare 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. 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 di 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 (Richiesta pull GitHub) dal menu a discesa Tipo di collegamento.

  4. Selezionare il repository e immettere l'ID richiesta pull e un commento facoltativo.

  5. Selezionare Aggiungi collegamento.

    Screenshot dell'azione Aggiungi collegamento nella storia utente, che mostra la selezione del repository e le caselle vuote per l'input dell'ID richiesta pull e del commento facoltativo.

    Le azioni seguenti vengono eseguite automaticamente in background:

    • Aggiunge una notifica al file README del primo repository nell'elenco dei repository GitHub connessi.
    • 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. Selezionare il primo collegamento alla richiesta pull 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 (Unisci la richiesta pull).

    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 la notifica aggiunta.

    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.

  1. Per aggiungere o rimuovere repository, aprire l'icona azioni per la connessione e scegliere Aggiungi repository o Rimuovi repository dal menu.

    Screenshot dell'aggiunta o della rimozione di repository GitHub.

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

    Screenshot della conferma della finestra di dialogo di rimozione 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. Passare a Installazione di App>GitHub di Azure Boards.>
    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 repository selezionati, selezionare i repository che si desidera partecipare all'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 l'apertura dell'integrazione, scegliere Annulla apertura.

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

Screenshot dell'app GitHub di Azure Boards disinstallata.

Passaggi successivi

Collegare i commit e le richieste pull di GitHub agli elementi di lavoro