如何在GitLab CI/CD的Review阶段为预览应用导入PostgreSQL数据

1. 先解决Review阶段拉不到构建制品的问题 #

你现在拿不到制品的核心原因，是复用的.auto-deploy通用部署模板——也就是GitLab Auto DevOps体系里的标准部署配置——默认把跨阶段制品传递逻辑给关了。

这是非常常见的踩坑点：模板里一般会内置dependencies: []的空配置，直接阻断所有下游job自动拉取上游制品的流程。你之前写的那句echo没有任何实际作用，GitLab根本没有“自动帮你携带制品”的隐藏开关，不主动显式配置的话，制品流就会被模板直接截断。

修复时不要依赖模板的默认逻辑，在review job里明确指定制品来源，有两种可靠写法：

• 用dependencies字段覆盖模板的空配置，把产出SQL备份的构建job列进去（比如你产出备份的job叫generate-pg-backup）：

  review:
    extends: .auto-deploy
    stage: review
    # 这行配置会直接覆盖模板里的空dependencies设置
    dependencies:
      - generate-pg-backup
    before_script:
      # 加个基础校验，确认文件真的拉下来了，避免后续步骤莫名报错
      - ls -lh postgres_backup.sql
  

• 用新版GitLab推荐的needs字段声明依赖，同时显式开启制品拉取，可靠性更高，还能自动调整job执行顺序，不需要等整个阶段的其他job跑完：

  review:
    extends: .auto-deploy
    stage: review
    needs:
      - job: generate-pg-backup
        artifacts: true # 明确开启制品拉取，不会被模板默认配置覆盖
    before_script:
      - test -f postgres_backup.sql || (echo "备份SQL文件缺失，终止流程" && exit 1)
  

注意：如果生成备份的构建job是手动触发、运行失败、或者被配置了when: manual，它产出的制品不会被传递到下游，要确保备份生成任务是随pipeline自动成功执行的。

2. 解决运行环境无psql、无apt安装源的问题 #

你当前的CI运行镜像大概率是精简的distroless或者极小型Alpine版本，没有包管理器，在线安装psql的路径是走不通的，直接用下面三种不需要在线安装的方案：

• 拆出独立的导入job，用自带psql的官方镜像
  不用硬往没有包管理器的镜像里塞工具，单独加一个负责数据导入的小job，直接选用PostgreSQL官方的Alpine镜像——这个镜像原生内置全量psql、pg_restore、pg_dump工具，镜像体积只有几十MB，不需要额外安装任何依赖：

  import-review-pg-data:
    image: postgres:15-alpine
    stage: review
    # 同样显式拉取构建阶段的SQL备份
    needs:
      - job: generate-pg-backup
        artifacts: true
    variables:
      # 直接读取CI预置的数据库连接变量即可
      PGHOST: $REVIEW_ENV_PG_HOST
      PGUSER: $REVIEW_PG_USER
      PGPASSWORD: $REVIEW_ENV_PG_PASSWORD
      PGDATABASE: $REVIEW_ENV_DB
    script:
      # 开启错误中断，导入失败及时报错
      - psql -v ON_ERROR_STOP=1 -f postgres_backup.sql
  

• 提前把静态psql二进制打入基础镜像
  如果不想额外加job，可以把静态编译的psql可执行文件直接放到你项目通用的CI基础镜像里，放在系统可执行文件的路径下，CI运行时不需要做任何安装操作，直接调用psql命令即可。
• 完全跳过CI环境运行psql的步骤
  既然你是部署到AWS，完全可以在构建阶段就把postgres_backup.sql直接传到临时S3桶路径，review部署PG实例的时候，直接用AWS RDS的原生S3导入功能加载备份，全程不需要在CI环境里运行psql命令，连跨阶段传制品的步骤都可以省掉。

内容的提问来源于stack exchange，提问作者d-cubed