Windows Docker镜像中Node.js与.NET SDK共存遇msiexec命令不可用问题

问题重现 #

我有如下Windows Dockerfile，尝试安装Node.js时失败：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build

#####################################################
# I NEED NODE.JS WITHIN THE SAME LAYER AS DOTNET SDK.
RUN curl -o nodejs.msi https://nodejs.org/dist/v14.16.0/node-v14.16.0-x86.msi
RUN msiexec /i nodejs.msi /quiet /qn /norestart
#####################################################

WORKDIR /src
COPY ["NetWithAngular/NetWithAngular.csproj", "NetWithAngular/"]
RUN dotnet restore "NetWithAngular/NetWithAngular.csproj"
COPY . .
WORKDIR "/src/NetWithAngular"
RUN dotnet build "NetWithAngular.csproj" -c Release -o /app/build

# ...the rest I've skipped...

错误信息：

'msiexec' is not recognized as an internal or external command, operable program or batch file.

我尝试用powershell也出现相同错误，而且我需要.NET SDK和Node.js在同一镜像层（因为项目是.NET+Angular集成构建，会触发npm build），不能用多阶段构建引入Node.js。后来换成mcr.microsoft.com/dotnet/sdk:6.0-windowsservercore-ltsc2022镜像后，msiexec和powershell都能正常使用，但还是有疑问：原基础镜像为什么没有这两个命令？甚至有人说用相同基础镜像成功执行了msiexec。

一、原基础镜像没有msiexec和powershell的原因 #

mcr.microsoft.com/dotnet/sdk:6.0这个默认标签的镜像，底层是Windows Nano Server——微软推出的超精简Windows容器镜像，只保留了最核心的Windows功能，砍掉了大量组件：

• msiexec属于Windows Installer服务，Nano Server没有预装这个组件，所以无法执行MSI安装包
• PowerShell也不在Nano Server的默认预装列表里，它只保留了最基础的CMD命令行

而你换成的6.0-windowsservercore-ltsc2022标签镜像，底层是Windows Server Core，这是包含完整Windows基础组件的镜像，自然支持msiexec和PowerShell。

至于有人说用相同默认标签镜像成功执行msiexec，大概率是他们实际使用的镜像标签存在差异：比如早期的.NET SDK镜像默认标签可能指向Server Core版本，或者他们误打了带servercore后缀的标签却没注意到。

二、在原Nano Server基础镜像中安装Node.js的方法 #

既然Nano Server不支持MSI安装，就改用Node.js的zip压缩包版本，步骤如下：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build

# 用zip包安装Node.js（替代MSI）
RUN curl -o nodejs.zip https://nodejs.org/dist/v14.16.0/node-v14.16.0-win-x64.zip \
    && mkdir C:\nodejs \
    && tar -xf nodejs.zip -C C:\nodejs --strip-components=1 \
    && setx PATH "%PATH%;C:\nodejs\bin" \
    && del nodejs.zip

# 后续.NET构建步骤保持不变
WORKDIR /src
COPY ["NetWithAngular/NetWithAngular.csproj", "NetWithAngular/"]
RUN dotnet restore "NetWithAngular/NetWithAngular.csproj"
COPY . .
WORKDIR "/src/NetWithAngular"
RUN dotnet build "NetWithAngular.csproj" -c Release -o /app/build

# ...后续步骤...

说明：

• Nano Server自带tar命令，可以直接解压zip包
• setx命令用来将Node.js的bin目录添加到系统PATH，确保node和npm命令全局可用
• 最后删除zip包，避免镜像体积冗余

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