MSBuild先执行OctoPack再发布，Azure Function包缺失必要文件

这个问题我之前也踩过坑——OctoPack默认是在Build目标完成后就打包，但Azure Functions的SDK（Microsoft.NET.Sdk.Functions）是在更靠后的目标（比如GenerateFunctionsMetadata或者Publish）才生成那些函数专属的文件夹和元数据文件（比如function.json、函数入口点描述等），所以OctoPack提前打包自然会漏掉这些内容。下面给你几个经过验证的解决方案：

方案1：改用MSBuild的Publish目标触发打包 #

直接让MSBuild执行Publish目标，同时带上OctoPack的参数，这样OctoPack会在Azure Functions SDK完成所有文件整理后再打包输出目录的内容。

修改TeamCity里的MSBuild命令为：

msbuild YourFunctionProject.csproj /t:Publish /p:Configuration=Release /p:OctoPackPackageVersion=%build.number% /p:OctoPackPublishPackageToHttp=https://your-octopus-server/api/packages/raw /p:OctoPackApiKey=%octopus.api.key% /p:OctoPackEnforceAddingFiles=true

• /t:Publish：触发发布流程，Azure Functions SDK会把所有必要的部署文件（包括函数元数据）整理到输出目录
• OctoPackEnforceAddingFiles=true：强制OctoPack包含输出目录里的所有文件，避免它过滤掉非项目直接编译生成的文件（比如函数SDK生成的function.json）

方案2：自定义MSBuild目标控制打包时机 #

如果不想用Publish目标，也可以在你的Function项目文件（.csproj）里添加自定义目标，让OctoPack在Azure Functions元数据生成完成后再执行。

打开项目文件，添加以下XML片段：

<Target Name="RunOctoPackAfterFunctions" AfterTargets="GenerateFunctionsMetadata">
  <CallTarget Targets="OctoPack" />
</Target>

然后在TeamCity的MSBuild命令里指定这个自定义目标：

msbuild YourFunctionProject.csproj /t:RunOctoPackAfterFunctions /p:Configuration=Release /p:OctoPackPackageVersion=%build.number% /p:OctoPackPublishPackageToHttp=https://your-octopus-server/api/packages/raw /p:OctoPackApiKey=%octopus.api.key%

GenerateFunctionsMetadata是Azure Functions SDK生成函数元数据的目标，在它之后执行OctoPack就能确保所有必要文件都已生成。

方案3：改用Octopus CLI的octo pack命令打包 #

如果上面两种方法都不适用，你可以拆分流程：先让MSBuild完成发布，再用Octopus CLI单独打包发布后的输出目录。

步骤如下：

1. 在TeamCity里添加第一个MSBuild步骤，执行Publish目标生成完整输出：

msbuild YourFunctionProject.csproj /t:Publish /p:Configuration=Release /p:PublishDir=%teamcity.build.workingDir%\FunctionPublishOutput

2. 添加第二个命令行步骤，用octo pack打包输出目录：

octo pack --id YourFunctionPackageId --version %build.number% --basePath %teamcity.build.workingDir%\FunctionPublishOutput --outFolder %teamcity.build.workingDir%\OctopusPackages

3. 后续步骤再把生成的.nupkg推送到Octopus服务器。

这种方式更灵活，能完全控制打包的内容，确保不会遗漏任何文件。

额外验证步骤 #

不管用哪种方案，打包完成后建议手动解压生成的.nupkg文件，检查是否包含以下内容：

• bin目录下的函数运行时文件
• 每个函数对应的文件夹（比如YourFunctionName），里面包含function.json和相关的编译文件
• 根目录下的host.json、local.settings.json（如果需要部署的话）

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