GitLab子模块能否无Git二进制运行？欲跳过copy阶段直接构建

核心结论 #

GitLab CI的子模块拉取/更新操作依赖Git二进制文件，默认情况下，没有Git的环境无法通过GIT_SUBMODULE_STRATEGY等变量自动完成子模块初始化。你尝试的官方配置无效，是因为Runner在作业执行前的预初始化阶段就需要调用Git命令拉取子模块，若镜像无Git，这个阶段直接失败，根本到不了你写的script步骤。

无需额外copy阶段的解决方案 #

要直接进入npm build等业务阶段，推荐以下两种方案：

方案1：在业务镜像中临时安装Git

给你的业务镜像（比如Node.js镜像）添加Git安装步骤，让Runner能在预阶段自动拉取子模块，之后直接执行业务命令。示例配置：

build:
  stage: build
  image: docker.io/node:20-alpine
  variables:
    GIT_SUBMODULE_STRATEGY: recursive
    GIT_SUBMODULE_DEPTH: 1  # 按需设置子模块拉取深度
  before_script:
    # Alpine系统安装Git，Debian/Ubuntu系换成 apt-get update && apt-get install -y git
    - apk add --no-cache git
  script:
    - npm install
    - npm run build

方案2：使用带Git的自定义Runner

如果不想在业务镜像中安装Git，可以配置自定义Runner，让Runner本身具备Git环境（Runner宿主机已安装Git），此时作业使用的镜像无需包含Git，Runner会在宿主机层面完成子模块拉取后再挂载到作业容器中。不过这种方式需要维护自定义Runner，灵活性不如方案1。

关于你当前copy阶段的优化（可选） #

如果你暂时不想修改业务镜像，也可以优化现有copy阶段，通过工件传递子模块代码到后续业务阶段：

submodule:
  stage: copy
  image: docker.io/bitnami/git
  variables:
    GIT_SUBMODULE_STRATEGY: recursive
    GIT_SUBMODULE_DEPTH: 1    
  script: 
    - ls -la scripts
  artifacts:
    paths:
      - ./*
    expire_in: 1h  # 避免工件占用过多存储

后续的npm build阶段无需再处理子模块，直接使用传递过来的代码即可，但这仍然会多一个copy阶段，不是最优解。

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