GitLab CI Windows环境拉取node:latest镜像manifest匹配失败求助

问题原因 #

你的GitLab Runner运行在**Windows Server 2019（ltsc2019，版本10.0.17763）**上，而node:latest镜像没有适配该Windows版本的manifest——Windows容器镜像严格依赖宿主机的Windows版本，跨版本无法兼容。

解决方案 #

1. 使用适配ltsc2019的Node.js镜像 #

Node官方提供了针对Windows Server 2019（ltsc2019）的专用镜像标签，选择对应长期支持（LTS）版本的标签替换node:latest即可，比如：

• node:20-lts-windowsservercore-ltsc2019（Node.js 20 LTS，适配ltsc2019）
• node:18-lts-windowsservercore-ltsc2019（Node.js 18 LTS，适配ltsc2019）

修改后的GitLab CI配置示例：

image: mcr.microsoft.com/dotnet/sdk:6.0.202-windowsservercore-ltsc2019
..................................
app_build:
  stage: build
  only: 
    - Dev
  # 替换为适配ltsc2019的Node镜像
  image: node:20-lts-windowsservercore-ltsc2019
  tags:
    - my-tag
  script:
    - |
      cd Receipt
      npm install
      npm run build --prod

2. 提前验证镜像兼容性（可选） #

在你的Windows Server 2019机器上执行以下命令，确认镜像可以正常拉取：

docker pull node:20-lts-windowsservercore-ltsc2019

备选方案：使用Nano Server镜像（谨慎选择） #

如果你的构建流程不需要完整的Windows Server Core环境，可以尝试基于nanoserver-ltsc2019的Node镜像，比如node:20-lts-nanoserver-ltsc2019。但注意Nano Server功能精简，可能会遇到npm依赖安装失败的问题，需要自行测试适配。

内容的提问来源于stack exchange，提问作者Imran Qadir Baksh - Baloch