將組建排入佇列

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

一般工作

支援內容

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

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

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

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

您可以重試一個已完成的組建定義,使新的組建排入佇列並使用您針對已完成組建所指定的選取。

重試已完成的組建

公用組建

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

必要的使用權限

若要執行此程序,必須將 [佇列組建] 權限設定為 [允許]。 如需詳細資訊,請參閱Team Foundation Server 使用權限

若要從 Visual Studio 將公用組建排入佇列

  1. 在 [Team 總管] 中:

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

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

    3. 點選組建 頁面, 底下的 偏好組件定義全部組件定義, 打開組件定義的清單捷徑, 然後選 將新組建排入佇列.

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

  2. 組建定義 清單中,組建定義已被選取並顯示其大綱。 如果您想要佇列不同的組建定義,您可以從清單中選取。

  3. 在 [您要建置什麼?] 清單中,讓 [最新來源] 處於選取狀態。

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

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

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

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

    重要

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

    請參閱 設定置放資料夾

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

    如果組建定義是以 [預設範本] 或 [升級範本] 為基礎,請參閱根據預設範本定義建置流程使用舊版建置流程以取得這些參數的詳細資訊。

  8. 選擇佇列

私用組建

如果要建置已放入擱置集的變更,必須將私用組建排入佇列。 您可以在簽入程式碼之前使用私用組建 (也稱為「協同組建」) 驗證程式碼的變更。 藉由執行您的變更私用組建,然後再簽入之前,您可以減少的機會就會中斷您的小組定期執行的所有組建,例如夜間組建。

ms181722.collapse_all(zh-tw,VS.110).gif私用組建與公用組建有何不同

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

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

  • 下列建置流程參數是假設為 [False],因此不論組建定義中指定的設定為何,都不會有作用:

    • 標籤來源

    • 在失敗時建立工作項目

    • 關聯變更集與工作項目

  • 在 [Build 總管] 中,完成的組建會出現在下列圖示旁邊:ms181722.Icon_BldPrivateBuild(zh-tw,VS.110).gif

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

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

ms181722.collapse_all(zh-tw,VS.110).gif將私用組建排入佇列

必要的使用權限

若要執行此程序,必須將 [佇列組建] 權限設定為 [允許]。 如需詳細資訊,請參閱Team Foundation Server 使用權限

若要從 Visual Studio 將私用組建排入佇列

  1. 在 [Team 總管] 中:

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

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

    3. 點選組建 頁面, 底下的 偏好組件定義全部組件定義, 打開組件定義的清單捷徑, 然後選 將新組建排入佇列.

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

  2. 組建定義 清單中,組建定義已被選取並顯示其大綱。 如果您想要佇列不同的組建定義,您可以從清單中選取。

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

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

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

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

    • 如果您想要將工作區中一些未定的變更放到擱置集,然後建置這些變更,請按一下 [建立]。

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

    重要

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

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

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

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

  8. (選擇性) 執行下列步驟,指定輸出 (如二進位檔),組建會下載資料夾:

    注意事項注意事項

    請略過 [此組建的置放資料夾] 方塊,因為它對私用組建沒有作用。

    1. 按一下 [參數] 索引標籤,然後展開 [進階] 群組。

    2. 在 [私用置放位置] 方塊中,輸入要在建置完成時儲存輸出的資料夾的 UNC 路徑。

      注意事項注意事項
      • 如果沒有指定這個資料夾,建置不會失敗但在建置記錄檔中會出現警告。

      • 如果您修改這個值,就必須指定已預備做為置放資料夾的資料夾。如需詳細資訊,請參閱設定置放資料夾

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

    如果組建定義是以 [預設範本] 或 [升級範本] 為基礎,請參閱根據預設範本定義建置流程使用舊版建置流程以取得這些參數的詳細資訊。

  10. 選擇佇列

重試已完成的組建

當您測試建置流程部分可能的變更或測試選項時,您可以用您先前指定的相同選項快速佇列公用或私用組建當您佇列現在已完成的組建。

再次從建置頁面嘗試已完成的組建

  • 在 [Team 總管] 中:

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

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

    3. 在 [組件]的頁面,我的組件之下,組件右鍵選取[刪除]