如何在GitLab的Dockerfile中传入CI_JOB_TOKEN下载私有NPM模块

从你的错误日志能一眼看出核心问题：CI_JOB_TOKEN变量根本没被替换成实际令牌值，而是以${CI_JOB_TOKEN}的原样传给了GitLab，这直接导致HTTP Basic认证失败。下面我帮你一步步排查并修复各个配置的问题：

1. 修正gitlab-ci.yml配置 #

首先，GitLab CI会自动注入CI_JOB_TOKEN变量，你不需要手动在variables块里重复定义。另外，docker-compose push命令不需要--arg参数（这是构建阶段专属参数），正确配置如下：

image: tmaier/docker-compose:latest

stages:
  - build

build:
  stage: build
  script:
    - docker-compose build --build-arg CI_JOB_TOKEN=$CI_JOB_TOKEN
    - docker-compose push

2. 确保docker-compose.yml正确传递参数 #

你的docker-compose.yml配置基本没问题，可以明确变量来源避免歧义：

services:
  qa-service:
    build:
      context: .
      args:
        PORT: 3000
        CI_JOB_TOKEN: ${CI_JOB_TOKEN}

3. 修复Dockerfile中的变量解析问题 #

这是最关键的环节：你原命令里用双引号包裹URL，可能导致shell无法正确解析${CI_JOB_TOKEN}变量。更可靠的做法是用.npmrc配置NPM认证，既安全又能避免变量解析坑：

FROM ubuntu:latest

# 补充安装Node.js和npm（原Dockerfile大概率漏掉了这一步）
RUN apt-get update && apt-get install -y nodejs npm

# 声明构建参数
ARG CI_JOB_TOKEN

# 配置GitLab私有NPM仓库认证
RUN echo "@your-group:registry=https://gitlab.example.com/api/v4/packages/npm/" >> .npmrc && \
    echo "//gitlab.example.com/api/v4/packages/npm/:_authToken=${CI_JOB_TOKEN}" >> .npmrc && \
    # 如果模块存在项目级仓库，需补充此行（替换xxx为项目ID）
    echo "//gitlab.example.com/api/v4/projects/xxx/packages/npm/:_authToken=${CI_JOB_TOKEN}" >> .npmrc

# 直接安装私有模块（替换@your-group/yyy为你的模块名）
RUN npm install @your-group/yyy

如果坚持要用Git URL方式安装，需去掉URL外的双引号，让shell能正确替换变量：

FROM ubuntu:latest

ARG CI_JOB_TOKEN
RUN npm install git+https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.example.com/xxx/yyy.git

额外注意事项 #

• 确保CI_JOB_TOKEN有权限访问私有模块所在项目：在项目设置的CI/CD → 权限中，开启「允许CI作业访问这个项目的令牌」
• 若使用Docker-in-Docker模式运行CI，需确保Docker守护进程能正确传递环境变量（你的tmaier/docker-compose镜像默认支持）

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