TeamCity中MSBuild构建产物生成失败及PowerShell部署传参求助

一、先确保构建步骤生成了部署产物 #

很多新手容易踩这个坑：仅仅执行dotnet build不会生成用于部署的完整产物，必须通过dotnet publish命令生成包含所有依赖的部署包。

在TeamCity的构建步骤里添加一个「.NET CLI」或「Command Line」步骤，执行以下命令：

dotnet publish YourApiProject.csproj -c Release -o ./publish

• -c Release：指定用Release编译配置生成产物
• -o ./publish：把部署产物输出到构建工作目录下的publish文件夹（这个路径可以自定义，比如./deploy，只要后续产物配置对应上就行）

如果你的解决方案包含多个项目，只需要发布特定项目时，直接指定该项目的.csproj路径即可；如果要发布多个可部署项目，可以单独为每个项目添加dotnet publish步骤。

二、正确配置TeamCity构建产物路径 #

核心原则：用基于「构建工作目录」的相对路径 #

构建工作目录是TeamAgent拉取代码后所在的根目录，所有产物路径都要相对于这个目录来写。以下是几种实用的正确配置：

1. 将publish文件夹所有内容打包为Zip
   在构建配置的「Artifacts」设置（通常在Build Settings下的Artifacts标签页）中，输入：

+: publish/** => artifacts.zip

• +: publish/**：匹配publish文件夹下的所有文件和子文件夹（**表示递归匹配所有层级）
• => artifacts.zip：把匹配到的内容打包成artifacts.zip，存到TeamCity服务器的构建产物目录中

2. 直接输出publish文件夹为产物目录
   如果不需要打包，只想把整个publish文件夹作为产物保留，输入：

+: publish/** => artifacts

这样会在产物目录下生成一个artifacts文件夹，完整包含publish里的所有内容。

3. 针对多项目解决方案的配置
   如果你的API项目在src/YourApiProject目录下，dotnet publish输出到src/YourApiProject/publish，那么产物路径应该写：

+: src/YourApiProject/publish/** => artifacts.zip

你之前配置失败的常见原因 #

• 路径语法错误：比如+: ProjectName/ . => artifacts.zip里的空格是无效的，应该用ProjectName/**来匹配所有内容
• 未执行dotnet publish：根本没生成部署产物，自然匹配不到文件
• 使用绝对路径d:\artifacts：TeamAgent可能运行在不同机器，绝对路径不可靠，且TeamCity推荐用基于工作目录的相对路径
• 匹配范围错误：比如+: . => artifacts.zip会把整个代码仓库打包，不是你需要的部署产物，还可能因文件过多或权限问题失败

三、将产物路径传递给PowerShell命令 #

TeamCity提供了内置变量和自定义变量两种方式，轻松把产物路径传给PowerShell步骤：

1. 使用TeamCity内置变量 #

TeamCity内置了很多实用变量，直接用就行：

• %system.teamcity.build.artifactDir%：构建产物在TeamCity服务器上的存放目录（比如C:\TeamCity\buildAgent\work\xxx\artifacts）
• %system.teamcity.build.workingDir%：构建工作目录（拉取代码后的根目录）

比如在PowerShell步骤中引用打包后的Zip文件：

$artifactZipPath = "%system.teamcity.build.artifactDir%\artifacts.zip"
# 后续部署逻辑，比如上传到服务器、解压等
Write-Host "当前部署产物路径：$artifactZipPath"

2. 使用自定义构建参数 #

如果想更灵活地控制路径，可以在构建配置的「Parameters」标签下添加自定义参数：

• 名称：publish.output.dir
• 值：./publish

然后在dotnet publish步骤中引用：

dotnet publish -c Release -o %publish.output.dir%

在产物配置中引用：

+: %publish.output.dir%/** => artifacts.zip

在PowerShell步骤中直接调用：

$publishDir = "%publish.output.dir%"
$zipPath = "%system.teamcity.build.artifactDir%\artifacts.zip"

3. 调试技巧：确认实际路径 #

如果不确定路径是否正确，可以在构建步骤中加一个PowerShell步骤，执行以下命令查看文件结构和变量值：

# 查看工作目录下的所有文件和文件夹
Get-ChildItem -Recurse
# 打印TeamCity内置变量
Write-Host "构建工作目录：%system.teamcity.build.workingDir%"
Write-Host "产物目录：%system.teamcity.build.artifactDir%"

通过构建日志就能确认文件是否存在、路径是否匹配。

四、适用于ASP.NET Web应用的配置 #

ASP.NET Web应用（包括.NET Core和.NET 5+）的部署产物配置和.NET Core API完全一致：都是通过dotnet publish生成部署文件，然后按照上述步骤配置产物路径即可。唯一的区别是Web应用的publish文件夹会包含静态文件、web.config等，但配置逻辑没有任何差异。

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