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 | Azure DevOps Server 2020
In questa guida introduttiva si installa 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. Dopo aver installato l'app Azure Boards per GitHub nell'account GitHub o nell'organizzazione, scegliere i repository GitHub a cui connettersi dal progetto.
Per una panoramica dell'integrazione supportata dall'app Azure Boards per GitHub, vedere Integrazione di Azure Boards-GitHub.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | - 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. |
| 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 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. Non è consigliabile connettere un repository GitHub a più organizzazioni di 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.
Passare all'app Azure Boards nell'GitHub Marketplace.
In Piani e prezzi, in Gratuito, selezionare Installa.
In Installa e autorizza Azure Boards scegliere i repository da connettere ad Azure Boards, quindi selezionare Installa e autorizza.
In questo esempio vengono usati tutti i repository:
Scegliere l'organizzazione di Azure DevOps e il progetto Azure Boards da connettere a GitHub.com.
È 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.
Concedere l'accesso all'organizzazione Azure Boards
Se necessario, per concedere a GitHub l'accesso all'organizzazione azure DevOps, seguire questa procedura.
Dal portale Web GitHub aprire Impostazioni dal menu del profilo.
Selezionare Applicazioni in Integrazioni.
Selezionare App GitHub autorizzate>Azure Boards.
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:
In GitHub, aprire l'organizzazione e andare su Impostazioni dei criteri > dell'app OAuth.
Approvare l'app Azure Boards specificamente (scelta consigliata) o rimuovere restrizioni per tutte le 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 di Azure Boards-GitHub è completa. È possibile ignorare i passaggi successivi o eseguirli per comprendere le funzionalità supportate con la connessione.
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 ).
Aprire l'elemento di lavoro, passare alla sezione Sviluppo e selezionare Aggiungi collegamento.
In Tipo di collegamento selezionare Richiesta pull GitHub.
Selezionare il repository e inserire l'ID della richiesta di pull e un commento facoltativo.
Selezionare Aggiungi collegamento.
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.
Seleziona il primo collegamento alla pull request dall'elemento di lavoro.
La richiesta pull di GitHub viene aperta in una nuova scheda del browser.
Selezionare Merge pull request.
Passare al file README del repository e visualizzare la notifica aggiunta.
Per altre informazioni, vedere Aggiungere notifiche di stato per il repository 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 Aggiungere o rimuovere repository o 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.
Dal progetto in Azure DevOps passare a Impostazioni>progetto Connessioni GitHub.
Per aggiungere o rimuovere repository, selezionare i puntini di sospensione Altre opzioni per la connessione e scegliere Aggiungi repository o Rimuovi repository dal menu.
Per rimuovere tutti i repository e la connessione, scegliere l'opzione Rimuovi connessione . Scegliere quindi Rimuovi per confermare.
Modificare l'accesso al repository
Dal portale Web GitHub aprire Impostazioni dal menu del profilo.
Selezionare Integrations Applications (Applicazioni integrazioni>). In App GitHub installateselezionare Configura.
Verrà visualizzata la pagina di configurazione di Azure Boards.
Scorrere verso il basso fino alla sezione Accesso al repository.
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.
Seleziona Salva.
Sospendere o disinstallare l'integrazione di Azure Boards
A partire dal passaggio 2 della procedura precedente, scorrere verso il basso fino alla sezione Zona di pericolo.
Per sospendere l'integrazione, scegliere Sospendi. Nella finestra di conferma scegliere OK per confermare la sospensione.
Per annullare la sospensione dell'integrazione, scegliere Annulla sospensione.
Per disinstallare l'app Azure Boards, scegliere Disinstalla e quindi scegliere 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 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 o rimuovere repository GitHub.
