將 GitHub 提交、拉取請求、分支和問題連結至 Azure Boards 的工作專案

發行項
2025-04-07

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

在本文中，學習如何在將 Azure Boards 專案與 GitHub 存放庫連線之後，將工作項目連結至 GitHub 提交、拉取請求和分支。您可以使用 #mention 語法來進行認可和分支，或直接從 Azure Boards 工作專案新增 GitHub 認可、提取要求或分支連結。

注意

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

必要條件

類別	要求
許可權	Azure Boards 專案和 GitHub 存放庫的參與者。
專案連結	Azure Boards 專案會連線至 GitHub 存放庫，其中有您要連結或鏈接的提交、合併請求和分支。如需詳細資訊，請參閱 Azure Boards-GitHub 整合。

注意

使用託管 XML 程式模型的專案需要更新工作項目類型，才能檢視開發區段和 GitHub 連結類型。如需詳細資訊，請參閱更新選取工作項目類型的 XML 定義。

使用 `AB#` 從 GitHub 連結至 Azure Boards 工作項目。

從 GitHub 提交、合併請求或問題中，使用下列語法來建構通往 Azure Boards 工作項目的連結。將AB#ID輸入到認可訊息的文字中。或者，針對提取要求或問題，請在標題或描述中輸入 AB#ID 。在註解中使用 AB#ID 並不會在工作專案上建立連結。

AB#{ID}

例如，AB#125 鏈接到工作項目 ID 125。

您也可以輸入 commit 或 pull request 訊息來過渡工作項目。系統會辨識 fix、 fixes和 fixed，並將其套用至後續的 #-mention 專案。提及的工作項目會轉換為與已解決工作流程類別目錄狀態相關聯的第一個狀態。 如果沒有狀態與 Resolved 相關聯，工作項目就會 轉換為與已完成 工作流程類別狀態相關聯的狀態。如需詳細資訊，請參閱如何在 Azure Boards 待辦專案和面板中使用工作流程類別目錄狀態。

檢閱下列範例表格：

提交或拉取請求訊息	動作
`Fixed AB#123`	連結並將工作項目轉換為已解決的工作流程狀態類別，如果未定義任何，則為已完成的工作流程狀態類別。
`Adds a new feature, fixes AB#123.`	連結並將工作項目轉換至已解決的工作流程狀態類別，若未定義此類別，則轉換至已完成的工作流程狀態類別。
`Fixes AB#123, AB#124, and AB#126`	Azure Boards 工作專案 123、124 和 126 的連結。僅將第一個項目 123 轉換為已解決的工作流程狀態類別，如果未定義任何類別，則轉換為已完成的工作流程狀態類別。
`Fixes AB#123, Fixes AB#124, Fixes AB#125`	Azure Boards 工作專案 123、124 和 126 的連結。將所有項目轉換為已解析的工作流程狀態類別，或者，如果未定義此類類別，則轉換為已完成的工作流程狀態類別。
`Fixing multiple bugs: issue #123 and user story AB#234`	GitHub 問題 123 和 Azure Boards 工作專案 234 的連結。不會進行轉換。

注意

如果您將相同的 GitHub 存放庫連線至兩個或多個 Azure DevOps 組織中定義的專案，您可能會看到非預期的 AB# 提及連結。如需詳細資訊，請參閱解決連線問題。基於這個理由，我們建議您只將 GitHub 存放庫連線到單一 Azure DevOps 組織中定義的專案。

當您使用 AB# 將連結新增至工作專案時，這些連結會出現在 提取要求的 [開發 ] 區段中。

GitHub 拉取請求開發區段中 AB# 鏈接的螢幕快照。

從工作專案建立 GitHub 分支

若要直接從工作專案建立 GitHub 分支，請執行下列步驟：

從您的面板，尋找您想要從中建立 GitHub 分支的工作專案。
選取 [工作項目動作] >[新增 GitHub 分支]。
在 [ 建立 GitHub 分支 ] 對話框中，輸入分支名稱，然後選取 GitHub 存放庫和基底分支。
選取建立。

Azure Boards 會在指定的 GitHub 存放庫中建立分支，並將其連結至工作專案。如需詳細資訊，請參閱 Azure Boards-GitHub 整合。

將工作項目連結新增至 GitHub 分支、提交或 Pull Request

開啟工作項目，然後移至 [ 連結] 索引標籤 。
從 [新增連結] 對話框中，選取其中一個 GitHub 鏈接類型、選取 GitHub 存放庫、輸入 GitHub 分支的 URL、認可或提取要求，然後選取 [新增連結]。

在下列範例中，我們會新增 GitHub 提取要求的連結。

Azure Boards 會完成檢查，以確保您已輸入有效的連結。連結至 GitHub 存放庫必須連線至 Azure Boards 專案，否則驗證會失敗。