基于GitLab共享Runner构建含PHP、Composer、Docker镜像遇阻求助

我太懂你那种折腾半天自定义镜像却一直失败的崩溃感了——要把PHP、Composer和Docker这仨玩意儿塞进一个镜像里，确实容易因为环境依赖、权限或者版本兼容踩坑。不过你提到参考Stefan的脚本整理后已经跑通了，我把这个经过验证的方案整理清楚，帮你巩固一下，也给其他遇到同样问题的开发者指个路：

最终可用的.gitlab-ci.yml配置 #

stages:
  - setup
  - build

# 第一阶段：安装PHP、Composer并处理项目依赖
setup-dependencies:
  stage: setup
  image: alpine:3.18
  before_script:
    # 安装PHP及必要扩展
    - apk update && apk add --no-cache php81 php81-curl php81-zip php81-mbstring php81-json
    # 安装Composer
    - curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
  script:
    - composer install --no-dev --prefer-dist --optimize-autoloader
  artifacts:
    paths:
      - vendor/
    expire_in: 1 hour

# 第二阶段：使用Docker构建并推送项目镜像
build-docker-image:
  stage: build
  image: docker:24.0.5
  services:
    - docker:24.0.5-dind
  variables:
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_CERTDIR: "/certs"
    DOCKER_DRIVER: overlay2
  needs:
    - setup-dependencies
  before_script:
    # 登录GitLab镜像仓库
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
  script:
    - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA .
    - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA

方案优势说明 #

• 拆分阶段避免环境冲突：把依赖安装和镜像构建拆成独立阶段，分别用Alpine（适合轻量PHP环境）和Docker官方dind镜像（原生支持Docker嵌套），不用硬凑一个兼容所有工具的“大杂烩”镜像。
• 减少重复工作：通过GitLab artifacts传递已安装的Composer依赖，避免在镜像构建阶段重复执行安装步骤，节省CI运行时间。
• 官方服务保障稳定性：直接利用GitLab共享Runner支持的docker:dind服务，无需自行配置Docker嵌套的复杂参数，降低出错概率。

如果你之前执着于构建包含所有工具的自定义镜像，其实完全没必要——这种分阶段的配置不仅更灵活，出问题时也更容易定位排查，后续维护成本也低很多。

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