DevOps CI/CD 流水线怎么画

CI/CD 流水线图怎么画才清楚?这份指南拆解 DevOps 持续交付链路的核心阶段、常见结构,并给出可直接复制的 AI 生成 prompt 模板。

作者:松柏

DevOps CI/CD 流水线怎么画

CI/CD 流水线图应用从左到右画出「提交 → 构建 → 测试 → 部署 → 监控」主链路,并用颜色区分阶段;节点多时用 AI 先出草稿再微调最省时。

CI/CD(持续集成 / 持续交付)是现代软件交付的核心流水线。一张清楚的 CI/CD 图能让新人几分钟看懂「代码从提交到上线走了哪些环节」,也能在事故复盘时快速指出故障落在哪一段。本指南拆解标准阶段、常见结构与 AI 出图方法;构图AI 支持 12 种图类型中的流程图 / 架构图技能,示例库约有 25 个模板可参考,生成结果可导出 PNG / SVG / .excalidraw

何时需要画 CI/CD 图

  • 新人 onboarding:解释团队的开发与发布流程,避免只靠口头传说。
  • 架构评审:说明流水线里每个阶段的角色(构建、测试、扫描、部署)。
  • 事故复盘:画出问题发生在哪个阶段,比纯文字时间线更直观。
  • 跨团队对齐:开发、测试、运维对「谁触发、谁审批、谁回滚」达成一致。
  • 合规审计:证明生产变更有扫描、审批与可追溯制品。

核心阶段

一条标准的 CI/CD 流水线通常包含以下阶段:

  1. 代码提交(Commit):开发者 push 到 Git。
  2. 触发(Trigger):CI 系统检测到变更(push / MR / 定时)。
  3. 构建(Build):编译代码、生成制品(Artifact / Docker Image)。
  4. 单元测试(Test):跑测试用例,覆盖率上报。
  5. 代码扫描(Scan):静态检查、安全扫描、依赖审计。
  6. 制品仓库(Registry):镜像 / 包推送到 Registry。
  7. 部署预发(Staging):自动部署到预发环境。
  8. 集成测试(Integration Test):自动化端到端测试。
  9. 审批(Approval):人工审批(生产强烈建议保留)。
  10. 部署生产(Production):蓝绿 / 灰度 / 滚动发布。
  11. 监控(Monitor):上线后指标采集、告警、可选回滚入口。

画图时不必 11 步全画满:内部培训可全量;对外一页纸可合并为 5–7 个阶段。关键是主链路不断、旁路不抢戏

常见结构

结构特点适合
线性流水线阶段顺序执行,最简单小团队、单体应用
分叉流水线Build 后并行 Test / Scan / 安全希望缩短反馈时间
多环境流水线dev → staging → prod 各有门禁多环境规范团队
GitOpsCI 只构建镜像,部署由 Git 调谐触发K8s / 声明式运维

画图时颜色区分阶段类型(构建绿、测试黄、部署蓝、监控灰)能显著提升可读性。并行分叉用「同一纵列多箭头」比交叉连线更清晰。

手动画图 vs AI 生成

DevOps 图最大的痛点是节点多、连线密,手动对齐累人。对比常见做法:

方式大致耗时痛点
draw.io 手动画30 分钟起对齐、改阶段名成本高
PlantUML / Mermaid10–20 分钟要记语法,布局难控
构图AI 一句话生成约 5–10 秒出草稿需人工检查阶段是否完整

构图AI 先出草稿再微调,通常几分钟内可得到能上评审的版本。登录后有 1 次免费额度;VIP 不限制 AI 画图,便于反复迭代流水线变体。

用构图AI 怎么画

画一张 DevOps CI/CD 流水线图,手绘风。
阶段从左到右:Commit → Build → Test → Scan → Registry → Staging → Approval → Production → Monitor。
分叉:Build 之后并行跑 Test 和 Scan。
环境:Staging 和 Production 用不同颜色框区分。
监控旁路:从 Production 抽取指标到 Monitor 节点。

参考 CICD 流程示例 一键改造。生成后建议检查清单:

  • Registry 是否在部署之前(制品先入库再部署)。
  • 审批是否只挂在 Production 前。
  • 是否需要 Rollback 虚线旁路。
  • 发布策略是否在 Production 节点旁标注。

行业变体

  • K8s 部署:增加 Ingress / Service / Deployment 节点,详见 K8s 部署示例
  • GitOps:把 Approval 后的部署改成「更新 Git → ArgoCD 调谐」。
  • 小程序 / 前端:把镜像换成 CDN 静态资源发布,扫描侧重依赖与包体积。
  • 移动端:增加签名、渠道包、商店审核节点。

构图AI 的流程图与架构图技能都能画 CI/CD;若还要表达「谁在何时触发」,可另开一张时序图补充(见 时序图入门)。导出 PNG 贴 Confluence / 飞书,SVG 进 PPT,.excalidraw 留给下次迭代。

画给谁看:三种受众三种粒度

同一条流水线,给不同人看时应裁剪不同版本,而不是永远甩一张「十二阶段全家桶」:

  • 给新人:保留 Commit → Build → Test → Deploy → Monitor,用一句话注释「镜像从哪来、谁能点生产」。
  • 给研发同学:补上 Scan、Registry、并行测试,标明失败是否阻断合并。
  • 给审计 / 负责人:突出 Approval、制品追溯、回滚入口,弱化与合规无关的工具细节。

颜色与形状也建议约定:矩形表示阶段,菱形只留给「是否审批 / 是否通过质量门禁」,圆柱或单独图标表示制品库。AI 生成后若出现过多交叉线,优先把并行阶段改成「同一列向下分叉再汇合」,可读性会立刻上升。把 CI/CD 图链到 微服务架构指南 与部署示例,还能帮助新人理解「流水线下游到底部署进了哪张架构」。

最后提醒:流水线图是流程说明,不是监控大盘。错误率、耗时 P99 用监控系统表达即可,不要把 Grafana 面板画进 CI/CD 主图。

若团队刚引入自动化测试或安全扫描,也可以专门画一张「质量门禁放大图」:只包含 Build 之后到 Staging 之前的检查项,并标注失败是否阻断。主流水线图保持稀疏,细节图按需展开,比在一张图上堆十几个小方块更利于培训。工具名称(Jenkins、GitHub Actions、GitLab CI)可以写在阶段旁,但不要让工具 logo 抢走阶段语义——读者首先应读懂「做了什么」,其次才是「用什么做」。定期用真实失败案例更新图注,比追求完美排版更能保持文档生命力。把构图AI 导出的 SVG 放进架构委员会材料时,记得同步附上「谁有权点生产审批」一句话,避免流程图看起来全自动、实际上仍有人工闸门。

相关指南

常见问题

CI/CD 流水线图一般要画到多细?+

团队内部画到「阶段名 + 关键产物」(如镜像、测试报告)即可;对外或高管沟通可只保留 Commit → Build → Test → Deploy → Monitor 五段。细节过多会掩盖主链路。

审批节点一定要画进 CI/CD 图吗?+

生产环境强烈建议画。审批是审计与责任边界的关键节点;预发全自动流水线可省略,但要在图注标明「Staging 免审」。

怎么画回滚链路才不和主流程缠在一起?+

把 Rollback 画成旁路:Monitor 告警 → 选择上一制品版本 → 回滚 Production。用虚线或另一颜色,避免与正向部署箭头混在同一层。

GitOps 和传统 CI/CD 图有什么画法差异?+

传统图画「CI 直接部署」;GitOps 应把部署触发画成「更新 Git 期望状态 → ArgoCD / Flux 调谐集群」,CI 只负责构建与推镜像。

相关指南