在Azure DevOps Server （TFS） 中修改团队项目名称

概述

【团队项目】：

在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--

（完）