基于BizTalk 2020+BTDF+Azure Pipelines的应用依赖问题咨询

1. 开发环境Visual Studio中核心应用引用方式 #

• 放弃本地.dll直接引用，改用内部NuGet源管理核心应用依赖：
  • 将核心应用的BizTalk组件（schemas、pipelines、辅助类库等）打包为NuGet包，包含绑定文件、组件元数据等必要部署资源，遵循语义化版本号规则（如1.0.0、1.0.1）。
  • 在Azure Artifacts或内部NuGet服务器发布该包，确保开发环境和CI/CD管道可访问。
  • 子应用的Visual Studio项目中，添加对应NuGet源，通过NuGet包管理器安装指定版本的核心应用包，替代原本地.dll引用。
  • 注意：NuGet包需包含BizTalk项目所需的所有依赖资源，避免仅打包.dll导致部署时缺失schema或管道定义。

2. BTDF与Azure Pipelines配置确保子应用依赖正确 #

• BTDF项目配置：
  • 在子应用的Deployment.btdfproj中，通过变量（如$(CoreAppVersion)）指定核心应用版本，引用核心组件时关联该变量，示例：

    <ItemGroup>
      <PackageReference Include="CoreBizTalkApp" Version="$(CoreAppVersion)" />
    </ItemGroup>
    

  • 添加<BizTalkAppReference>节点，明确依赖的核心BizTalk应用名称和版本，BTDF部署时会自动检查该应用是否存在且版本匹配：

    <BizTalkAppReference Include="CoreBizTalkApp" Version="$(CoreAppVersion)" />
    

• Azure Pipelines配置：
  • 在管道变量组中定义CoreAppVersion变量，统一管理核心应用版本号，确保所有子应用部署时使用相同版本。
  • 管道步骤中，先执行nuget restore拉取指定版本的核心应用包，再调用BTDF的Deploy目标并传递版本变量：

    msbuild .\SubAppDeployment.btdfproj /t:Deploy /p:CoreAppVersion=$(CoreAppVersion) /p:Environment=$(Environment)
    

  • 启用管道依赖检查，确保核心应用部署完成后，再触发子应用的部署流水线。

3. 核心应用更新时的子应用处理方案 #

• 必须先卸载所有依赖的子应用，因为BizTalk会锁定被引用的核心组件，直接更新核心应用会失败。
• 通过BTDF+管道实现自动化处理：
  • 在核心应用的部署管道中，添加前置步骤：编写PowerShell脚本调用BizTalk WMI类或BTSTask.exe查询所有依赖当前核心应用的子应用，示例：

    $dependentApps = Get-WmiObject -Namespace root/MicrosoftBizTalkServer -Class MSBTS_Application | Where-Object { $_.ReferencedApplications -contains "CoreBizTalkApp" }
    

  • 遍历查询结果，调用BTDF的UnDeploy目标卸载每个子应用：

    foreach ($app in $dependentApps) {
      msbuild .\$(AppName)Deployment.btdfproj /t:UnDeploy /p:Environment=$(Environment)
    }
    

  • 卸载完成后执行核心应用的更新部署，最后重新触发所有子应用的部署流水线。
  • 也可在核心应用的Deployment.btdfproj中定义<PreDeployTargets>，将卸载子应用的脚本作为预部署步骤执行，实现BTDF层面的自动化。

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