將 Azure DevOps Server 連線至 GitHub （內部部署）

Azure DevOps Server 2022 |Azure DevOps Server 2020 |Azure DevOps Server 2019

必要條件

• 與 GitHub 整合：
  • 安裝 Azure DevOps Server 2020.1.1 Patch 2，以連線到 GitHub.com 存放庫。 如果沒有此修補程式，您就只能連線到 GitHub Enterprise Server 存放庫。
  • 在 GitHub 組織或帳戶上安裝適用於 GitHub 的 Azure Boards 應用程式。
• 項目連線：連線到 Azure Boards 或 Azure DevOps 專案。 如果您還沒有專案， 請建立一個專案。
• 權限：
  • 成為專案集合管理員群組和項目參與者群組的成員。 如果您已建立專案，則您具有許可權。
  • 身為您所連線之 GitHub Enterprise Server 的系統管理員。

驗證選項

支援下列驗證選項。

將 Azure DevOps Server 連線至 GitHub Enterprise Server

1. 開啟 Azure DevOps Server 的入口網站。

2. 選取 Azure DevOps 標誌以開啟 Projects，然後選擇您想要設定以連線到 GitHub Enterprise 存放庫的 Azure Boards 專案。

使用個人存取令牌連線

1. 若要建立 PAT，請參閱 建立個人存取令牌。

   提示

   當您建立 GitHub PAT 時，請確定您包含下列範圍： repo, admin:repo_hook, read:user, user:email。

2. 輸入 GitHub Enterprise 伺服器的 URL，以及 該伺服器所辨識的個人存取令牌認證 。 然後選取 [ 連線]。

使用使用者名稱和密碼進行連線

1. 輸入 GitHub Enterprise 伺服器的 URL，以及該伺服器所辨識的系統管理員帳戶認證。 然後選擇 [ 連線]。

2. 對話框會列出您擁有 GitHub 系統管理許可權的所有存放庫。 您可以在 Mine 和 All 之間切換，以判斷是否有其他項目出現，然後檢查您要新增的。 完成時，請選擇 [ 儲存 ]。

   

3. 若要第一次從 Azure Boards 連線到 GitHub 帳戶或組織，您也會安裝適用於 GitHub 的 Azure Boards 應用程式。 遵循確認連線中所述的程式來完成整合。

解決連線問題

Azure Boards-GitHub 整合依賴各種驗證通訊協議來支持連線。 變更使用者的許可權範圍或驗證認證，可能會導致撤銷連線至 Azure Boards 的 GitHub 存放庫。

如需適用於 GitHub 之 Azure Boards 應用程式支援的整合概觀，請參閱 Azure Boards-GitHub 整合。

支援的驗證選項

根據您想要連線的 GitHub 平臺，支援下列驗證選項。

解決存取問題

請考慮下列解決方案：

• 如果連線使用 OAuth：

  • Azure Boards 應用程式已拒絕其中一個存放庫的存取權。

  • GitHub 可能無法使用/無法連線。 這可能是因為服務中斷或內部部署的基礎結構/網路問題。 您可以從下列連結檢查服務狀態：

    • GitHub
    • Azure DevOps

    刪除並重新建立 GitHub 存放庫的連線。 此重新建立的聯機會導致 GitHub 提示您重新授權 Azure Boards。

• 如果連線使用 PAT：

  • PAT 可能會撤銷或必要的許可權範圍已變更且不足。

  • 使用者可能會遺失 GitHub 存放庫上的系統管理許可權。

    重新建立 PAT，並確定令牌的範圍包含必要的許可權： repo, read:user, user:email, admin:repo_hook。

更新選取工作項目類型的 XML 定義

如果您的組織使用託管 XML 或內部部署 XML 程式模型自定義工作追蹤，而且想要將 GitHub 連結類型整合到工作專案表單的開發區段中，您必須更新對應工作項目類型的 XML 定義。

例如，若要將使用者劇本和 Bug 連結至 GitHub 認可，並在工作項目表單的 [開發 ] 區段中提取要求，您必須更新這些工作專案類型的 XML 定義。

若要修改 XML 定義，請執行裝載 XML 進程模型中概述的步驟。 針對每個工作項目類型：

1. 找出 Group Label="Development" 區段。
2. 若要支援外部連結類型， GitHub 認可 和 GitHub 提取要求，請新增下列幾行程式代碼：

此整合可讓您直接從 Azure Boards 中的工作項目順暢地追蹤 GitHub 活動。

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

更新時，區段應該會顯示如下。

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

下一步

相關文章

• 瞭解 Azure Boards 嗎？
• 針對 GitHub 和 Azure Boards 整合進行疑難解答
• 建置 GitHub Enterprise Server 存放庫