# 运维一线接不住的，往往不是语法

专栏《Azure 上的 Terraform》· 平台治理实战 · 开篇

> 术可穷于书，道不可假于人。

---

## 一

刚接触 Terraform 时，碰到的问题都很具体：资源怎么声明，变量放在哪里，`plan` 和 `apply` 怎么跑。

在实验订阅里照着文档搭出 RG 和 VNet，再翻《Terraform经典实例》《Terraform 实战》《Terraform构建与运行》等入门书，从常用写法、项目结构到 CI，书里都有路可循。照着做几遍，`plan` 能看懂，资源也能建起来。

如今有了 AI 加持，查语法、找例子比以前快得多，写一段 HCL 并不难。可真正接手公司环境后，报错不会告诉你该翻哪一章。

---

## 二

dev 的 pipeline 红了。

开发说应用没发版，网络说入口没切流，管身份的同事正在查 RBAC。几边说的都对，却没人敢先说：「就改这一处。」

你重新跑了一遍 `plan`。改动不多，镜像、sizing、标签却有几项跟昨晚发布的结果对不上。群里没人认这几处变化，plan 仍然是绿的。

---

再打开 **Activity Log**（操作审计日志），操作者一栏只有一个共享账号。是谁用的、从哪条流水线来的、该找哪个团队，当天往往对不齐，茫无头绪。

runbook 里也不会写明每一次该找谁：谁管账号，谁管网络，谁能决定对外入口怎么改。相似的配置很容易搜到，这一次该先动哪里，却没有现成答案。

---

## 三

这也是我写专栏的由头：值班里那些说不清、却必须有人拍板的场面，值得一件件写下来。

故事先从那个共享账号讲起。账号背后是团队和权限；人分开以后，流水线的部署身份也得跟着分；新的连接接手变量组，Key Vault 又报了 403。等这些关系理顺，应用进私网时，DNS、Private Endpoint 和对外入口还会一起找上门。

事情走到哪，Terraform 就用到哪。tfvars 记下不同环境的差别，locals 把零散关系理顺，module 划开各自负责的部分，state 记住资源归谁管理。`plan` 也不只是命令输出，而是每次变更前必须看懂的一份清单。

这些故事发生在虚构组织 EG：dev、prod 两个订阅，relay、pulse、harbor 三个应用团队，还有平台组里总被 @ 的小 D。每一篇都从一件具体的麻烦写起，查清现场，再决定 Terraform 应该管什么、管到哪里。

全篇分成三幕：

```text
  第一幕 · 谁能动什么          第二幕 · 面能不能收窄
  权限自治                      安全加固（网络 · 私网 · 边缘层）
        │                              │
        └──────────┬───────────────────┘
                   ▼
          第三幕 · 线上怎么养得住
          运维 · 监控 · 成本
                   │
                   ▼
       番外 · 工具箱：效率与质量
```

先把人、团队和部署身份理清，再收紧网络与入口；这些边界稳下来以后，才谈得上监控、成本和长期维护。

三幕之后还有一组番外：Checkov、TFLint、terraform-docs、Infracost、terraform test、pre-commit。判断由人来做，工具负责把定下来的规矩一遍遍检查下去。

---

## 结语

开发对着 plan 不敢点，运维对着日志对不上人，评审对着 diff 说不清归属——三个角色，场面常常一样。

语法有书可查；值班现场里，先把事看清楚，比多翻一章更难。术从书里来，道得在现场走一遍。

---

| | |
|---|---|
| 英文全书 | [Leanpub](https://leanpub.com/terraform-on-azure) |
| 可跑示例 | [仓库根目录](https://github.com/NewbMiao/terraform-on-azure-examples) |

侧栏列出**全书**目录：**可点链接**为本站样章；灰色为[全书](https://leanpub.com/terraform-on-azure)未开放正文。
