Terraform 状态文件治理:五个容易踩坑的实践
一、先弄清楚 state 里到底存了什么
很多人把 terraform.tfstate 当成一个「记录创建过什么」的清单,其实它是 Terraform 的全部世界模型:每个资源的真实 ID、属性快照、依赖关系、以及 provider 的 schema 版本。Terraform 的 plan 之所以能做到「只改差异」,靠的是把配置文件期望值与 state 里的旧快照做三方比对。
这意味着 state 一旦损坏或错位,Terraform 不会报「文件坏了」,而是给你一个看起来完全合理的 plan——比如把已经存在的数据库当成新资源再建一遍。线上事故里相当一部分「重复创建」都源于此,而不是配置写错。
二、用目录与 workspace 隔离环境,别用 -target 救火
同一个 state 里塞 dev/staging/prod 是最常见的起点,也是最容易出事的地方。只要有人在 prod 目录误跑一次 apply,dev 的资源就可能被顺手改掉。正确做法是按环境拆分目录(每个目录一个 backend key),或者用 workspace 做逻辑隔离,但注意 workspace 共享同一份配置,变量差异要靠 tfvars 传递。
另一个高频误用是拿 -target 当日常操作。它跳过了依赖图的一部分,会让 state 与真实资源产生细微漂移,而且这种漂移在下一次全量 plan 之前不会暴露。把 -target 限定在真正的故障恢复场景,平时只做完整 plan。
三、远程后端与状态锁是底线配置
本地 state 只适合单人玩具项目。团队协作必须使用远程后端(对象存储 + 锁),否则两个人同时 apply 时后写入的会覆盖前者的状态,资源就成了「孤儿」——还在计费,但 Terraform 已经不认识它。
以对象存储为例,关键参数是三件事:bucket、key(按环境区分路径)、以及锁机制。部分后端原生支持锁,部分需要额外的锁表;上线前务必做一次并发测试,两个人同时 apply,确认第二个人被明确拒绝而不是静默成功。
四、敏感值不要停在明文 state 里
state 会原样保存资源属性,包括数据库密码、密钥、证书私钥。把 state 提交进 Git 等于把凭据公开。最低要求是后端开启服务端加密,并对 bucket 做最小权限收敛;更稳妥的做法是让敏感值来自密钥管理服务,配置里只引用 ARN 或路径,而不是写死明文。
还要注意 plan 输出:CI 日志里打印的 plan 会带上敏感字段。记得给变量加 sensitive = true,并对流水线日志做脱敏,否则加密 state 也挡不住日志泄露。
五、把漂移检测做成例行任务,而不是事故响应
控制台手动改一下安全组、扩个磁盘,是最难避免的现实。与其事后追查,不如每天定时跑一次 plan,把「计划外变更」的数量和明细推到群里。计划为空是常态,一旦非空就有人跟进。
迁移 state 时(比如调整模块路径、拆分子模块),用 moved 块而不是手改 state rm + import。moved 是声明式的,能在 plan 阶段就看出资源会不会被销毁重建,这一点对数据库、负载均衡这类不可随意重建的资源尤其关键。
最后一条经验:把 state 的备份当成发布流程的一部分。每次 apply 前自动导出一份带时间戳的副本,保留最近若干份。真正需要回滚时,一份十分钟前的 state 比任何排障技巧都管用。
- 点赞
- 收藏
- 关注作者
评论(0)