將組建排入佇列

透過建立一個或多個組建定義來定義建置流程之後,您就能開始獲得建置系統的好處。 大部分的建置流程都是使用自動觸發程序建立的。 如需詳細資訊,請參閱指定組建觸發程序和原因

無論組建定義是否有手動或自動觸發程序,您都可以視需要將組建排入佇列。

一般工作

支援內容

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

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

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

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

公用組建

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

必要的使用權限

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

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

  1. 在 Team 總管中,按一下適當的 Team 專案。

  2. 按一下 [建置] 功能表上的 [佇列新組建]。

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

  3. 在 [組建定義] 清單中選取組建定義。

    如果您選取的組建定義內含說明,該說明會出現在 [組建定義] 清單底下。

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

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

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

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

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

    重要事項重要事項

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

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

    如果組建定義是以 [預設範本] 或 [升級範本] 為基礎,請參閱Define Workflow Builds Using the Default Template使用升級範本來使用舊版 MSBuild 組建以取得這些參數的詳細資訊。

  9. 按一下 [佇列]。

    [Build 總管] 隨即出現,並顯示 [已佇列] 索引標籤。 如需詳細資訊,請參閱管理和檢視已完成的組建

私用組建

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

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

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

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

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

    • 標籤來源

    • 在失敗時建立工作項目

    • 關聯變更集與工作項目

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

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

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

將私用組建排入佇列

必要的使用權限

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

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

  1. 在 Team 總管中,按一下適當的 Team 專案。

  2. 按一下 [建置] 功能表上的 [佇列新組建]。

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

  3. 在 [組建定義] 清單中選取組建定義。

    如果您選取的組建定義內含說明,該說明會出現在 [組建定義] 清單底下。

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

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

  5. 請執行下列其中一個步驟:

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

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

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

    重要事項重要事項

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

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

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

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

  9. (選擇性) 執行下列步驟,以指定將下載組建輸出 (如二進位檔) 的位置:

    注意事項注意事項

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

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

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

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

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

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

    如果組建定義是以 [預設範本] 或 [升級範本] 為基礎,請參閱Define Workflow Builds Using the Default Template使用升級範本來使用舊版 MSBuild 組建以取得這些參數的詳細資訊。

  11. 按一下 [佇列]。

    [Build 總管] 隨即出現,並顯示 [已佇列] 索引標籤。 如需詳細資訊,請參閱管理和檢視已完成的組建

請參閱

工作

建立基本組建定義

概念

使用預設範本定義組建

使用擱置集

定義閘道簽入組建來驗證變更