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

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

必要條件

• 安裝 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 平臺，支援下列驗證選項。

平台

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• GitHub.com 用戶帳戶
• 個人存取權杖 (PAT)

• OAuth
• PAT
• 用戶名稱加上密碼

Azure DevOps Server 2020

不適用

• PAT
• 用戶名稱加上密碼

Azure DevOps Server 2019

不適用

• OAuth
• PAT
• 用戶名稱加上密碼

注意

使用適用於 GitHub 的 Azure Boards 應用程式，Azure Boards 和 Azure DevOps Services 會與 GitHub.com 和 GitHub Enterprise Server 存放庫整合。 Azure DevOps Server 2019 和更新版本僅支援與 GitHub Enterprise Server 存放庫整合。 不支援與其他 Git 存放庫整合。

解決存取問題

當與 GitHub 的 Azure Boards 連線不再具有存取權時，它會在具有 red-X 的使用者介面中顯示警示狀態。 將滑鼠停留在警示上，指出認證不再有效。 若要更正問題，請移除連線並重新建立新的連線。

請考慮下列解決方案：

• 如果連線使用 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 認可，並從 [開發] 區段提取要求，您需要更新使用者劇本和 Bug 的 XML 定義。

請遵循裝載 XML 進程模型中提供的工作順序來更新 XML 定義。 針對每個工作專案類型，尋找 區 Group Label="Development" 段，並在下列程式代碼語法中新增下列兩行，以支援外部連結類型： GitHub Commit 和 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>  

下一步

將 GitHub 認可和提取要求連結至工作專案

相關文章

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