從工作專案驅動 Git 開發

Azure DevOps Services |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018-TFS 2017

您的小組可以用來推動開發和保持同步的其中一種方式,就是將工作專案連結至在開發期間建立的物件,例如分支、認可、提取要求和組建。 您可以從一或多個工作專案建立分支來開始該連結。 稍後,您可以建立提取要求、快速開啟認可,以及維護執行的開發作業記錄以完成特定工作。

請參閱這篇文章,以瞭解:

  • 如何從工作專案建立新的分支或提取要求
  • 完成提取要求
  • 執行 squash 合併
  • 建立數個工作專案的分支
  • 將工作專案連結至現有的開發和組建物件

重要

本文說明如何建立新的分支,以及將認可和提取要求的連結新增至裝載于 Azure DevOps 的 Git 存放庫。 若要連結至 GitHub 認可和提取要求,請參閱將 github 認可和提取要求連結至工作專案

[ 開發 ] 區段會記錄所有支援工作專案完成的 Git 開發程式。 本節會顯示您需要的小組資訊,以進行下一個開發步驟,並將導覽步驟降至最低,以完成一般的開發工作。 它也支援可追蹤性,可讓您查看與工作專案相關的所有分支、認可、提取要求和組建。

Work item form, Development section

注意

TFS 2015 和較早的版本不支援工作專案表單中的 開發 區段。 請考慮 升級至較新的 Azure DevOps Server 版本

您可以從它快速存取連結至工作專案的分支、提取要求和認可。 此外,您可以針對您已建立或連結至工作專案的分支起始提取要求。

必要條件

  • 您必須連接到專案。 如果您還沒有專案,請 建立一個專案。
  • 您必須將專案加入至專案,做為 參與者project Administrators 安全性群組的成員。 若要加入,請 將使用者加入至專案或小組
  • 若要查看或修改工作專案,您必須 在此節點中使用 view 工作專案 ,並將 此節點許可權中的 [工作專案 ] 設定為 [ 允許]。 依預設, Contributors 群組具有此許可權集合。 若要深入瞭解,請參閱 設定工作追蹤的許可權和存取權
  • 您必須連接到專案。 如果您還沒有專案,請 建立一個專案。
  • 您必須將專案加入至專案,做為 參與者project Administrators 安全性群組的成員。 若要加入,請 將使用者加入至專案或小組
  • 若要查看或修改工作專案,您必須 在此節點中使用 view 工作專案 ,並將 此節點許可權中的 [工作專案 ] 設定為 [ 允許]。 依預設, Contributors 群組具有此許可權集合。 若要深入瞭解,請參閱 設定工作追蹤的許可權和存取權

工作流程處理

如果沒有連結的程式碼成品,請考慮建立新的分支。 如果有分支但沒有提取要求,請考慮建立提取要求。 以下是使用 Git 存放庫時的一般工作流程順序。

  1. 藉由建立分支來開始工作專案的工作。 您可以從 [開發] 區段中加入新的 Git 分支 .。。

    User story work item form, Development section, create new branch

    ...或者,從表單的 [ 動作] 功能表。

    User story work item form, Action menu, add new branch

    為分支命名,然後選取其基礎的儲存機制。

    Create a branch dialog box

    您建立的分支會自動連結至工作專案。

    注意

    當您將檔案新增至主要分支,但我們建議您加上標籤 main 或其他特殊標籤之後,才可以建立分支。 系統會自動將讀我檔案新增至使用每個新專案建立的初始存放庫。

  2. 系統會開啟至您剛才建立的儲存機制和分支。

    您可以在入口網站中編輯檔案。

    或者,如果您有大量的檔案編輯或需要新增檔案,則您需要從 Visual Studio 或其他支援的 IDE 來工作。 您會想要從剛建立的分支新增本機分支。 如需詳細資訊,請參閱 使用提取和提取來更新程式碼、使用提取下載變更。 (當任何程式碼編輯和認可程式都可以使用時,我們最適合搭配 Visual Studio 的版本使用。 )

  3. 新增或修改您所建立之分支中的檔案。

    從 Visual Studio 或其他支援的 IDE,將變更從本機分支認可並推送至存放庫。

    認可並推送變更

    如果這是您第一次從新的分支推送變更,您必須先發佈分支,然後再推送您的變更。 如需詳細資訊,請參閱 使用 Push 共用程式碼

  4. 從工作專案表單建立 提取要求

    您可以建立提取要求,將您所做的變更合併到主要分支,並讓您的變更由小組的其他成員審核。

    Work item form, create pull request
  5. 您的視圖將切換至 [程式 代碼]、[提取要求] 頁面。 完成建立提取要求,如下所示。

    程式碼視圖,提取要求頁面。

    注意

    建立提取要求之後,您就無法在完成先前的提取要求之前,為相同的分支建立新的提取要求。

    提取要求頁面,建立提取要求。

    在 [合併] 然後完成合併時,核取 [ Squash 變更 ] 的核取方塊。

    [完成提取要求] 對話方塊中,檢查 squash-合併

  6. 完成時,您應該會看到類似的畫面,如下所示。

    提取要求,已完成通知

  7. 開啟工作專案表單或重新整理表單,展開 [ 開發 ] 區段 (選擇 [ 最大化開發] ) ,您將會看到已新增的連結,可支援您剛完成的作業。

    已新增工作專案表單、開發區段、連結

建立數個工作專案的分支

您也可以從待處理專案(backlog)或看不出工作專案的工作專案中,加入新的分支。 您 可以使用複選,來選取數個工作專案,並建立新的分支,並將其連結至分支。

例如,我們在這裡選取要連結至新分支的前五個專案。

Select multiple items from backlog

而且,我們會指定分支的名稱。

Create new branch dialog

[開發] 區段底下所列的所有專案也會出現在 [ 連結] 索引標籤底下 。從 [開發] 區段起始的所有開發動作也會記錄在 [歷程 記錄] 索引標籤底下

連結索引標籤,開發連結

若要將工作專案連結至現有的物件,請選擇 新增連結 [新增連結] 圖示,然後選擇 [連結類型]。

選取 [新增連結] 圖示,然後選擇 [連結類型]。

連結、追蹤和管理相依性。

如果您想要移除連結,您可以在 [ 開發 ] 區段中先將它反白顯示,然後選擇 [ 移除連結]

開發區段,刪除連結

或者,您可以從 [ 連結] 索引標籤中選取該連結,然後選擇 [ 動作] 連結 ,然後選擇 [ 移除連結] 選項。

深入瞭解如何使用工作專案追蹤工作,以及如何使用 Git 從這些資源進行開發:

請記住,[ 開發 ] 區段只會出現在入口網站的工作專案表單中。 顯示在 Visual Studio 或其他支援的用戶端中的工作專案追蹤體驗和表單不會顯示可從入口網站取得的數項功能。

組建中的相關聯工作專案

在 Git 認可中,已連結至認可的任何工作專案都會列在 [組建摘要] 頁面中的相關聯工作專案之下。

Linked work items listed under Associated work items in the build summary page.

此區段中顯示的連結會顯示為這些動作的結果:

  • 從工作專案建立分支、認可或提取要求
  • 在認可、提取要求或其他支援的 Git 或 TFVC 操作期間指定工作專案識別碼
  • 明確地將工作專案從 [ 開發 ] 區段或 [ 連結] 索引標籤連結 至原始程式碼分支、組建或其他支援的 Git 或 TFVC 作業。

將滑鼠游標移到 [開發] 區段底下所列的任何專案,就會啟用相關聯物件的超連結。

您可以在 [開發] 區段內新增的連結類型為 [分支]、[組建]、[變更集]、[認可]、[組建]、[整合于組建]、[提取要求] 和 [

Artifact-to-artifact link types

您可以在 [開發] 區段內新增的連結類型為 [分支]、[組建]、[變更集]、[認可]、[提取要求] 和 [已

Artifact-to-artifact link types

若要深入瞭解連結控制項或自訂開發連結控制項,請參閱 LinksControlOptions 元素、開發連結控制項