无网络环境下配置TFS 2018构建代理及构建失败问题咨询

问题1：为什么构建定义的demands要求msbuild和Visual Studio且无法移除？ #

Service Fabric构建模板默认锁定这两项demands，核心原因是Service Fabric应用的构建、打包流程高度依赖这两个工具的专属组件：

• MSBuild：Service Fabric的项目文件（比如.sfproj）是基于MSBuild格式编写的，编译代码、生成应用包的过程需要MSBuild来解析项目中的构建目标（Targets）和执行相关任务（Tasks），没有MSBuild就无法完成最基础的项目编译操作。
• Visual Studio：Visual Studio内置了Service Fabric专属的工具集与SDK，包括适配Service Fabric的构建扩展、应用包打包工具，以及和MSBuild深度集成的Service Fabric特定构建逻辑。同时，Visual Studio安装时会自动配置MSBuild的环境变量和依赖组件，确保构建过程能正确调用到Service Fabric相关工具。

这些demands是模板的强制要求——缺少这两个环境的代理机器根本无法完成Service Fabric构建，提前设置demands可以快速筛选出具备合格环境的代理，避免后续构建因工具缺失失败。

问题2：离线环境下如何安装Visual Studio 2017和MSBuild？ #

微软其实支持Visual Studio 2017离线安装，只是需要先在有公网的机器上下载离线布局文件，再复制到离线构建服务器部署，具体步骤如下：

1. 在有公网的机器生成VS 2017离线布局

   • 先下载对应版本的Visual Studio 2017安装引导程序（比如vs_enterprise.exe/vs_professional.exe）。
   • 打开命令提示符，运行以下命令创建包含Service Fabric组件的离线布局：

     vs_enterprise.exe --layout c:\VS2017_Offline_Layout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Component.ServiceFabricTools --includeRecommended --includeOptional
     

     其中--add参数指定了Azure工作负载和Service Fabric工具组件，确保安装后能支持Service Fabric构建；--includeRecommended和--includeOptional会自动包含必要的依赖组件，避免安装后缺失工具。

2. 复制离线布局到构建服务器

   • 将生成的VS2017_Offline_Layout文件夹完整复制到防火墙内的构建服务器（可通过U盘、内网共享等方式）。

3. 在离线服务器安装Visual Studio 2017

   • 进入复制后的布局文件夹，运行对应版本的安装引导程序，按照向导完成安装即可。

4. 确认MSBuild可用

   • MSBuild会随Visual Studio一起安装，默认路径为C:\Program Files (x86)\Microsoft Visual Studio\2017\<你的版本>\MSBuild\15.0\Bin。
   • 可将该路径添加到系统环境变量PATH中，确保TFS代理能识别到MSBuild。

另外别忘了检查代理版本是否满足Agent.Version -gtVersion 2.115.0，如果版本过低，同样可以在有网机器下载代理安装包，复制到离线服务器完成升级。

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