Connetti Azure Boards a GitHubConnect Azure Boards to GitHub

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019

Connettendo il progetto di Azure Boards con i repository GitHub.com, è possibile collegare i commit di GitHub e le richieste pull agli elementi di lavoro.By connecting your Azure Boards project with GitHub.com repositories, you support linking between GitHub commits and pull requests to work items. È possibile usare GitHub per lo sviluppo di software, usando Azure Boards per pianificare e tenere traccia del lavoro.You can use GitHub for software development while using Azure Boards to plan and track your work.

Quando si effettua la connessione da Azure Boards, l'elenco di repository GitHub corrisponde a quelli consentiti Azure Boards per l'accesso.When you make the connection from Azure Boards, the list of GitHub repositories correspond to ones that you allow Azure Boards to access. È possibile limitare i repository Azure Boards possono accedere in generale e limitare le operazioni che un particolare progetto può accedere o dividere la gestione del lavoro in progetti Azure Boards diversi.You can limit which repositories Azure Boards can access overall, and limit what a particular project can access or split the management of work across different Azure Boards projects.

Connettendo il progetto di Azure DevOps Server ai repository di GitHub Enterprise Server, è supportato il collegamento tra commit di GitHub e richieste pull a elementi di lavoro.By connecting your Azure DevOps Server project with your GitHub Enterprise Server repositories, you support linking between GitHub commits and pull requests to work items. È possibile usare GitHub Enterprise per lo sviluppo di software, usando Azure Boards per pianificare e tenere traccia del lavoro.You can use GitHub Enterprise for software development while using Azure Boards to plan and track your work.

Nota

Azure Boards e Azure DevOps Services supportano l'integrazione con i repository GitHub.com e GitHub Enterprise Server.Azure Boards and Azure DevOps Services support integration with GitHub.com and GitHub Enterprise Server repositories.

I server DevOps di Azure locali supportano l'integrazione con i repository GitHub Enterprise Server.On-premises Azure DevOps Servers support integration with GitHub Enterprise Server repositories.

PrerequisitiPrerequisites

  • È necessario connettersi a un progetto Azure Boards o Azure DevOps.You must connect to an Azure Boards or Azure DevOps project. Se non si dispone ancora di un progetto, crearne uno.If you don't have a project yet, create one.
  • È necessario essere un membro del gruppo Project Administrators e del gruppo Contributorsdel progetto.You must be a member of the Project Administrators group and the project's Contributors group. Se è stato creato il progetto, si dispone delle autorizzazioni.If you created the project, then you have permissions.
  • È necessario essere un amministratore o un proprietario del repository GitHub a cui ci si connetterà.You must be an administrator or owner of the GitHub repository you'll be connecting to.

Importante

È possibile connettersi a più repository GitHub purché si sia un amministratore per tali repository.You can connect to multiple GitHub repositories so long as you are an administrator for those repositories.

  • È necessario connettersi a un progetto Azure Boards o Azure DevOps.You must connect to an Azure Boards or Azure DevOps project. Se non si dispone ancora di un progetto, crearne uno.If you don't have a project yet, create one.
  • È necessario essere un membro del gruppo Project Administrators e del gruppo Contributorsdel progetto.You must be a member of the Project Administrators group and the project's Contributors group. Se è stato creato il progetto, si dispone delle autorizzazioni.If you created the project, then you have permissions.
  • È necessario essere un amministratore del server GitHub Enterprise a cui ci si connetterà.You must be an administrator of the GitHub Enterprise Server you'll be connecting to.

Opzioni di autenticazioneAuthentication options

A seconda della piattaforma da cui si lavora per connettersi a GitHub, è possibile scegliere le credenziali usate.Depending on the platform you work from to connect to GitHub, you have a choice of the credentials you use.

PiattaformaPlatform GitHub.comGitHub.com GitHub Enterprise ServerGitHub Enterprise Server
Azure DevOps ServicesAzure DevOps Services
Azure DevOps Server 2020Azure DevOps Server 2020
Azure DevOps Server 2019Azure DevOps Server 2019
  • Non supportatoNot supported

Aggiungere una connessione a GitHubAdd a GitHub connection

  1. Accedere Azure Boards.Sign into Azure Boards.

  2. Scegliere (1) Impostazioni progetto, scegliere (2) connessioni GitHub e quindi (3) connettere il proprio account github.Choose (1) Project Settings, choose (2) GitHub connections and then (3) Connect your GitHub account.

    Impostazioni del progetto>integrazioniProject Settings>Integrations

    Se ci si connette usando PAT, vedere aggiungere una connessione a GitHub usando Pat.If connecting using PAT, see Add a GitHub connection using PAT. Per la connessione a un server GitHub Enterprise, vedere registrare Azure DevOps in GitHub come app OAuth.If connecting to a GitHub Enterprise Server, see Register Azure DevOps in GitHub as an OAuth App.

  3. Se è la prima volta che si esegue la connessione a GitHub da Azure Boards, verrà richiesto di effettuare l'accesso usando le credenziali di GitHub.If this is your first time connecting to GitHub from Azure Boards, you will be asked to sign in using your GitHub credentials. Scegliere un account per il quale si è un amministratore per i repository a cui si vuole connettersi.Choose an account for which you are an administrator for the repositories you want to connect to.

    Finestra di dialogo di accesso a GitHubGitHub sign in dialog
    Se è stata abilitata l'autenticazione a due fattori, immettere il codice di autenticazione inviato da GitHub e scegliere Verifica.If you have enabled two-factor authentication, enter the authentication code that GitHub sent you and choose Verify.

    Finestra di dialogo di autenticazione a due fattori di GitHubGitHub two-factor authentication dialog

    In caso contrario, il sistema rileverà automaticamente l'organizzazione GitHub perché l'account GitHub è stato precedentemente associato all'account di Azure DevOps Services.Otherwise, the system will automatically recognize your GitHub organization as your GitHub account has previously been associated with your Azure DevOps Services account.

  4. La finestra di dialogo Aggiungi repository GitHub Visualizza e seleziona automaticamente tutti i repository di GitHub.com di cui si è amministratori.The Add GitHub Repositories dialog automatically displays and selects all GitHub.com repositories for which you are an administrator. Deselezionare gli eventuali repository che non si desidera partecipare all'integrazione.Unselect any repositories that you don't want to participate in the integration.

    Scegliere i repository GitHub.Choose your GitHub repositories.

    Suggerimento

    Si consiglia di connettere un repository GitHub solo ai progetti definiti in una singola organizzazione DevOps di Azure.We recommend that you only connect a GitHub repo to projects defined in a single Azure DevOps organization. La connessione dello stesso repository GitHub ai progetti definiti in due o più organizzazioni DevOps di Azure può causare il collegamento ad AB # mention imprevisto.Connecting the same GitHub repo to projects defined in two or more Azure DevOps organizations can lead to unexpected AB# mention linking. Per informazioni dettagliate, vedere risolvere i problemi di integrazione di GitHub & Azure Boards.For details, see Troubleshoot GitHub & Azure Boards integration.

  5. Al termine, scegliere Salva.When done, choose Save.

  6. Esaminare la pagina GitHub visualizzata, quindi scegliere approva, installa & autorizza.Review the GitHub page that displays and then choose Approve, Install, & Authorize.

    Confermare i repository GitHubConfirm your GitHub repositories

  7. Fornire la password di GitHub per confermare.Provide your GitHub password to confirm.

  8. Al termine, verrà visualizzata la nuova connessione con i repository selezionati elencati.When done, you should see the new connection with the selected repositories listed.

    Repository GitHub connessiGitHub repositories connected

Aggiungere una connessione a GitHub usando PATAdd a GitHub connection using PAT

Si consiglia di usare OAuth per connettersi al repository GitHub.We recommend that you use OAuth to connect to your GitHub repository. Tuttavia, se è necessario usare un PAT, è possibile seguire queste procedure.However, if you need to use a PAT, you can by following these procedures.

Suggerimento

Quando si crea il GitHub PAT, assicurarsi di includere gli ambiti seguenti: repo, read:user, user:email, admin:repo_hook .When creating your GitHub PAT, make sure that you include these scopes: repo, read:user, user:email, admin:repo_hook.

  1. Per scegliere un PAT quando si connette un repository GitHub, scegliere  più icona nuova connessione e quindi scegliere il collegamento fare clic qui .To choose a PAT when connecting a GitHub repository, choose plus icon New Connection and then choose the Click here link.

    Aggiungere il repository GitHub, scegliere il token di accesso personaleAdd GitHub repository, choose personal access token

    Per creare un PAT di GitHub, passare a GitHub Developer Settings>Personal Access Tokens.To create a GitHub PAT, go to GitHub Developer Settings>Personal access tokens.

  2. Immettere PAT e scegliere Connetti.Enter the PAT and choose Connect.

    Immettere PAT e scegliere Connetti.Enter the PAT and choose Connect.

Registrare Azure DevOps in GitHub come app OAuthRegister Azure DevOps in GitHub as an OAuth App

Se si prevede di usare OAuth per connettersi Azure DevOps Services o Azure DevOps Server con il server GitHub Enterprise, è necessario prima registrare l'applicazione come app OAuth.If you plan to use OAuth to connect Azure DevOps Services or Azure DevOps Server with your GitHub Enterprise Server, you first need to register the application as an OAuth App. Per informazioni dettagliate, vedere creazione di un'app OAuth.For details, see Creating an OAuth App.

Registra Azure DevOps ServicesRegister Azure DevOps Services

  1. Accedere al portale Web di GitHub Enterprise Server.Sign into the web portal for your GitHub Enterprise server.

    Accedere a GitHub Enterprise ServerSign into GitHub Enterprise server

  2. Aprire impostazioni>impostazioni sviluppatore>app OAuth e scegliere nuova app OAuth.Open Settings>Developer settings>Oauth Apps and choose New OAuth App.

    Aprire Impostazioni>impostazioni sviluppatore>app OAuth e scegliere nuova app OAuth.Open Settings>Developer settings>Oauth Apps and choose New OAuth App.

  3. Compilare il modulo per registrare l'applicazione Azure DevOps Server.Fill out the form to register your Azure DevOps Server application.

    Per l' URL della Home page, specificare l' URL dell'organizzazione.For the Homepage URL, specify the Organization URL of your organization.
    Per l' URL di callback di autorizzazione, usare il modello seguente per costruire l'URL.For the Authorization callback URL, use the following pattern to construct the URL.

    {Azure DevOps Services Organization URL}/_admin/oauth2/callback

    Ad esempio:For example:

    https://dev.azure.com/fabrikam/_admin/oauth2/callback

    Registrare il progetto di Azure DevOps ServerRegister your Azure DevOps Server project

  4. Scegliere Registra applicazione.Choose Register application.

  5. Al termine dell'operazione, verrà visualizzata una pagina che fornisce l' ID client e il segreto client per l'applicazione OAuth registrata.Upon success, you'll see a page that provides the Client ID and Client Secret for your registered OAuth application.

    ID client e segreto client per l'applicazione OAuth registrata.Client ID and Client Secret for your registered OAuth application.

Registra Azure DevOps ServerRegister Azure DevOps Server

  1. Accedere al portale Web di GitHub Enterprise Server.Sign into the web portal for your GitHub Enterprise server.

    Accedere a GitHub Enterprise ServerSign into GitHub Enterprise server

  2. Aprire impostazioni>impostazioni sviluppatore>app OAuth e scegliere nuova app OAuth.Open Settings>Developer settings>Oauth Apps and choose New OAuth App.

    Aprire Impostazioni>impostazioni sviluppatore>app OAuth e scegliere nuova app OAuth.Open Settings>Developer settings>Oauth Apps and choose New OAuth App.

  3. Compilare il modulo per registrare l'applicazione Azure DevOps Server.Fill out the form to register your Azure DevOps Server application.

    Per l' URL della Home page, specificare l' URL pubblico della raccolta di progetti.For the Homepage URL, specify the Public URL of your project collection. È possibile trovare questo URL aprendo la console di amministrazione di Azure DevOps e visualizzando il nodo livello applicazione .You can find this URL by opening the Azure DevOps Administration Console and viewing the Application Tier node.

    Console di amministrazione Azure DevOps Server, livello applicazioneAzure DevOps Server Administration Console, Application Tier

    Per l' URL di callback di autorizzazione, usare il modello seguente per costruire l'URL.For the Authorization callback URL, use the following pattern to construct the URL.

    {Azure DevOps Server Public Url}/{Collection Name}/_admin/oauth2/callback

    Ad esempio:For example:

    http://contoso/DefaultCollection/_admin/oauth2/callback

    OppureOr,

    https://tfs.contoso.com/MyCollection/_admin/oauth2/callback

    Registrare il progetto di Azure DevOps ServerRegister your Azure DevOps Server project

  4. Scegliere Registra applicazione.Choose Register application.

  5. Al termine dell'operazione, verrà visualizzata una pagina che fornisce l' ID client e il segreto client per l'applicazione OAuth registrata.Upon success, you'll see a page that provides the Client ID and Client Secret for your registered OAuth application.

    ID client e segreto client per l'applicazione OAuth registrata.Client ID and Client Secret for your registered OAuth application.

Registrare la configurazione OAuth in Azure DevOps ServicesRegister your OAuth configuration in Azure DevOps Services

  1. Accedere al portale Web per Azure DevOps Services.Sign into the web portal for Azure DevOps Services.

  2. Aggiungere la configurazione di GitHub Enterprise OAuth alla propria organizzazione.Add the GitHub Enterprise Oauth configuration to your organization.

  3. Aprire Impostazioni organizzazione>le configurazioni OAuthe scegliere Aggiungi configurazione OAuth.Open Organization settings>Oauth configurations, and choose Add Oauth configuration.

    Impostazioni dell'organizzazione>le configurazioni OAuthOrganization Settings>OAuth configurations

  4. Compilare il modulo visualizzato, quindi scegliere Crea.Fill in the form that appears, and then choose Create.

    Finestra di dialogo di configurazione OAuthOAuth configuration dialog

Registrare la configurazione OAuth in Azure DevOps ServerRegister your OAuth configuration in Azure DevOps Server

  1. Accedere al portale Web per la Azure DevOps Server.Sign into the web portal for your Azure DevOps Server.

  2. Aggiungere la configurazione di GitHub Enterprise OAuth alla raccolta di Azure DevOps Server.Add the GitHub Enterprise Oauth configuration to your Azure DevOps Server collection.

  3. Aprire impostazioni di amministrazione>le configurazioni OAuthe scegliere Aggiungi configurazione OAuth.Open Admin settings>Oauth configurations, and choose Add Oauth configuration.

    Impostazioni di amministrazione>le configurazioni OAuthAdmin Settings>OAuth configurations

  4. Compilare il modulo visualizzato, quindi scegliere Crea.Fill in the form that appears, and then choose Create.

    Finestra di dialogo di configurazione OAuthOAuth configuration dialog

Connetti Azure DevOps Services a GitHub Enterprise ServerConnect Azure DevOps Services to GitHub Enterprise Server

Importante

Per connettersi Azure DevOps Services al server GitHub Enterprise, il server GitHub Enterprise deve essere sufficientemente accessibile da Internet.To connect Azure DevOps Services to your GitHub Enterprise Server, your GitHub Enterprise Server must be sufficiently accessible from the Internet. Assicurarsi che DNS di Azure possa risolvere il nome del server GitHub Enterprise e che il firewall consenta l'accesso dagli indirizzi IP del Data Center di Azure.Make sure Azure DNS can resolve your GitHub Enterprise Server name and your firewall allows access from Azure Data Center IP addresses. Per determinare l'intervallo di indirizzi IP, vedere Microsoft Azure intervalli IP del Data Center.To determine the IP address range, see Microsoft Azure Datacenter IP Ranges. Un messaggio di errore comune rilevato quando esistono problemi di connettività è:A common error message encountered when connectivity issues exist is:

Non è stato possibile risolvere il nome remoto:' github-enterprise-server.contoso.com 'The remote name could not be resolved: 'github-enterprise-server.contoso.com'

Se si verifica questo errore, verificare che il server sia accessibile.If you encounter this error, check that your server is accessible. Per altre informazioni, vedere domande frequenti su DNS di Azure.For more information, see Azure DNS FAQ.

  1. Scegliere il logo Azure DevOps per aprire progetti, quindi scegliere il progetto Azure Boards da configurare per connettersi ai repository di GitHub Enterprise.

  2. Scegliere (1) Impostazioni progetto, scegliere (2) connessioni GitHub e quindi (3) fare clic qui per connettersi all'organizzazione aziendale github.Choose (1) Project Settings, choose (2) GitHub connections and then (3) Click here to connect to your GitHub Enterprise organization.

    Impostazioni progetto>connessioni GitHubProject Settings>GitHub connections

    Scegliere una delle opzioni seguenti — per OAuth, token di accesso personale, nome utente e password — in base alle credenziali scelte.Choose from one of the following options—OAuth, Personal Access Token, Username and Password—based on the credentials you've chosen.

    Seleziona metodo di autenticazioneSelect authentication method

    Per creare un PAT, vedere creazione di un token di accesso personale.To create a PAT, see Creating a personal access token.

    Suggerimento

    Quando si crea il server GitHub Enterprise PAT, assicurarsi di includere gli ambiti seguenti: repo, admin:repo_hook, read:user, user:email .When creating your GitHub Enterprise Server PAT, make sure that you include these scopes: repo, admin:repo_hook, read:user, user:email.

    Connettersi usando OAuthConnect using OAuth

    Scegliere la configurazione configurata nel passaggio 4 di registrare la configurazione OAuth in Azure DevOps Services, quindi scegliere Connetti.Choose the configuration that you set up in Step 4 of Register your OAuth configuration in Azure DevOps Services, and then choose Connect.

    Nuova connessione aziendale GitHub, finestra di dialogo OAuthNew GitHub Enterprise connection, OAuth dialog

    Connettersi usando un token di accesso personaleConnect using a Personal Access Token

    Immettere l'URL per il server GitHub Enterprise e le credenziali del token di accesso personale riconosciute da tale server.Enter the URL for your GitHub Enterprise server and the Personal access token credentials recognized by that server. Quindi scegliere Connetti.And then choose Connect.

    Accedere con il token di accesso personale.Sign in with personal access token.

    Connettersi usando un nome utente e una passwordConnect using a Username and Password

    Immettere l'URL per il server GitHub Enterprise e le credenziali dell'account amministratore riconosciute da tale server.Enter the URL for your GitHub Enterprise server and the administrator account credentials recognized by that server. Quindi scegliere Connetti.And then choose Connect.

    Accedere con nome utente e password.Sign in with username and password.

  3. Nella finestra di dialogo sono elencati tutti i repository per i quali si dispone dei diritti di amministrazione di GitHub.The dialog lists all repositories for which you have GitHub administration rights. È possibile passare da una pagina all' altra e viceversa per determinare se sono presenti altri elementi, quindi selezionare quelli che si desidera aggiungere.You can toggle between Mine and All to determine if others appear, and then check the ones that you want to add. Al termine, scegliere Salva .Choose Save when done.

    Scegliere i repository da aggiungere.Choose repositories to add.

Connetti Azure DevOps Server a GitHub Enterprise ServerConnect Azure DevOps Server to GitHub Enterprise Server

  1. Scegliere il logo Azure DevOps per aprire progetti, quindi scegliere il progetto Azure Boards da configurare per connettersi ai repository di GitHub Enterprise.

  2. Scegliere (1) Impostazioni progetto, scegliere (2) connessioni GitHub e quindi (3) connettere l'account github Enterprise.Choose (1) Project Settings, choose (2) GitHub connections and then (3) Connect your GitHub Enterprise account.

    Impostazioni del progetto>integrazioniProject Settings>Integrations

    In alternativa, scegliere un token di accesso personale o un nome utente e una password, se si sceglie di effettuare la connessione con tali credenziali.Or, choose a personal access token or username and password, if you are choosing to make your connection with those credentials.

    Per creare un PAT, vedere creazione di un token di accesso personale.To create a PAT, see Creating a personal access token.

    Suggerimento

    Quando si crea il GitHub PAT, assicurarsi di includere gli ambiti seguenti: repo, admin:repo_hook, read:user, user:email .When creating your GitHub PAT, make sure that you include these scopes: repo, admin:repo_hook, read:user, user:email.

    Connettersi usando OAuthConnect using OAuth

    Scegliere la configurazione configurata nel passaggio 4 di registrare la configurazione OAuth in Azure DevOps server, quindi scegliere Connetti.Choose the configuration that you set up in Step 4 of Register your OAuth configuration in Azure DevOps Server, and then choose Connect.

    Nuova connessione aziendale GitHub, finestra di dialogo OAuthNew GitHub Enterprise connection, OAuth dialog

    Connettersi usando un token di accesso personaleConnect using a Personal Access Token

    Immettere l'URL per il server GitHub Enterprise e le credenziali del token di accesso personale riconosciute da tale server.Enter the URL for your GitHub Enterprise server and the Personal access token credentials recognized by that server. Quindi scegliere Connetti.And then choose Connect.

    Accedere con il token di accesso personale.Sign in with personal access token.

    #### Connettersi usando un nome utente e una passwordConnect using a Username and Password

    Immettere l'URL per il server GitHub Enterprise e le credenziali dell'account amministratore riconosciute da tale server.Enter the URL for your GitHub Enterprise server and the administrator account credentials recognized by that server. Quindi scegliere Connetti.And then choose Connect.

    Accedere con nome utente e password.Sign in with username and password.

  3. Nella finestra di dialogo sono elencati tutti i repository per i quali si dispone dei diritti di amministrazione di GitHub.The dialog lists all repositories for which you have GitHub administration rights. È possibile passare da una pagina all' altra e viceversa per determinare se sono presenti altri elementi, quindi selezionare quelli che si desidera aggiungere.You can toggle between Mine and All to determine if others appear, and then check the ones that you want to add. Al termine, scegliere Salva .Choose Save when done.

    Scegliere i repository da aggiungere.Choose repositories to add.

Aggiungere o rimuovere repository oppure rimuovere una connessioneAdd or remove repositories, or remove a connection

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

    Aggiungere o rimuovere repository GitHubAdd or remove GitHub repositories

  2. Per rimuovere tutti i repository e la connessione, scegliere l'opzione Rimuovi connessione .To remove all repositories and the connection, choose the Remove connection option. Quindi, scegliere Rimuovi per confermare.Then, choose Remove to confirm.

    Finestra di dialogo Conferma rimozione connessione GitHubConfirm remove GitHub connection dialog

Risolvere i problemi di connessioneResolve connection issues

Vedere risolvere i problemi di connessione al repository GitHub.See Troubleshoot GitHub repository connection.

Successiva attività da provareTry this next