把配置留在边界
在配置和应用代码之间留出清楚的边界,修改起来就更容易理解。
配置通常从方便的小入口开始:这里放个 URL,那里放个超时,函数旁边再加一个开关。时间一长,这些决定散布到整个代码库。修改部署配置时,就必须知道哪些代码会在什么时候读取哪些值。
集中读取,尽早校验
在程序入口附近加载配置,把字符串转换成应用需要的类型,检查必填项,并在开始接受任务前报告错误。启动时发现缺少地址,比处理用户请求到一半时发现更容易排查。
把校验后的小对象传给需要它的部分。处理发票的代码,不应该还要知道环境变量叫什么。
明确由谁负责
每项配置都需要明确的用途和归属。超时放在发生等待的边界,限额靠近它保护的资源。同一个设置在多个模块重复保存,就可能逐渐出现差异。
默认值也要有意选择。适合本地开发的默认值,不一定适合已经部署的服务。把这个区别明确表达出来,而不是依赖没有文档说明的命名习惯。
不要显示秘密信息
配置摘要可以帮助运维人员理解正在运行的服务,但它应该说明启用了什么,而不是打印凭据。记录凭据已经加载,不要记录凭据本身。
诊断信息、异常消息、测试快照和支持资料也需要同样谨慎。数据往往不是从直接处理它的代码泄漏,而是从图方便的辅助功能中泄漏。
让修改可以被确认
如果支持重新加载配置,就说明哪些设置立即生效,哪些需要重启。提供一个不包含敏感信息的版本标识,让维护者知道当前使用的是哪份配置。
这样,应用代码处理有明确含义的值,部署代码负责这些值从哪里来。两边都能修改,而不会悄悄改变另一边的职责。