Windows Docker同入口点镜像在GitLab Runner中行为不一致问题

问题背景 #

基于chocolatey/choco:v2.2.2-windows构建了两个Windows Docker镜像：

• 镜像1：基础配置，未安装Nvidia CUDA
• 镜像2：在镜像1基础上添加RUN choco install -y cuda命令

两者Dockerfile的入口点配置完全一致：

SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
COPY entrypoint.cmd entrypoint.cmd
ENTRYPOINT ["entrypoint.cmd"]

entrypoint.cmd核心逻辑为：

...
%*

在GitLab流水线中使用这两个镜像时，两者都会执行entrypoint.cmd，但只有安装了CUDA的镜像2能正常运行流水线脚本。

排查方向 #

1. 环境变量差异：Chocolatey安装CUDA时会自动配置PATH等环境变量，可能补充了命令执行所需的路径；而基础镜像中缺少这些路径，导致%*传递的流水线脚本命令无法被系统找到执行。
2. entrypoint脚本隐性依赖：entrypoint.cmd中省略的...部分可能包含依赖CUDA的逻辑（比如检查CUDA环境、调用相关工具），未安装CUDA时这部分逻辑可能阻塞了后续的%*执行。
3. 容器执行上下文差异：CUDA安装过程可能调整了Windows容器的默认shell配置、权限或系统状态，基础镜像的环境无法正确处理GitLab Runner传递的参数。

修复方案 #

方案1：同步关键环境变量 #

在未安装CUDA的镜像Dockerfile中，手动添加CUDA安装时会配置的PATH条目（先在镜像2中执行echo %PATH%获取完整路径）：

# 替换为镜像2中实际的CUDA路径
ENV PATH="C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.4\bin;C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.4\libnvvp;%PATH%"

方案2：显式指定脚本执行shell #

修改entrypoint.cmd，显式调用PowerShell执行传递的参数，避免环境差异导致的命令解析失败：

...
powershell -Command "%*"

如果流水线脚本是批处理类型，改用：

...
cmd /c "%*"

方案3：修复entrypoint脚本的依赖问题 #

检查entrypoint.cmd中省略的逻辑，移除或添加条件判断避免依赖CUDA：

:: 示例：添加条件判断，跳过CUDA相关逻辑（如果有的话）
IF EXIST "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA" (
    # 原依赖CUDA的操作
)
:: 执行流水线脚本
%*

方案4：改用PowerShell作为entrypoint #

替换cmd脚本为PowerShell脚本，减少环境兼容性问题：

# 替换原entrypoint配置
COPY entrypoint.ps1 entrypoint.ps1
ENTRYPOINT ["powershell", "-File", "entrypoint.ps1"]

entrypoint.ps1内容：

# 原entrypoint逻辑
...
# 执行流水线脚本
Invoke-Expression $args

内容的提问来源于stack exchange，提问作者Johannes von Zmuda