一、什麼是封閉簽入?
封閉簽入是Team Foundation Server 2010新增的功能，開啟這個功能後，所有的要簽入的程式碼先上傳到擱置集(Shelveset)，然後在Bulid Sever中下載原始碼並Build成功後，才會真的簽入變更集(Changeset)，這樣可以確保每一個簽入的都是可以Build的，在多人開發時不會照成一個人簽入不完成的程式碼，使其他所有人都無法在Build，照成其他的開發的困擾，如果在搭配單元測試做自動化測試，可以大幅增加程式碼的正確性。
而在TFS 2008、2005雖然也有看似很像簽入原則，但那完全是一個假的簽入原則，只要本機有Build成功過就可以簽入(我試過應該是一個Visual Studio的Process中記憶體中有記錄就可以)，如我寫一段Code，Build成功，後來做了些修改，有Bug，Build會失敗，但因為我前面有Build成功過的記錄，所以我還是可以簽入。
圖1-1 騙人的簽入原則
要執行封閉簽入需要安裝以下軟體:
- 可以簽入原始碼的工具:如Visual Studio 2010、TFS 2010 Prower Tool、Team EXPRO等等工具
- Team Foundation Server 2010
- Build Controller 分配工作，至少安裝一個
- Build Agent 執行工作，至少安裝一個
因為Build可能是非常耗資源與耗時的，所以Build的相關程式被折開成獨立軟體，可以在多台電腦上安裝分擔執行負載，相關資料可以參考MSDN文件， Team Foundation Build Reference
圖1-2 Build System的視示圖，來源:Understanding a Team Foundation Build System
2、封閉簽入設定
1.開啟Visual Studio 2010。
2.打開Team Explorer，並連線到TFS。
3.在Team Project下的Builds上按右鍵，選擇New Build Defintion。
圖2-1 新增Build定義
4.輸入定義名稱
圖2-2 Build名稱設定
5.設定觸發方式，選擇Gated Check-in選項。
圖2-3 觸發方式設定
Tip:
第2-4個選項是簽入相關設定，而第5個選項是Daily Build的設定，有興趣可以玩玩。
6.設定從Source Control的那一個路徑下載原始檔。
圖2-4 工作區設定
7.設定Controller與檔案存放地
圖2-5 Controller設定
8.設定Build流程與Build設定與自動化測試的設定
圖2-6 簽入流程設定。
圖2-7 DefaultTemplate.xaml流程圖，超複雜的。
Tip:
Build是可以設定那些專案要執行的，可以新增一個方案檔(.sln)，只加入需要Build的專案，或只載入部分專案檔(.*proj)，加快Build速度，也可以封閉簽入時只Build較少的專案，定期Build時在執行全部的專案。
圖2-8 方案檔或專案檔設定
9.記錄保存設定
圖2-9 記錄保存設定
10.好，存檔，太棒了，現在所有人簽入都要先Build了。
3、簽入
封閉簽入與一般簽入操作上沒有大不同，只是多了一些步驟，如
- 先簽入Shelveset
- Build失敗，會保留Shelveset
- Build成功，會刪除Shelveset，並通知你去CheckOut最新的版本
下圖是簡略的流程
圖3-1 簡略封閉簽入流程
1.跟一般簽入一樣，可以從暫止的變更簽入，或方案總管上按右鍵簽入等方式簽入。
圖3-2 封閉簽入與一般簽入方式一樣
2.簽入時會詢問是否要執行封閉簽入
圖3-2 詢問視窗
3.確定後會開啟 視窗可以知道執行的結果。
圖3-4 Build Explorer
Tip:
Build Explorer可以從 Temp Explorer>Team Project>Builds>Build Definition>右鍵(或雙擊)>View Builds開啟，可以看每一個執行的Log。
圖3-5 開始Build Explorer
當發生Build失敗，看Log可以快速找到問題。
圖3-6 Build Log
Build Log是一個文字檔，放在
{設定的資料夾}\N{Agent的ID}\Source\{SolutionName}.Log 最近一次Builds的Log
{設定的資料夾}\{BuildName}\{BuildName}_yyyyMMdd.No\logs\{SolutionName}.Log 保留的Log
4.成功後會詢問你是要更新，這個動作請按 Reconcile，因為你的工作還不知道你已經簽入了，要把簽入的檔案改成unchanged，如果沒執行Reconcile會怎樣?不會怎麼樣，只是因為你的工作區版本比較舊，可能需要先簽出才能簽入。
圖3-7 封閉簽入完成
5.失敗後會詢問你是要簽出Shelevset，這個通常都是不用理他，因為本地端的Code通常就等於Shelveset(沒有亂改的話)，何必多此一舉簽出呢。
圖3-8 封閉簽入失敗
4、問題
Q1.簽入時會不會很久，會不會停住等到簽入完成後才能繼續作業?
不會，簽入時只要將變動的程式碼上傳後，後續的Build與測試都是在別的電腦上執行，不會影嚮你的工作，你還是可以繼續在Visual Studio上寫Code，不過因為簽入後會需要執行Reconcile，你按下簽入後修改的檔案可能會發生衝突，需要去解決衝突，有點小麻煩。
Q2 .一個簽入還沒跑完，又在簽入會怎麼樣?
Controller會檢查現在有沒有空閒的Agent，如果有就馬上執行，沒有就會加入堆壘中，等到空閒時執行。
圖4-2 同時簽入的情況
Note:
其實我很好奇如果我有二個Agent，同時簽入，但新版本的先執行完成並簽入，舊版的才執行完成並簽入，會不會蓋掉新版本，可惜試了好幾遍都沒有新的前執行完成的情況，不過現實中應該是不會出現這種情況才對。
Q3.如果執行封閉簽入而Build失敗會怎麼樣?
不會，簽入失敗的Code都會保留在Shelveset，也是存放在Server上，也可以在別台電腦上簽出Shelveset。
圖4-3 簽入失敗的Shelveset
