首页/开发/CI/CD 与发布速查/GitLab CI 的 artifacts
工具链要点63 条

GitLab CI 的 artifacts

作业产物:把文件在阶段间传递并留存供下载;可配置过期时间与上传时机,是构建制品在流水线内传递的标准方式。

CI/CD 与发布速查开发更新于 2026-10-12
写法artifacts: paths: [dist/]
时机when: on_success(默认)/ always / on_failure
过期expire_in(如 1 week)
与 cache 区别artifacts 保证传递;cache 是加速,允许丢失

产物配置

产物配置
build:
  stage: build
  script: [make dist]
  artifacts:
    name: "app-$CI_COMMIT_SHORT_SHA"
    paths: [dist/]
    expire_in: 1 week
跨作业传递必需产物用 artifacts;缓存第三方依赖才用 cache,两者语义不同。

易错点

  • 默认只在成功时上传:失败现场的产物需要 when: always 或 on_failure
  • 把构建产物只放进 cache:缓存被清理后下游作业拿不到文件

数据来源与参考

  • GitLab Docs《Job artifacts》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌