← 中文资源

简体中文版本

黄金路径:被支持的构建与交付方式

黄金路径是平台提供的、经过维护的推荐路线,让安全且可观测的做法成为产品团队最省力的选择。

阅读英文原文

是铺好的路,不是牢笼

黄金路径是平台团队推荐并提供支持的路线:仓库模板、流水线、默认可观测性,以及一条写清楚的投产方式。它刻意带有主张。团队可以离开这条路,但离开就意味着放弃自动升级和支持承诺,这是一笔公平的交易,而不是惩罚。

一条路径包含什么

路径不只是脚手架。它包含可用的构建、接入 CI 的测试、部署清单、看板、告警和负责人;还包含为下个季度入职的人写的文档,以及路径变更时升级存量服务的手段。缺少升级机制,每条路径都会变成旧版本的博物馆。

采用率才是指标

平台团队常常发布路径后,以模板被下载的次数宣告成功。更有用的度量是:通过该路径构建并上线的生产服务占比,以及从首次提交到首次部署的时长。如果采用停滞,通常说明路径比绕路更慢,这是产品问题而不是宣传问题。

让路径活下去

路径需要维护者、变更日志和弃用策略。例如,一条每月升级基础镜像的路径,如果不能自动向每个使用方仓库提交升级 PR,就会积累大量停留在旧镜像上的服务。与 wiki 上的建议清单相比,黄金路径是可执行的:它会运行、会明确失败,也能在 CI 中被测试。

何时该建

当多个团队重复同样的搭建工作,或审计反复发现同样的控制缺失时,就该建设路径。从最常见的工作负载开始,度量它节省的时间,只有在需求真实存在时才为其他形态增加路径。