安裝適用於 GitHub 的 Azure Boards 應用程式

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

在本快速入門中，您會安裝適用於 GitHub 的 Azure Boards 應用程式，以將 Azure Boards 連線到您的 GitHub 存放庫。當您將 Azure Boards 專案與 GitHub.com 存放庫連線時，可以連結 GitHub 提交和拉取要求至工作項目。您可以使用 GitHub 進行軟體開發，同時使用 Azure Boards 來規劃和追蹤您的工作。在 GitHub 帳戶或組織上安裝適用於 GitHub 的 Azure Boards 應用程式之後，請選擇您要從項目連線到的 GitHub 存放庫。

如需針對 GitHub 的 Azure Boards 應用程式支援的整合概覽，請參閱 Azure Boards-GitHub 整合。

Prerequisites

Category	Requirements
Permissions	- 專案集合管理員群組的成員。如果您已建立專案，則您具有許可權。 - 在 GitHub 組織中，系統管理員或擁有者負責安裝 Azure Boards 應用程式。 - 讀取 GitHub 存放庫的權限。
項目成員資格	專案成員。

Important

如果您的存放庫已使用 OAuth 等其他驗證類型進行連線，您必須先從現有的連線中移除該存放庫，才能使用 GitHub 應用程式重新連線。在您設定 GitHub 應用程式之前，請遵循本文稍後新增或移除 GitHub 存放庫中提供的步驟。

如果您是這些存放庫的系統管理員，您可以將 Azure DevOps 組織連線到多個 GitHub 存放庫。您不應該將 GitHub 存放庫連線到多個 Azure DevOps 組織。

安裝和設定 Azure Boards 應用程式

您的安裝順序可能會因為您的帳戶設定而有所不同。如有必要，請遵循下列步驟之間的畫面提示。

移至 GitHub Marketplace 中的 Azure Boards 應用程式。
在 [方案和定價] 底下的 [ 免費] 底下，選取 [ 安裝]。
在 [安裝及授權 Azure Boards] 中，選擇您要連線到 Azure Boards 的存放庫，然後選取 [ 安裝與授權]。

此範例使用 [所有存放庫]：
選擇您想要連線到 GitHub.com 的 Azure DevOps 組織和 Azure Boards 專案。

您一次只能連接一個專案。如果您有想要連線的其他專案，您可以稍後執行此動作，如本文稍後的設定其他專案或存放庫所述。

為 Azure Boards 組織提供存取權

如有必要，若要授與 GitHub 對 Azure DevOps 組織的存取權，請執行下列步驟。

從 GitHub 網站，從個人資料菜單開啟設定。
在整合底下選取應用程式。
選取 授權的 GitHub Apps>Azure Boards。
在 [組織存取權] 底下，解決可能出現的任何問題。選取授與以將存取權授予任何顯示有 存取要求待處理 的組織。

檢查第三方應用程式存取原則

請確定您的 GitHub 組織允許 Azure Boards 應用程式的第三方應用程式存取。如果第三方存取受到限制，則從 Azure DevOps 新增存放庫可能會顯示空白清單或產生錯誤。

若要啟用存取權：

在 GitHub 中，開啟您的組織，然後移至 [設定] > OAuth 應用程式原則。
特別核准 Azure Boards 應用程式（建議），或移除所有第三方應用程式的限制。

備註

您必須是組織擁有者或管理員才能變更此設定。

使用連線

此時，您的 Azure Boards-GitHub 整合已完成。您可以略過後續步驟，或瀏覽它們以了解連線支援的功能。

在您的面板上，選取 [新增工作專案] 以輸入名為「將徽章新增至自述檔」的新工作專案 —問題（基本）、使用者故事（Agile）或產品待辦專案（Scrum）—視 Azure Boards 專案所使用的程式模型而定。

標題為 [將徽章新增至自述檔 ] 的工作專案會出現在您的面板上。
開啟您的工作專案，移至 [開發 ] 區段，然後選取 [ 新增連結]。
從 [鏈接類型] 中，選取 [GitHub 提取要求]。
選取存放庫，然後輸入提取要求標識碼和選擇性批注。
選取 [新增連結]。

下列動作會自動發生在背景中：
- 將徽章新增至連線 GitHub 存放庫清單中第一個存放庫的自述檔。
- 為更新建立 GitHub 提交，將徽章新增至自述文件中。
- 建立 GitHub 提取要求，以合併對自述檔所做的變更。
- 將 GitHub 提交和拉取請求連結到在步驟 1 中建立的工作項目。
從工作項目選取第一個提取要求連結。

GitHub 提取要求會在新的瀏覽器索引標籤中開啟。
選擇 [合併拉取請求]。
移至您的存放庫自述檔，並檢視已新增的徽章。

如需詳細資訊，請參閱新增 GitHub 存放庫的狀態徽章。

設定其他專案或存放庫

您可以設定其他 Azure Boards/Azure DevOps Projects、GitHub.com 存放庫，或從 Azure Boards 應用程式頁面變更目前設定。如需詳細資訊，請參閱新增或移除存放庫，或從 Azure Boards 移除連線。

新增或移除存放庫，或從 Azure Boards 移除連線

如果您遇到連線問題，建議您移除連線，然後開始使用新的連線。

從 Azure DevOps 中的專案，移至 [項目設定>][GitHub 連線]。
若要新增或移除存放庫，請選取連線的 [更多選項省略號]，然後從功能表中選擇 [新增存放庫] 或 [移除存放庫]。
若要移除所有存放庫和連線，請選擇 [ 移除連線] 選項。然後選擇 [ 移除 ] 以確認。

變更儲存庫存取權限

從 GitHub 網站，從個人資料菜單開啟設定。
選擇整合>應用程式。在 [已安裝的 GitHub Apps] 下，選取 [ 設定]。

[Azure Boards 設定] 頁面開啟。
向下捲動至 [ 存放庫存取 ] 區段。
選擇您想要的選項， [所有存放庫 ] 或 [僅選取存放庫]。

如果您選擇 [僅選取存放庫]，請選取您想要參與與 Azure Boards 整合的存放庫。
選取 [儲存]。