Condividi tramite

Connettere Azure DevOps Server a GitHub (locale)

Azure DevOps Server | Azure DevOps Server 2022

Quando si connette il progetto Azure DevOps Server ai repository GitHub, è supportato il collegamento tra commit GitHub e 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.

Note

Azure DevOps Server supporta l'integrazione con repository di GitHub.com e GitHub Enterprise Server. Per connettersi dai servizi di Azure DevOps, vedere Connettere Azure Boards a GitHub.

Prerequisites

Category Requirements
Permissions - Membro del gruppo Project Collection Administrators e del gruppo Collaboratori del progetto. Se hai creato il progetto, allora hai le autorizzazioni.
- Administrator del GitHub Enterprise Server a cui sei connesso.
Appartenenza al progetto membro del progetto.
Integrazione con GitHub - Azure DevOps Server 2020.1.1 Patch 2. Senza questa patch, è possibile connettersi solo ai repository di GitHub Enterprise Server.
- Azure Boards app per GitHub installata su un account o sulle organizzazioni di GitHub.

Opzioni di autenticazione

Sono supportate le opzioni di autenticazione seguenti:

Note

OAuth non è supportato per Azure DevOps Server 2020.

Connettere Azure DevOps Server a GitHub Enterprise Server

È possibile connettere fino a 250 repository GitHub a un progetto di Azure Boards.

  1. Aprire il portale Web per il Azure DevOps Server.

  2. Selezionare il logo Azure DevOps per aprire Projects e quindi scegliere il progetto Azure Boards da configurare per connettersi ai repository GitHub Enterprise.

  3. Selezionare Impostazioni progetto>GitHub connessioni.

    Screenshot di Impostazioni progetto, connessioni GitHub.

  4. Se è la prima volta che si effettua una connessione dal progetto, scegliere il metodo di autenticazione da usare per stabilire la connessione:

    Screenshot della prima connessione con GitHub credentials.

    In caso contrario, selezionare Nuova connessione e selezionare il metodo di autenticazione nella finestra di dialogo Nuova connessione.

Connettere Azure DevOps Server con un token di accesso personale GitHub

  1. Per creare un GitHub PAT, vedere Creare un GitHub PAT.

    Tip

    Quando si crea il PAT GitHub, assicurarsi di includere questi ambiti: repo, admin:repo_hook, read:user, user:email.

  2. Immettere l'URL per il server GitHub Enterprise e le credenziali del token di accesso personale riconosciute da tale server. Quindi selezionare Connetti.

    Screenshot dell'accesso con il token personale GitHub (PAT).

Connettere Azure DevOps Server con credenziali di GitHub

  1. Immettere l'URL per il server GitHub Enterprise e le credenziali dell'account amministratore riconosciute da tale server. Quindi scegliere Connetti.

    Screenshot di accesso effettuato con credenziali GitHub.

  2. Nella finestra di dialogo sono elencati tutti i repository per i quali si dispone di diritti di amministrazione GitHub. È possibile passare da Mine a All per determinare se vengono visualizzati altri utenti e quindi controllare quelli che si desidera aggiungere. Al termine, scegliere Salva .

    Screenshot dei repository da selezionare per aggiungerli.

  3. Per connettersi a un account o a un'organizzazione GitHub da Azure Boards per la prima volta, è necessario installare anche l'app Azure Boards per GitHub. Completare l'integrazione seguendo le procedure descritte in Confermare la connessione.

Risolvere i problemi di connessione

L'integrazione GitHub Azure Boards si basa su vari protocolli di autenticazione per supportare la connessione. Le modifiche apportate all'ambito di autorizzazione o alle credenziali di autenticazione di un utente possono causare la revoca dei repository GitHub connessi a Azure Boards.

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

Quando la connessione Azure Boards a GitHub non ha più accesso, viene visualizzato uno stato di avviso nell'interfaccia utente con un rosso-X. Passare il puntatore del mouse sull'avviso e indica che le credenziali non sono più valide. Per risolvere il problema, rimuovere la connessione e ricreare una nuova connessione.

Screenshot della connessione non riuscita.

Prendere in considerazione le risoluzioni seguenti:

  • Se la connessione usa OAuth:

    • L'applicazione Azure Boards ha negato l'accesso per uno dei repository.

    • GitHub potrebbe non essere disponibile/non raggiungibile. Questa indisponibilità potrebbe essere dovuta a un'interruzione del servizio o a un problema di infrastruttura/rete in locale. È possibile controllare lo stato del servizio dai collegamenti seguenti:

      Eliminare e ricreare la connessione al repository GitHub. Questa connessione ricreata causa la richiesta di GitHub di riautorizzare Azure Boards.

  • Se la connessione usa un GitHub PAT:

    • Il GitHub PAT è stato revocato o gli ambiti di autorizzazione necessari sono stati modificati e non sono sufficienti.

    • L'utente potrebbe perdere le autorizzazioni amministrative nel repository GitHub.

      Ricreare il GitHub PAT e assicurarsi che l'ambito del token includa le autorizzazioni necessarie: repo, read:user, user:email, admin:repo_hook.

Aggiornare le definizioni XML per i tipi di elemento di lavoro selezionati

Se l'organizzazione personalizza il rilevamento del lavoro usando il modello di processo XML ospitato o locale e vuole integrare GitHub tipi di collegamento nella sezione Sviluppo dei moduli degli elementi di lavoro, è necessario aggiornare le definizioni XML per i tipi di elemento di lavoro corrispondenti.

Ad esempio, per collegare storie utente e bug a GitHub commit e richieste pull all'interno della sezione Development dei moduli degli elementi di lavoro, è necessario aggiornare le definizioni XML per questi tipi di elemento di lavoro.

Per modificare le definizioni XML, eseguire i passaggi descritti in Hosted XML Process Model (Modello di processo XML ospitato). Per ogni tipo di elemento di lavoro:

  1. Individuare la sezione Group Label="Development".
  2. Per supportare i tipi di collegamento esterno, GitHub Commit e GitHub richiesta pull, aggiungere le righe di codice seguenti:

Questa integrazione consente di tenere traccia senza problemi delle attività di GitHub direttamente dagli elementi di lavoro in Azure Boards.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />

Quando viene aggiornato, la sezione dovrebbe essere visualizzata nel modo seguente.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>

Passaggi successivi

Collega commit GitHub e pull request agli elementi di lavoro

Contenuti correlati

  • Last updated on