请求协助排查GitLab CI/CD部署Angular应用到Azure的Docker错误

1. 检查Docker权限配置 #

• 确保GitLab Runner执行用户拥有Docker操作权限，在Runner服务器执行 sudo usermod -aG docker gitlab-runner，随后重启Runner服务 sudo systemctl restart gitlab-runner。
• 若使用Docker-in-Docker（DinD）模式，需在CI配置中启用特权模式，示例配置如下：

  deploy:
    stage: deploy
    image: docker:latest
    services:
      - docker:dind
    variables:
      DOCKER_HOST: tcp://docker:2375
      DOCKER_DRIVER: overlay2
    before_script:
      - docker login -u $AZURE_ACR_USERNAME -p $AZURE_ACR_PASSWORD $AZURE_ACR_REGISTRY
    script:
      - docker build -t $AZURE_ACR_REGISTRY/angular-app:latest .
      - docker push $AZURE_ACR_REGISTRY/angular-app:latest
    tags:
      - docker
  

2. 验证Azure容器注册表（ACR）权限 #

• 确认GitLab CI变量中的AZURE_ACR_USERNAME、AZURE_ACR_PASSWORD、AZURE_ACR_REGISTRY配置正确，可在本地执行docker login命令测试登录是否成功。
• 确保ACR访问策略允许当前凭证拥有镜像推送/拉取的权限。

3. 检查Dockerfile合法性 #

• 确保Angular项目根目录的Dockerfile语法正确，推荐使用多阶段构建减少镜像体积：

  # 构建阶段
  FROM node:18-alpine AS build
  WORKDIR /app
  COPY package*.json ./
  RUN npm install
  COPY . .
  RUN npm run build --prod
  
  # 部署阶段
  FROM nginx:alpine
  COPY --from=build /app/dist/angular-app /usr/share/nginx/html
  EXPOSE 80
  

• 验证Dockerfile中路径是否正确，比如dist目录需与Angular本地构建输出目录一致，可通过ng build在本地测试确认。

4. 排查CI环境依赖 #

• 确认CI执行环境已安装兼容版本的Docker客户端，可在流水线脚本中加入docker --version、docker info命令验证环境可用性。
• 若使用自托管Runner，检查Runner服务器是否能正常连接Docker服务，避免网络或服务启动异常。

5. 定位具体错误点 #

• 展开GitLab流水线失败任务的完整日志，定位错误的具体触发环节（比如docker build失败、docker push权限报错等），针对性修复问题。

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