10. 构建太慢?GitLab 缓存与工件管理:加速构建省时间
「GitLab」系列已发布: 00. GitLab 不只是代码托管:一套 DevOps 平台的 6 大核心能力 | 01. GitLab 怎么装最省心?Omnibus/Docker/K8s 三种姿势 | 02. 装完 GitLab 先配啥?管理员视角的初始化设置清单 | 03. GitLab 角色搞不清?Member/Maintainer/Owner 权限全解 | 04. 从零建好第一个 GitLab 项目:权限、变量、CI 配置入门 | 05. GitLab MR 代码审查:Code Review 最佳实践 | 06. CI/CD 到底是什么?GitLab 流水线架构从概念到实战 | 07. Runner 装不好?GitLab Runner 单机/分布式/高可用全攻略 | 08. .gitlab-ci.yml 怎么写?从 Hello World 到生产配置 | 09. 从 0 到 1:Go + React 项目的 GitLab CI/CD 实战部署 | 10. 构建太慢?GitLab 缓存与工件管理:加速构建省时间(本文) | 11. 测试/预发/生产怎么管?GitLab 多环境部署与金丝雀发布
依赖每次重装、产物没法传,构建慢到想砸电脑。缓存加速依赖安装、工件在 Job 间传递,本文把构建时间砍掉一大半。
前置条件
已掌握 .gitlab-ci.yml 基础语法(第 08 篇)和 Pipeline 构建实战(第 09 篇),对 Runner 的 Docker 执行器有一定了解。
一、缓存 vs 工件
缓存(cache)和工件(artifacts)是 GitLab CI/CD 里最容易搞混的两个东西,但用途完全不同。
| 维度 | cache | artifacts |
|---|---|---|
| 用途 | 加速构建 | 传递产物 |
| 生命周期 | 跨 Pipeline 保留 | 仅当前 Pipeline |
| 存储位置 | Runner 本地磁盘 | GitLab 服务器 |
| 访问方式 | 自动解压到工作目录 | 需手动下载 |
| 典型场景 | node_modules、.m2 | dist、build、报告 |
flowchart LR subgraph Cache["缓存 Cache"] A[Job 1] -->|写入| B[(Runner 磁盘)] B -->|读取| C[Job 2] end subgraph Artifacts["工件 Artifacts"] D[Build Job] -->|上传| E[(GitLab 服务器)] E -->|下载| F[Test Job] E -->|下载| G[部署 Job] end
二、缓存配置
2.1 基础用法
cache:
key: ${CI_COMMIT_REF_SLUG}
paths:
- node_modules/
- .cache/
- vendor/
policy: pull-push # pull / push / pull-push
2.2 多路径缓存
cache:
key:
files:
- package-lock.json
prefix: ${CI_COMMIT_REF_SLUG}
paths:
- node_modules/
- .cache/
- dist/.cache/
2.3 按分支缓存
.cache-common:
cache:
key: common-deps
paths:
- node_modules/
.test-cache:
cache:
key: test-deps-${CI_COMMIT_REF_SLUG}
paths:
- .cache/
policy: pull
三、工件配置
3.1 基础用法
build:
stage: build
script:
- npm run build
artifacts:
paths:
- dist/
- build/
expire_in: 7 days
3.2 多种配置
test:
stage: test
script:
- npm test
artifacts:
paths:
- coverage/
- reports/
expire_in: 30 days
when: on_failure # 仅在失败时保留
reports:
junit: reports/tests.xml
coverage_report:
coverage_format: cobertura
path: coverage/cobertura.xml
3.3 报告类型
| 类型 | 文件路径 | 功能 |
|---|---|---|
| junit | reports/tests.xml |
测试报告和趋势 |
| coverage_report | coverage.xml |
代码覆盖率 |
| codequality | gl-code-quality-report.json |
代码质量 |
| dependency_scanning | gl-dependency-scanning-report.json |
依赖漏洞 |
| container_scanning | gl-container-scanning-report.json |
镜像漏洞 |
| sast | gl-sast-report.json |
安全扫描 |
| dast | gl-dast-report.json |
动态扫描 |
| license_management | gl-license-management-report.json |
许可证合规 |
| secret_detection | gl-secret-detection-report.json |
密钥泄露 |
四、最佳实践
4.1 缓存策略
# 推荐:按依赖锁文件缓存
cache:
key:
files:
- package-lock.json
- yarn.lock
- Gemfile.lock
prefix: ${CI_PROJECT_PATH}-${CI_COMMIT_REF_NAME}
paths:
- node_modules/
- vendor/bundle/
- .cache/
4.2 工件清理
# 大工件及时清理
build:
script:
- npm run build
- rm -rf node_modules # 构建完删除不必要的文件
artifacts:
paths:
- dist/
expire_in: 1 day # 短期保留
4.3 敏感文件排除
artifacts:
paths:
- dist/
exclude:
- '**/.env'
- '**/*.key'
- '**/secrets/**'
五、文章引用
📌 本文首发于微信公众号 【运维知识点滴】——专注运维实战干货,微信搜索“运维知识点滴”或扫下方二维码关注,更新不迷路。
| 微信公众号【运维知识点滴】 | 微信小程序【A5单据合并&大试卷拆分转A4打印】 |
|---|---|
![]() |
![]() |
| 运维实战干货 · 关注追更 | Word 转 PDF · 试卷/发票打印神器 · 免费 |
💡 小程序【A5单据合并&大试卷拆分转A4打印】是干嘛的? 一个 Word 转 PDF 的打印神器,专治“文档版式和打印机对不上”:
- A3 试卷打不出来? 学校发的电子版试卷多是 A3,家用打印机只吃 A4——上传 Word 一键转换:可缩到一页 A4(页数不变),也可对半拆成两张 A4(1:1 原大、字更清晰),两种模式自选;
- 版式不乱:真实渲染引擎原样转换、绝不重排内容,转出的 PDF 和原 Word 排版一致,公式/表格/图片不跑版;
- 两张 A5 单据拼一张 A4:出租车票、火车票等报销凭证拼版后,一次打印、整齐粘贴;
- 隐私省心:无需注册,转换结果留存 5 天、最多下载 5 次即自动删除,不留任何历史记录;
- 微信扫码即用,免费、免安装,支持 doc / docx(≤50MB)。
上一篇:09. 从 0 到 1:Go + React 项目的 GitLab CI/CD 实战部署 | 下一篇:11. 测试/预发/生产怎么管?GitLab 多环境部署与金丝雀发布

