← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 1581.d

配置何时求值:早中晚

理解等级:高级

像软件工程一样运行“配置即代码”: - 版本化:配置语言会催生模板和工具函数库,一个团队维护、多团队使用。重大变更时要么全局更新所有客户端代码(组织上可能不可行),要么给库分版本让使用者独立迁移(停留旧版的用户积累技术债);Jsonnet 没有专门支持,可用目录做版本,如 ksonnet-lib 把版本放在导入路径的第一段 import 'ksonnet.beta.2/k.libsonnet'; - 源代码控制:保留变更历史(含变更人)、可靠回滚、通过代码审查查看配置变更; - 工具:统一风格、提升可读性、发现错误;编辑器写后钩子和预提交钩子运行同样的格式化和检查; - 测试:给上游模板库写单元测试,确认各种实例化方式产生预期的具体配置;Jsonnet 测试文件导入库、调用、用 assert 或 std.assertEqual(错误信息会显示不匹配的值);大型套件可用社区单元测试框架,汇总所有失败而不是第一个就中止。

封闭性:无论在何时何地执行,都必须生成相同的配置数据——依赖封闭环境外可变资源的系统难以甚至无法回滚。封闭意味着 Jsonnet 总能与它展开后的 JSON 互换,所以可以在任何时候生成 JSON。三种求值时机: - 很早:签入 JSON——改 Jsonnet → 用命令行重新生成 JSON → 预提交钩子保证两者一致 → 一起提交审查。优点:审查者能看到具体变化(例如确认重构不影响输出)、可在两个层次做行注释便于审计、运行时不需要 Jsonnet(降低复杂度、二进制大小和风险暴露);缺点:生成的 JSON 不一定可读(长字符串)、可能太大或含秘密不宜入库、多人编辑不同 Jsonnet 收敛到同一 JSON 会合并冲突; - 中期:构建时求值——构建时运行 Jsonnet,把 JSON 嵌进发布工件,应用初始化时读取(Bazel 有 Jsonnet 规则)。Google 通常偏爱这种方式:控制运行时复杂度和风险,不必每个 PR 重建 JSON,不会失去同步;缺点:构建更复杂、审查时难评估具体变化; - 后期:运行时求值——应用链接 Jsonnet 库随时解释。优点:简单、能执行用户提供的代码;缺点:链接库增加体积和风险、配置错误在运行时才发现(太晚)、不可信代码要格外小心。

选择示例:ksonnet 这类在作者本机运行的命令行工具,直接链接库在进程内求值即可,安全;Box.com 用 Git 钩子推配置,为避免在服务器上执行 Jsonnet,钩子作用于仓库中已生成的 JSON;Helm、Spinnaker 这类部署管理守护进程只能在服务器上运行时求值(需防滥用,见下一卡)。

译文提示:本书为社区机器辅助译本,本卡按上下文和官方英文版理解,引文保留中文原样。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《谷歌站点可靠性工作手册》第15章《第15章 配置细节》15 有效地操作配置系统;何时评估配置(源文件:extracted/谷歌站点可靠性工作手册/_epub-src/OEBPS/Text/21.html,来源项目 book-sources) - 结论依据:第15章说明配置即代码需要版本化、源码控制、工具和模板库单元测试,强调封闭性使Jsonnet与生成的JSON可互换,比较签入JSON、构建时求值(Google偏爱)、运行时求值三种时机的优缺点,并以ksonnet、Box.com、Helm/Spinnaker说明如何选择。 - 原始内容:我们的关键特性包括密封性;也就是说,无论配置语言在何处或何时执行,都必须生成相同的配置数据。