概述
【團隊項目】:
在Azure DevOps Server (原名TFS)中,團隊項目(Team Project)是一個最基本的數據組織容器,包含了一個團隊或者信息系統中的所有信息,包括源代碼、文檔、需求、缺陷和持續集成等數據。同時,團隊項目也是TFS中相關數據的權限隔離邊界;在系統的默認配置中,不同人員登錄TFS系統,會查看到不同團隊項目的數據。在TFS系統的設計中,團隊項目名稱和用戶訪問TFS系統的方式有直接關系,例如,團隊項目中代碼庫的遠程地址中,就包含了團隊項目的名稱部分。
【修改名稱】:
在使用TFS系統前,最好對所有團隊項目的名稱有一個整體的規划,避免由於改名導致許多未知的問題。但是,如果出現團隊項目改名的需求時,我們需要首先了解改名對開發團隊造成的影響,提前做好相應的規划。
團隊項目改名會導致用戶相關數據的變化,包括:
- 源代碼版本庫路徑
- 工作項的URL路徑
- 共享查詢、個人查詢路徑
- 其他與團隊項目名稱相關的書
團隊項目的名稱可以多次修改,也可以重新改回原來的名稱。但是在改名之前和之后,必須要通知你的開發團隊,讓大家做好相應的變更。一般情況下,盡量在非工作時間實施改名的工作,避免對開發團隊的工作造成影響。
注意:從TFS 2015之后,系統才支持修改團隊項目名稱的功能,之前的版本並不支持這一功能。
修改團隊項目之前
1. 你必須是項目管理員的權限,即,你的操作賬戶在項目管理員組的成員中
2. 由於修改團隊項目會影響開發人員訪問Azure DevOps Server,為避免修改團隊項目造成數據丟失,在修改團隊項目之前,需要通知開發團隊將本地的代碼變更提交到服務器。提交的數據主要包括:
- Git代碼庫中的修改
- TFVC代碼庫中的修改
- Excel 中的工作項
- Project 中的工作項
- PowerPoint 中的設計內容
修改團隊項目名稱
在團隊項目的任何頁面,點擊“項目設置”按鈕
‘
在項目設置頁面,點擊重命名
在彈出頁面中,填寫新的團隊項目名稱,並勾選“我了解重命名此項目的后果”,點擊“重命名”按鈕。
修改團隊項目之后:對開發團隊的影響
完成團隊項目改名后,我們必須通知開發團隊,對本地開發工具和訪問方式做相應的修改,以便適應新的團隊項目名稱。這些變動主要是正對使用不同開發工具的團隊成員,如果你的團隊成員(例如需求人員)一直使用瀏覽器訪問TFS系統,則變動不大。下面是開發團隊需要做的相應調整:
1. 重新啟動客戶端:
開發工具在緩存中存儲團隊項目名稱,如果重新啟動開發工具,系統會自動清除緩存中的信息。重新打開開發工具並連接到Azure DevOps Server 后,系統會自動創建新緩存信息。如果在修改團隊項目名稱后,用戶沒有重新啟動客戶端程序,會導致推送到服務器的數據失敗。當然,這里的客戶端不包含瀏覽器,主要是指Visual Studio,Eclipse,Git client,Excel等工具,以及使用TFS客戶端對象模型自定義的客戶端工具。
2. 更新Git遠程庫:
如果你使用的團隊項目中的Git 遠程庫,那么你需要更新所有連接到服務器本地庫的配置。這是因為遠程庫的地址中包含了團隊項目的名稱,例如http://tfsserver/DefaultCollection/MyAgileTeam/_git/MyAgileTeam,其中的MyAgileTeam就是團隊項目名稱。
- 獲取遠程庫的名稱
在瀏覽器中,選擇對應的Git庫,選擇克隆按鈕,在彈出的窗口中,點擊復制Git庫遠程地址的按鈕
- 在Visual Studio 中,請參考下面的方式修改遠程庫地址
在Visual Studio 的團隊資源管理器中打開之前克隆的git庫:
選擇設置按鈕
選擇存儲庫設置
選擇遠程庫>編輯按鈕
在彈出的窗口中,將上一步中復制的遠程地址粘貼到這里,並確認完成操作。你就可以按照之前的操作更新本地代碼庫,並推送和拉取遠程庫的內容了。
- 在Git 客戶端的命令行中更新遠程庫地址
如果你使用命令行方式和遠程倉庫同步數據,則可以參考下面的方式修改遠程庫地址:
打開命令行窗口,查看當前的遠程庫設置:
git remote –a
執行遠程庫修改命令
git remote set-url origin {URL_you_copied_from_the_remote_repo}
3. 更新TFVC 工作區
如果你使用服務器工作區的方式連接TFVC代碼庫,你只需要打開使用Visual Studio 或者Eclipse,打開源代碼管理器之后,更新或者簽入文件后,系統會在工具中自動更新你的團隊項目名稱。
常見問題
在Eclipse或者Visual Studio中連接TFVC異常,建議新建一個工作區,重新同步數據到新的映射目錄中,如下圖:
微軟最有價值專家,DevOps MVP 張洪君 http://www.cnblogs.com/danzhang
--End--
(完)