將組建排入佇列

透過建立一個或多個組建定義來定義建置流程之後,您就能開始獲得建置系統的好處。 大部分的建置流程都是使用自動觸發程序建立的。 無論組建定義是否有手動或自動觸發程序,您都可以視需要將組建排入佇列。

重要

如果您是使用 Visual Studio 2013 和 Visual Studio Team Foundation Server 2013,在將組建排入佇列時可能無法修改建置流程參數。取得 KB 2898341 Hotfix

一般工作

支援內容

將公用組建排入佇列:如果要建置版本控制伺服器中最新版本的原始程式碼。

若要在命令列提示字元將公用組建排入佇列,請使用 TFSBuild start 命令。

將私用組建排入佇列:如果要建置已放入擱置集的變更。 您可以在簽入程式碼之前使用私用組建 (也稱為「協同組建」) 驗證程式碼的變更。

若要在命令列提示字元將私用組建排入佇列,請使用 TFSBuild start 命令搭配 /shelveset 選項。

如果您想要使用已完成組建的相同選項來佇列公用或私用組建,請重試完成的組建

重試已完成的組建

公用組建

無論在組建定義中是否有指定自動觸發程序,您都可以手動將組建排入佇列。

  1. 在 [Team 總管] 中:

    1. 如果您尚未連接至要處理的 Team 專案,請連接到 Team 專案

    2. 選擇 首頁圖示 [首頁],然後選擇 組建圖示 [組建] (鍵盤:Ctrl + 0、B)。

    3. 在 [組建] 頁面的 [我的最愛組建定義] 或 [所有組建定義] 下,開啟組建定義的內容功能表,然後選擇 [佇列新組建]。

    [佇列組建 TeamProjectName] 對話方塊隨即出現。

  2. 在 [組建定義] 清單中,組建定義已選取,且其描述會顯示在下方。 如果您要將不同的組建定義排入佇列,可以從清單中選取。

  3. 在 [您要建置什麼?] 清單中,確認已選取 [最新來源]。

  4. (選擇性) 在 [組建控制器] 清單中,選取預設組建控制器以外的組建控制器。

  5. (選擇性) 在 [佇列優先權] 清單中,選取下列其中一個值:[]、[高於一般]、[一般]、[低於一般] 或 []。

    [位置] 方塊會顯示組建在佇列中的預估位置。

  6. (選擇性) [此組建的置放資料夾] 方塊會顯示當建置完成時儲存輸出 (如二進位檔和記錄檔) 的位置。 如果要將輸出儲存到不同的位置,請在此方塊中輸入該位置的路徑。

    重要

    如果您修改這個值,就必須指定已預備做為置放資料夾的資料夾。如果您指定了 [將組建輸出複製到伺服器] 做為組建定義的預備環境位置,您無法修改這個值。

    請參閱 設定置放資料夾

  7. (選擇性) 在 [參數] 索引標籤上,只針對此回合檢視及覆寫其他組建定義設定。

    如果組建定義是以 [預設範本] 或 [升級範本] 為基礎,請參閱將預設範本用於您的建置流程解決升級時可能發生的問題以取得這些參數的詳細資訊。

  8. 選擇 [佇列]。

私用組建

如果要建置已放入擱置集的變更,必須將私用組建排入佇列。 您可以在簽入程式碼之前使用私用組建 (也稱為「協同組建」) 驗證程式碼的變更。 在簽入私用組建的變更之前執行私用組建,您可以降低小組定期執行的任何組建 (例如夜間組建) 因變更而中斷的可能性。

私用組建與公用組建有何不同

完成的私用組建的結果與完成的公用組建在下列方式上不同:

  • 私用組建與閘道簽入組建類似,因為都是建置含有擱置集變更的程式碼。 不過,與閘道簽入組建不同的是,在私用組建之後並不會自動簽入變更。

  • 組建不會為您的來源加上標籤,在失敗時建立工作項目,也不會關聯變更集和工作項目。

  • 在 [Build 總管] 中,完成的組建會出現在下列圖示旁邊:Icon_BldPrivateBuild

  • 完成的組建的命名格式為 Build N,其中 N 是唯一整數值。 這個格式與公用組建的格式不同,後者是使用 [組建編號格式] 參數指定的。

  • 針對每個組建定義,您會指定個別的 (選擇性不同的) 保留原則,限制儲存在系統中之完成的私用組建數目。

將私用組建排入佇列

  1. 在 [Team 總管] 中:

    1. 如果您尚未連接至要處理的 Team 專案,請連接到 Team 專案

    2. 選擇 首頁圖示 [首頁],然後選擇 組建圖示 [組建] (鍵盤:Ctrl + 0、B)。

    3. 在 [組建] 頁面的 [我的最愛組建定義] 或 [所有組建定義] 下,開啟組建定義的內容功能表,然後選擇 [佇列新組建]。

    [佇列組建 TeamProjectName] 對話方塊隨即出現。

  2. 在 [組建定義] 清單中,組建定義已選取,且其描述會顯示在下方。 如果您要將不同的組建定義排入佇列,可以從清單中選取。

  3. 在 [您要建置什麼?] 清單中,選取 [含有擱置集的最新來源]。

    [擱置集名稱] 方塊隨即出現。

  4. 依照下列其中一個步驟進行:

    • 如果您已經有擱置集,請在 [擱置集名稱] 方塊中輸入其名稱,或選擇省略符號 () 按鈕搜尋該擱置集。

    • 如果您想要將工作區中一些暫止的變更放到擱置集,然後建置這些變更,請選擇 [建立]。

  5. (選擇性) 如果建置成功而且您想要簽入擱置集的變更,請選取 [在建置成功之後簽入變更] 核取方塊。

    重要

    如果選取這個核取方塊,組建會執行成閘道簽入組建,而不是私用組建。如需閘道簽入組建的詳細資訊,請參閱使用閘道簽入建置流程來驗證變更

  6. (選擇性) 在 [組建控制器] 清單中,選取預設組建控制器以外的組建控制器。

  7. (選擇性) 在 [佇列優先權] 清單中,選取下列其中一個值:[]、[高於一般]、[一般]、[低於一般] 或 []。

    [位置] 方塊會顯示組建在佇列中的預估位置。

  8. (選擇性) 在 [參數] 索引標籤上,只針對此回合檢視及覆寫其他組建定義設定。

    如果組建定義是以 [預設範本] 或 [升級範本] 為基礎,請參閱將預設範本用於您的建置流程解決升級時可能發生的問題以取得這些參數的詳細資訊。

  9. 選擇 [佇列]。

重試已完成的組建

在測試建置流程一些可能的變更或在測試選項時,藉由使用之前排入佇列但現在已完成的組建所使用的相同選項,您可以快速地將公用或私用組建排入佇列。

  • 在 [Team 總管] 中:

    1. 如果您尚未連接至要處理的 Team 專案,請連接到 Team 專案

    2. 選擇首頁圖示 [首頁],然後選擇 組建圖示 [組建]。

    3. 在 [組建] 頁面的 [我的組建] 下,開啟已完成組建的內容功能表,然後選擇 [重試組建]。