如何为基于mcr.microsoft.com/dotnet/framework/sdk:4.8-windowsservercore-ltsc2019的Docker镜像添加BizTalk项目构建功能

Great question! Building BizTalk projects in a Windows Server Core-based Docker image does require some extra steps since the base .NET Framework SDK 4.8 image doesn't include the necessary BizTalk tooling. Here are a few proven approaches to get this working:

Approach 1: Manual Installation of BizTalk Server SDK & MSBuild Components #

This method gives you full control over exactly what gets installed, which is ideal for minimizing image size.

• Step 1: Prepare BizTalk Server Installation Media
  Grab the offline installation media for a BizTalk Server version compatible with .NET Framework 4.8 (e.g., BizTalk Server 2020). Extract the SDK components from the ISO or setup package—you can do this locally before building the image, or download it directly in the Dockerfile.

• Step 2: Silent Install the BizTalk SDK
  Add a RUN command to your Dockerfile to install the SDK in quiet mode. For BizTalk Server 2020, the command would look like this:

  # Copy local BizTalk setup files into the image (or download via Invoke-WebRequest)
  COPY BizTalk2020Setup/ C:\BizTalkSetup\
  
  # Install BizTalk SDK silently
  RUN Start-Process -FilePath "C:\BizTalkSetup\BizTalkServer2020.exe" -ArgumentList "/quiet /install SDK" -Wait
  

• Step 3: Copy MSBuild Targets to Visual Studio Build Tools Path
  The BizTalk SDK installs MSBuild targets, but they need to be in the path that the VS2022 Build Tools in the base image uses. Copy them over with:

  RUN xcopy "C:\Program Files (x86)\Microsoft BizTalk Server 2020\Developer Tools\MSBuild" "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Microsoft\BizTalk" /E /I /Y
  

• Step 4: Configure MSBuild Environment
  Ensure MSBuild can locate the BizTalk targets by setting the appropriate environment variable:

  ENV MSBuildExtensionsPath="C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild"
  

Approach 2: Use Visual Studio Build Tools to Add BizTalk Workload #

If you prefer a more integrated approach, you can use the Visual Studio Build Tools installer to add the BizTalk development workload directly.

• Step 1: Download and Run VS Build Tools Installer
  Add these commands to your Dockerfile to install the BizTalk workload silently:

  # Download VS Build Tools installer
  RUN Invoke-WebRequest -Uri https://aka.ms/vs/17/release/vs_buildtools.exe -OutFile vs_buildtools.exe
  
  # Install BizTalk workload (and any required dependencies)
  RUN & .\vs_buildtools.exe --add Microsoft.VisualStudio.Workload.BizTalk --quiet --norestart --nocache
  

• Step 2: Verify Workload Installation
  After installation, confirm the BizTalk MSBuild targets are present in the VS Build Tools directory to ensure compatibility with the base image's VS2022 setup.

Key Notes & Validation #

• Compatibility Check: Always use a BizTalk Server version that supports .NET Framework 4.8 (BizTalk 2020 is the latest supported version as of now).
• Dependency Handling: The BizTalk SDK may require additional components like SQL Server Native Client—include these in your Dockerfile if the silent install fails due to missing prerequisites.
• Test the Build: Once your image is built, run a test command inside the container to confirm MSBuild can process BizTalk projects:

  msbuild C:\path\to\your\BizTalkProject.csproj /t:Build /p:Configuration=Release
  

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