建立或編輯組建定義

當您已部署您的建置系統之後,您已經準備好可以定義建置流程,為您的小組編譯程式碼、執行測試,以及執行其他許多重要功能。

  1. 在 Visual Studio 的 [Team Explorer] 中,確定您已連接至 Team 專案 (鍵盤:Ctrl + 0、C),然後開啟 組建圖示 組建 (鍵盤:Ctrl + 0、B)。

  2. 選擇 [新增組建定義] 連結或選取組建,開啟捷徑功能表,然後選擇 [編輯組建定義]。

    提示

    如果出現 TF225001 錯誤訊息,請設定組建控制器

  3. 在 [一般] 索引標籤上:

    • 在 [組建定義名稱] 方塊中,指定要與組建定義產生關聯的名稱。 請參閱 Team Foundation 中的命名限制

    • (選擇性) 在 [描述] 方塊中,加入適當的描述。 當小組成員即將以手動方式將組建排入佇列 (如 將組建排入佇列所述) 時,此描述能提供其他資訊。

  4. 如果您的建置流程還沒準備好給您的小組使用,在 [一般] 索引標籤的 [佇列處理] 中,您可以將 [已啟用] 的預設設定變更為:

    • 已暫停:允許觸發程序或使用者將新組建排入佇列,但是讓這些組建保持暫停狀態。

    • 已停用:防止觸發程序或使用者將新組建排入佇列。

  5. 在 [觸發程序] 索引標籤上,指定要讓此組建定義執行的事件。 請參閱 指定組建觸發程序和原因

  6. 在 [來源設定] 索引標籤上:

    • TFVC 圖示 TFVC:在 [工作資料夾] 資料表中,指定包含您的建置流程所需檔案的版本控制資料夾。

      提示

      若要確定建置流程正確運作並改善效能,請只包括所有包含建置流程所需檔案的資料夾。請參閱 使用組建工作區

    • Git 圖示 **Git:**指定包含建置流程所需檔案的儲存機制和分支。

      提示

      在針對連續整合 (CI) 和正在復原組建進行監視的分支清單中,您可以使用萬用字元。例如,您可以指定 refs/heads/feature* 來監視 refs/heads/featureA 和 refs/heads/featureB 分支。

  7. 在 [組建預設值] 索引標籤上,如果 [組建控制器] 清單中出現多個組建控制器,請選擇您要建置系統用來處理此組建定義的組建控制器

    如果您的 Team 專案集合裝載在 Visual Studio Online 上,而單一標準組建代理程式可以滿足小組的需要時,請選取 [裝載組建控制器]。 請參閱裝載組建控制器

  8. 在 [組建預設值] 索引標籤上,選擇下列其中一個 [預備環境位置] 選項,以指定建置流程如何產生和儲存輸出檔 (例如編譯過的二進位檔和記錄檔):

    • 這個組建不會將輸出檔案複製到置放資料夾:如果不需要輸出檔,請選擇這個選項。

    • 將組建輸出複製到下列置放資料夾:如果要將輸出檔案複製到檔案共用伺服器上的置放資料夾,請選擇這個選項。 在方塊中,輸入您要建置系統放置輸出檔案的所在資料夾的 UNC 檔案路徑。 您必須指定已預備做為置放資料夾的資料夾。 請參閱 設定置放資料夾

    • 將組建輸出複製到伺服器:選取這個選項將組建輸出複製到您的 Team Foundation Server。

  9. 在 [流程] 索引標籤上,指定此組建會執行哪些功能以及其執行方式的詳細資料:

    • 若要定義簡單的組建,請選擇 [顯示詳細資料],然後在 [建置流程檔 清單中選擇 [預設範本]。 請參閱 將預設範本用於您的建置流程

    • 如果小組已經定義您要使用的自訂範本,選擇 [顯示詳細資料],然後選取 [建置流程檔] 清單中的範本。 請參閱 自訂您的建置流程範本

  10. 在 [保留原則] 索引標籤上,您可以指定要保留的已完成組建數目。 在 [指定組建的保留方式] 清單中會顯示兩組保留原則,您可以修改它們以符合小組需要:

    • [已觸發和手動] 原則群組會在已手動或由自動觸發程序將組建排入佇列時,限制系統所要避免的狀況。

    • [私用] 原則群組會在已手動將組建從擱置集中的原始程式碼排入佇列時,限制系統所要避免的狀況 (如 將組建排入佇列 所述)。

    若要為 [已停止]、[失敗]、[已部分成功] 或 [已成功] 完成的組建修改保留原則,請執行下列一個或兩個步驟:

    • 選擇 [保留原則] 欄中的值,然後選擇下列其中一個選項:[全部保留]、[只保留最後一個]、[保留最後 2 個]、[保留最後 5 個]、[保留最後 7 個]、[保留最後 10 個] 或 [指定要保留的數目]。

    • 選擇 [要刪除的項目] 欄中的值,然後選擇一個值。 如需這些值的詳細資訊,請參閱 刪除已完成的組建

  11. 在完成處理組建定義之後,請選擇 [檔案] 功能表上的 [儲存] <組建定義的名稱> (鍵盤:Ctrl+S)。

    您建立的組建定義會出現在 [Team Explorer] 的 [組建] 頁面中。 請參閱 執行、監視和管理組建