5.3 声明式 vs 命令式的设计取舍
K8s 选择声明式不是偶然。本节把声明式与命令式作为两种系统设计哲学对比,分析它们的取舍,并解释为什么「面向分布式系统、追求自动恢复」的场景天然倾向声明式。
两种哲学
| 命令式 | 声明式 | |
|---|---|---|
| 描述 | 怎么做(步骤) | 要什么(结果) |
| 例子 | 脚本:创建 A、等它、创建 B | YAML:我要 3 个副本 |
| 系统智能 | 在调用方 | 在控制器 |
| 恢复能力 | 需调用方重跑 | 控制器自动 |
| 幂等 | 需自己保证 | 天然(从现实出发) |
命令式的问题:状态不会自己修复
写一个命令式脚本创建服务:
1. kubectl create deployment web
2. kubectl scale --replicas=3
3. kubectl expose ...
运行一次成功。但 Pod 被误删、节点故障、副本漂移时,脚本不会重跑。命令式把「保持期望」的责任交给了调用方——而调用方(人)不会 7×24 盯着。
命令式的本质是「一次性」的:它描述一次转变,不描述持续状态。分布式系统的现实是持续漂移(节点挂、Pod 重启、副本被抢占),一次性的转变无法对抗持续漂移。
声明式的答案:控制器持续矫正
声明式的 YAML:
apiVersion: apps/v1
kind: Deployment
metadata: {name: web}
spec: {replicas: 3}
提交后系统如何保证「一直是 3 个」?
- 有变化 → 控制器算误差 → 修正。
- 无变化 → 控制器周期性 resync,发现漂移仍会修正。
- Pod 被删 → 控制器重建(误差重新为正)。
声明式的核心不是 YAML,是 YAML 背后的负反馈循环。YAML 只是把「期望」交付给系统;「保持期望」是控制器的全职工作。这解释了卷二为什么花一整卷讲控制器:声明式 API 的价值不在语法,在于它的执行机制。
声明式的代价
声明式不是免费的,它有三个主要代价:
- 行为不透明:系统怎么达到期望状态,是控制器决定的。用户看到「期望 3、现状 3」,但中间经历了什么(先建 5 再删 2?)不透明。调试依赖事件与日志,而非脚本步骤。
- 需要控制回路:声明式必须配控制器。没有控制器的「声明」只是「没有动作的愿望」。这也是为什么 CRD 要配 custom controller(卷二第 13 章)。
- 收敛需要时间:从提交到生效要经过调谐循环,不像命令式「运行即执行」。HPA 的稳定窗口甚至要几分钟。
什么时候用哪个
工程判断:
| 场景 | 选择 | 原因 |
|---|---|---|
| 期望长期保持 | 声明式 | 自动对抗漂移 |
| 一次性动作 | 命令式 | 不需要持续状态 |
| 初始化、清理 | 命令式 | 一步到位 |
| 平台级资源管理 | 声明式 | 自动恢复、可审计 |
K8s 内部本身也用声明式(RS/Deploy/Job 都是声明式对象);命令式 kubectl 命令(create/scale/expose)只是「便捷入口」,最终也翻译成声明式对象交给控制器。
声明式的幂等与审计
两个附加收益:
- 幂等:同一 YAML 反复 apply 结果不变。因为控制器从「现实」出发,不看「上次怎么做的」。这对 GitOps 至关重要:仓库状态 → 集群状态,重跑即收敛。
- 可审计:期望状态有记录(Git 仓库、last-applied、SSA 字段属主)。谁声明了什么、声明到什么版本,可追溯。命令式脚本的执行历史则难以重建「期望」本身。
从编排脚本到声明式:命令式为什么撑不住规模
K8s 之前,服务编排是脚本与配置管理工具(Ansible/Chef/Puppet)的天下。它们的模式是命令式的:
run: 更新代码 → 重启服务 → 检查健康 → 失败则回滚
这个模式在小规模可行,规模一上来就崩:
| 问题 | 表现 |
|---|---|
| 状态漂移 | 脚本只在运行时纠偏,平时不盯 |
| 故障响应 | 依赖人重跑脚本,或 cron 定时跑 |
| 并发 | 多节点并行执行,顺序与失败不可控 |
| 审计 | 脚本执行历史 ≠ 期望状态 |
声明式把这些职责转移给系统:控制器持续纠偏、自动重试、并发安全(幂等)、期望可审计。这不是「声明式比命令式高级」,而是「分布式规模下命令式的运维成本失控,声明式把成本摊销进控制器」。
工程上,K8s 对命令式并非排斥——kubectl run、kubectl create 仍是命令式入口,但它们最终生成声明式对象(Deployment/RS),把「一次动作」翻译成「持续期望」。声明式不是取代命令式,而是命令式操作的「持久化形态」。
声明式在 K8s 之外的投影
声明式「期望 + 控制器」的模式不止在 K8s:
- Terraform:
main.tf是声明式期望,terraform apply是收敛循环(对比现实、生成计划、执行差异)。 - DNS 系统:权威区文件是声明式,slave 从 master 拉取并传播是收敛。
- GitOps:Git 仓库是唯一期望源,控制器(Argo CD/Flux)把集群状态拉向仓库。
这些系统共享同一结构:声明(desired)→ 观察(current)→ 差异(diff)→ 收敛(apply)。K8s 控制器的价值是把这个结构做成了通用平台——任何资源都能配一个控制器,享受声明式的恢复与幂等。这也是卷二第 13 章「自定义控制器」的基础:CRD + controller 就是「用户自定义的声明式平台」。
对照一张表收束:
| 系统 | 期望来源 | 控制器 | 收敛动作 |
|---|---|---|---|
| K8s | spec | 控制器 | 读-算-写 |
| Terraform | main.tf | apply | 计划-执行 |
| GitOps | Git 仓库 | Argo/Flux | 拉齐集群 |
三者的共同点是「期望不在运行时求值,而是独立于实现持续存在」。这正是声明式思想的本质:把「要什么」从「怎么做」中剥离,让系统负责持续达成。
三个常见误解
- 「声明式 = YAML 格式」——错误。声明式的核心是「期望 + 控制器」的执行模型,YAML 只是载体。没有控制器的声明仍是命令式的一次性。
- 「声明式必然比命令式好」——错误。它有行为不透明、收敛慢的代价;一次性/初始化场景命令式更直接。
- 「幂等来自 YAML」——错误。幂等来自「控制器从现实出发重算」,不是 YAML 本身。SSA 甚至能在冲突时显式报错而不是静默覆盖。
声明式的调试工具箱:diff、status、events
声明式「行为不透明」的代价,用三个工具对冲:
| 工具 | 回答的问题 |
|---|---|
kubectl diff | 我声明的与集群现实的差异在哪 |
kubectl describe / events | 控制器最近在做什么 |
| status 字段 | 控制器自报的进度(observedGeneration、readyReplicas) |
调试声明式系统的正确姿势:不猜「为什么」,先看「现状 vs 期望」的差异,再看 status 自报,最后看 events。三者对应负反馈的三角:
- diff → 期望与现实的差异(误差)。
- status → 控制器看到的现实(测量)。
- events → 控制器动作的历史(执行)。
命令式调试是「重跑看输出」;声明式调试是「读状态看差异」。这也是声明式系统的隐藏优势:它的状态是可读的、可审计的——误差、测量、执行都被记录为对象与事件,而不是藏在脚本日志里。
声明式的边界:不是所有问题都能声明
声明式适合「可描述的目标状态」,不适合所有操作:
| 适合 | 不适合 |
|---|---|
| 资源数量、版本、配置 | 一次性的数据迁移 |
| 持续保持的状态 | 有顺序依赖的编排 |
| 可收敛的目标 | 无终止条件的任务 |
判断标准:你的「期望」能被写成稳定的对象吗? 能,就声明式;不能(需要过程控制),命令式仍是对的工具。K8s 里 Job 是「声明式的一次性任务」,编排流水线则往往需要显式的 DAG 与条件——声明式不解决一切,它解决「持续保持」这一类问题。
本节 lab
本节验证声明式的幂等恢复:控制器反复调谐,收敛后不产生额外动作(幂等),漂移后自动追回:
cd private/labs/k8s-ctrl-lab
go test ./controller -run 'TestReconcileIdempotent' -v
TestReconcileIdempotent:RS 已收敛后再次 Reconcile 返回零动作(幂等);重复调谐不改变结果。这正是声明式「重跑即收敛」的存储验证——同样的现实输入,永远产生同样的输出。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。