TFS 2010构建控制器与TFS 2015集成问题求助

我来帮你一步步排查这个XAML构建代理卡在队列的问题——这种跨版本迁移后兼容的坑我踩过不少，主要从这几个方向入手：

1. 先确认控制器和代理的注册指向是否正确 #

克隆旧控制器后，很容易残留旧TFS的缓存配置：

• 打开构建控制器配置工具（TfsBuildControllerConfig.exe，一般在TFS2010安装目录的Tools文件夹里），仔细核对服务器URL是不是已经改成TFS2015的项目集合地址，别还是指向旧的TFS2010。
• 同样检查代理的配置工具（TfsBuildAgentConfig.exe），确保它注册到的是新TFS2015上的控制器，服务器URL也没搞错。
• 做完配置检查后，重启控制器和代理的服务，或者直接清除本地TFS缓存（路径是C:\Users\<服务账户>\AppData\Local\Microsoft\Team Foundation\5.0\Cache），避免旧缓存捣乱。

2. 检查构建定义的需求和代理标签是否匹配 #

XAML构建是靠标签来匹配代理的，这是最容易忽略的点：

• 打开TFS2015的Web界面，找到你的XAML构建定义，切换到“构建代理”选项卡，看看里面的“需求”列表（比如是不是要求特定的OS版本、软件标签）。
• 再去看构建代理的配置，确认代理的“标签”里包含了构建定义需要的所有内容。要是标签不匹配，哪怕代理在线，系统也不会把任务分配给它。

3. 验证服务账户的权限是否足够 #

控制器和代理的运行账户在新TFS里权限不够的话，也会导致任务挂起：

• 确保这个账户属于TFS2015项目集合的Project Collection Build Service Accounts组，或者直接给它开这些权限：队列构建、读取构建定义、访问代理池/控制器的权限。
• 顺便用这个账户登录浏览器，访问TFS2015的集合URL，看看能不能正常打开，有没有权限报错。

4. 排查身份验证和凭据问题 #

如果TFS2015用的是Kerberos验证，很容易出现凭据传递的问题：

• 先确认代理的服务账户在新机器上有“作为服务登录”的权限，最好是本地管理员权限。
• 试着重新配置代理，在配置工具里重新输入账户凭据，避免旧的缓存凭据导致验证失败。
• 如果是域账户，还要确认账户没过期，新机器也加入了正确的域。

5. 翻日志找线索 #

日志是排查这类问题的关键，别错过：

• 控制器日志默认路径：C:\Program Files\Microsoft Team Foundation Server 2010\Build\Controller\Logs
• 代理日志默认路径：C:\Program Files\Microsoft Team Foundation Server 2010\Build\Agent\Logs
• 重点找“无法连接TFS”“权限不足”“标签不匹配”这类关键词，一般都能直接定位问题。

6. 测试基础连接是否正常 #

在代理机器上跑个命令测试下和TFS2015的连接：

tf status /collection:http://<TFS2015服务器>:8080/tfs/<项目集合>

要是命令能正常返回结果，说明代理机器能正常访问TFS；要是报错，就先解决网络或身份验证的问题。

要是以上步骤都试过还不行，建议你直接在TFS2015上创建一个全新的XAML代理，注册到控制器上测试——有时候克隆旧代理带来的配置损坏很难排查，新代理反而能快速验证是不是克隆的问题。

内容的提问来源于stack exchange，提问作者Mohan Krishna