罗罗编程学习记录
本页内容 展开查看

08.3.1.3 租约与 Watch 机制

所属:全栈开发面试题库 / 08 云原生与 DevOps / 08.3 etcd / 08.3.1 etcd

命令前提:本机是否安装 etcdctl 未验证;接口语义以官方文档为准,命令形式随版本可能调整。

08.3.1.3-001 lease(租约)是什么,解决什么问题?

一句话结论

lease 是带 TTL 的存活凭证,绑定到 key 上;到期未续租则关联 key 被自动删除,常用于服务注册、心跳与会话过期回收。

概念解释

  • TTL:租约有效时长。
  • 绑定:key 关联 lease。
  • 过期:自动回收关联 key。

原理流程

  1. 申请带 TTL 的 lease。
  2. put key 时绑定该 lease。
  3. 客户端续租保活;过期未续则删除 key。

代码 / 图示

Grant lease(TTL) → Put(key, value, lease=ID) → 周期续租
TTL 到期未续 → 删除绑定 key

常见误区

  • 误区:lease 是给 key 加访问权限;正解:它是存活与过期回收机制,不是权限控制。
  • 误区:key 永久有效也需要 lease;正解:不需要自动过期的 key 直接 put,不绑定租约。

追问

  • Q:lease 典型 K8s 用途? A:组件身份/租约协调等场景,具体对象以 K8s 机制为准。
  • Q:一个 lease 能绑多个 key 吗? A:可以,同一租约关联多个 key,过期一并回收(以官方语义为准)。

08.3.1.3-002 key 如何绑定 lease?

一句话结论

写入 key 时在请求中带上 lease ID,该 key 即归属此租约;租约过期或被撤销时绑定的 key 被删除。

概念解释

  • lease ID:申请租约返回的标识。
  • 绑定关系:key → lease。
  • 级联删除:租约失效回收 key。

原理流程

  1. Grant 得到 lease ID。
  2. Put 时携带 lease ID。
  3. 租约失效时关联 key 被清理。

代码 / 示例

# 示意:申请租约后写入绑定租约的 key
etcdctl lease grant 30
etcdctl put /registry/lease-demo/key value --lease=<lease-ID>

常见误区

  • 误区:先 put 再事后补绑租约;正解:绑定在写入时指定,后续变更方式以 API 能力为准。
  • 误区:删除 key 会自动释放 lease;正解:key 被删后租约仍可能存在,需 revoke 或等 TTL。

追问

  • Q:租约解绑后 key 还在吗? A:租约与 key 的绑定语义以官方文档为准;删除 key 不等同撤销租约。
  • Q:绑定租约的 key 被覆盖写入要注意什么? A:覆盖时需确认租约绑定是否保留,避免续租关系丢失。

08.3.1.3-003 续租(keepalive)如何工作?

一句话结论

客户端周期性向 etcd 发送 keepalive 刷新租约 TTL;在 TTL 内持续续租则 key 保留,续租中断超过 TTL 租约过期。

概念解释

  • 周期:续租间隔小于 TTL。
  • 刷新:重置到期计时。
  • 中断:网络/进程故障导致未续。

原理流程

  1. 申请租约记录 TTL。
  2. 客户端后台周期 keepalive。
  3. 成功刷新到期时间;失败累计到 TTL 过期。

代码 / 图示

TTL=30s → 每 ~10s keepalive → 到期时间顺延
keepalive 中断 > TTL → 租约过期 → key 删除

常见误区

  • 误区:续租间隔等于 TTL 才稳妥;正解:续租间隔应明显小于 TTL,留出网络抖动余量。
  • 误区:续租失败立即删 key;正解:需超过 TTL 未成功续租才过期回收。

追问

  • Q:客户端重启后租约还在吗? A:进程中断后无人续租,TTL 到期自动回收;新进程需重新申请租约写 key。
  • Q:如何查看租约剩余时间? A:lease 相关查询命令可查 TTL 与绑定 key,具体子命令以版本为准。

08.3.1.3-004 租约过期自动删除是怎么触发的?

一句话结论

etcd 跟踪每个 lease 的到期时间,到期后回收绑定的 key;删除事件同样产生 revision,可被 watch 到。

概念解释

  • 到期判定:TTL 超时未续。
  • 回收:删除关联 key。
  • 事件:删除写入 MVCC 历史。

原理流程

  1. 租约计时到期。
  2. 服务端删除绑定 key。
  3. 产生 delete 事件与新 revision。

代码 / 图示

lease 到期 → 回收绑定 key → delete 事件 → watch 订阅者收到

常见误区

  • 误区:过期 key 是被外部脚本清理;正解:由 etcd 租约机制内部回收。
  • 误区:过期删除不产生历史版本;正解:删除作为 tombstone 进入 MVCC 历史。

追问

  • Q:租约过期和手动 revoke 区别? A:过期是 TTL 自然到期,revoke 是主动撤销,都回收绑定 key。
  • Q:回收失败会怎样? A:属于服务端异常场景,需观察 etcd 健康与日志(见 08.3.1.4)。

08.3.1.3-005 续租中断或集群中断时租约会怎样?

一句话结论

客户端与集群断连期间无法续租,超过 TTL 租约过期、绑定 key 被删;恢复后需重新申请租约并写入 key,不能假设原 key 还在。

概念解释

  • 断连:keepalive 失败。
  • TTL 窗口:断连超过时长即过期。
  • 重建:恢复后重新注册。

原理流程

  1. 网络/进程中断,续租停止。
  2. TTL 到期回收 key。
  3. 客户端恢复后重新 grant + put。

代码 / 图示

断连 → 续租停止 → TTL 到期 → key 被删
恢复 → 重新 grant lease → 重新 put key

常见误区

  • 误区:网络闪断后原租约自动保留;正解:超过 TTL 即过期,恢复后需重建。
  • 误区:TTL 设得越长越安全;正解:过长会延迟故障节点摘除,需在摘除及时性与抖动余量间权衡。

追问

  • Q:服务注册摘流太慢与 TTL 什么关系? A:TTL 越长,故障实例被回收越晚,心跳摘除滞后。
  • Q:续租重试策略怎么设计? A:按 TTL 留出退避重试窗口,避免网络抖动直接误判过期。

08.3.1.3-006 lease 如何支撑服务注册与心跳?

一句话结论

实例启动时写带租约的注册 key 并周期续租,实例宕机后租约过期自动摘除注册信息;消费者 watch 注册前缀感知上下线。

概念解释

  • 注册 key:实例地址元数据。
  • 心跳:keepalive 保活。
  • 摘除:过期自动清理。

原理流程

  1. 实例启动申请租约写注册 key。
  2. 周期续租。
  3. 宕机过期删 key;消费者 watch 到下线事件。

代码 / 图示

实例上线:grant lease → put /registry/<svc>/<instance> → keepalive
实例宕机:TTL 过期 → 删 key → watch 通知消费者摘除

常见误区

  • 误区:注册信息靠定时脚本清理;正解:lease 过期自动回收,无需外部清扫。
  • 误区:实例优雅退出时租约会立刻释放;正解:可主动 revoke 加快摘除,否则等 TTL 到期。

追问

  • Q:K8s 里组件选主也用类似机制吗? A:租约/锁机制用于协调竞争与保活,具体实现以对应组件为准。
  • Q:注册 key 里存什么? A:实例地址、端口、元数据;不存大体积业务数据。

08.3.1.3-007 watch 的基本语义是什么?

一句话结论

watch 订阅 key 或前缀的变化事件(put/delete),订阅后持续接收后续变更;客户端与服务端保持流式连接推送事件。

概念解释

  • 订阅范围:单 key 或前缀。
  • 事件:变更类型与新值。
  • 流式:连接保持持续推送。

原理流程

  1. 客户端发起 watch 请求(可选起始 revision)。
  2. 服务端匹配变更产生事件。
  3. 事件推送到客户端。

代码 / 示例

# 示意:监听前缀变更,具体参数以 etcdctl 版本为准
etcdctl watch /registry/

常见误区

  • 误区:watch 是轮询拉取;正解:基于长连接事件推送,变更发生即通知。
  • 误区:watch 只返回最新值;正解:返回事件序列(类型、revision、值),历史回放需指定起始 revision。

追问

  • Q:watch 连接断了怎么办? A:客户端重连并按上次 revision 续接(见 08.3.1.3-014)。
  • Q:事件顺序如何保证? A:按 revision 顺序推送,与 Raft 提交顺序一致。

08.3.1.3-008 watch 如何按前缀或范围订阅?

一句话结论

可订阅单 key、key 前缀(range prefix)或区间范围;前缀订阅匹配所有以该前缀开头的 key,是 K8s 按资源类型监听的常用方式。

概念解释

  • 单 key:精确匹配。
  • 前缀:通配开头部分。
  • 区间:[start, end) 范围。

原理流程

  1. 订阅时指定 key 或范围参数。
  2. 服务端匹配变更 key 是否在范围。
  3. 命中则推送事件。

代码 / 图示

前缀 /registry/pods/ → 匹配该目录下所有 Pod 对象
区间 [a, z)         → 按字典序范围匹配

常见误区

  • 误区:前缀 watch 会跨出目录层级;正解:按 key 前缀字符串匹配,层级由 key 路径约定。
  • 误区:范围订阅返回范围内全量存量数据;正解:watch 默认推后续事件,存量需先 list 再 watch。

追问

  • Q:K8s 怎么按资源类型监听? A:按对象 key 前缀订阅对应类型,结合 label/字段在客户端过滤。
  • Q:前缀过宽有什么风险? A:匹配事件量大,增加服务端推送与客户端处理压力。

08.3.1.3-009 watch 事件有哪些类型?

一句话结论

主要事件类型为 put(新建或更新)与 delete(删除或过期回收);事件携带 key、value、revision 与类型,客户端据此区分新建/更新/下线。

概念解释

  • put:写入或覆盖。
  • delete:显式删除或租约过期。
  • 元数据:revision、修改类型。

原理流程

  1. 变更产生 MVCC 版本。
  2. 服务端生成对应事件。
  3. 推送给匹配的 watcher。

代码 / 对照

事件 触发 value 含义
put put/覆盖写 当前值
delete 显式删除/租约过期 无新值,记录删除

常见误区

  • 误区:put 事件能区分新建与首次更新;正解:需结合 revision 与客户端本地状态判断是新增还是更新。
  • 误区:delete 事件一定是主动删除;正解:也可能是 lease 过期回收。

追问

  • Q:压缩后事件还能回看吗? A:早于 compact revision 的历史不可回看(见 08.3.1.3-012)。
  • Q:事件 value 为空怎么解读? A:结合事件类型判断是删除还是空值写入,不要一概当作异常。

08.3.1.3-010 如何从指定 revision 开始 watch 历史?

一句话结论

watch 可带起始 revision,从该版本之后开始接收事件;用于重连后续接漏看事件,前提是该 revision 历史尚未被 compact 回收。

概念解释

  • 起始 revision:续接点。
  • 历史窗口:未压缩范围内可回放。
  • 断连补偿:重连时补齐缺口。

原理流程

  1. 客户端记录已处理 revision。
  2. 重连时从该 revision 之后 watch。
  3. 服务端在保留历史内补发缺口事件。

代码 / 图示

已处理 rev=100 → 重连 watch(from rev=100) → 补发 101...N 事件
rev 早于 compact → 历史不可得,需全量 list 重建

常见误区

  • 误区:任意旧 revision 都能续接;正解:早于 compact 的历史已回收,无法回放。
  • 误区:watch 起始会先返回全量存量;正解:存量数据需先 list,watch 从指定 revision 续事件。

追问

  • Q:续接点被压缩了怎么办? A:放弃增量续接,重新 list 全量状态建立本地视图。
  • Q:K8s 控制器如何处理历史压缩? A:apiserver/客户端按 list-watch 机制重建本地状态,具体实现以 K8s 文档为准。

08.3.1.3-011 watch 事件积压会发生什么?

一句话结论

变更速度超过 watcher 消费能力时事件在服务端队列积压,积压超限可能导致 watcher 被断开;客户端需及时消费并处理背压。

概念解释

  • 积压:事件产出快于消费。
  • 队列:服务端为 watcher 缓冲。
  • 断开:积压超限强制中断。

原理流程

  1. 大量变更产生事件。
  2. watcher 处理慢,队列增长。
  3. 超过缓冲上限 → watch 断开 → 客户端重接连增量/重建。

代码 / 图示

事件速率 > 消费速率 → 队列积压 → 超限断开 → 重连/list 重建

常见误区

  • 误区:watch 事件可以无限缓冲;正解:缓冲有上限,积压会被断开。
  • 误区:客户端慢慢消费不影响服务端;正解:慢消费占用服务端 watcher 资源,影响整体稳定性。

追问

  • Q:如何降低积压风险? A:缩小订阅范围、及时消费事件、避免在事件回调里做阻塞重活。
  • Q:断开后如何恢复? A:按 revision 续接;历史已压缩则全量 list 重建本地状态。

08.3.1.3-012 compact 对 watch 历史有什么影响?

一句话结论

compact 回收早于阈值 revision 的历史版本,基于这些旧 revision 的 watch 续接与历史读不再可用;客户端必须在历史窗口内续接,否则全量重建。

概念解释

  • 回收:旧版本与 tombstone 清理。
  • 续接窗口:compact revision 之后。
  • 重建:超窗口后 list 全量。

原理流程

  1. 周期 compact 设定历史下限。
  2. 早于下限的版本回收。
  3. 旧 revision watch 请求报错,触发重建流程。

代码 / 图示

compact rev=5000 → rev <5000 历史回收
watcher 持 rev=4000 续接 → 不可用 → list 全量重建

常见误区

  • 误区:watch 连接一直保持就不怕压缩;正解:长连接断连后续接才受历史窗口约束。
  • 误区:compact 会删除当前值;正解:只回收历史版本,当前最新值保留。

追问

  • Q:如何确定历史保留窗口? A:按重连恢复时长与 compact 策略评估,避免正常断连窗口内历史被清。
  • Q:K8s 组件怎么应对压缩? A:通过 list-watch 重建本地缓存,apiserver 侧机制以 K8s 文档为准。

08.3.1.3-013 K8s 的 list-watch 与 etcd watch 是什么关系?

一句话结论

K8s 控制器先 list 全量对象建立本地缓存,再 watch apiserver 后续变更;apiserver 底层通过 etcd watch 感知集群状态,list-watch 是 K8s 事件驱动的基础。

概念解释

  • list:一次性拉取存量。
  • watch:增量事件订阅。
  • 链路:控制器 → apiserver → etcd。

原理流程

  1. 控制器启动 list 全量对象。
  2. watch apiserver 增量变更。
  3. apiserver 基于 etcd watch 同步状态并下发事件。

代码 / 图示

Controller → list/watch → apiserver → watch → etcd
存量 list + 增量 watch = 本地期望状态视图

常见误区

  • 误区:控制器直接 watch etcd;正解:控制器面向 apiserver,etcd watch 在 apiserver 侧使用。
  • 误区:只 watch 不需要 list;正解:watch 只给后续事件,启动时存量必须先 list。

追问

  • Q:为什么 K8s 选 watch 而不是轮询 etcd? A:事件驱动延迟低、开销小,避免高频全量拉取。
  • Q:apiserver 缓存与 etcd 关系? A:apiserver 缓存服务读请求,持久状态在 etcd,一致性口径以 K8s 文档为准。

08.3.1.3-014 watch 断连重连如何续接事件?

一句话结论

客户端记录最后处理的 revision,重连时从该 revision 后续接;若续接点仍在历史窗口内补齐缺口事件,已被压缩则全量 list 重建。

概念解释

  • 断点:已处理 revision。
  • 续接:增量补齐。
  • 重建:超窗口全量同步。

原理流程

  1. 本地记录最新已处理 revision。
  2. 断连后重连带 revision 请求 watch。
  3. 窗口内补发;超窗口报错后 list 重建。

代码 / 图示

断连前 rev=R
重连 watch(R) → 窗口内:补发 R 之后事件
              → 超压缩:list 全量重建视图

常见误区

  • 误区:重连后从头 watch 最安全;正解:从头会重复收到历史事件,需按 revision 去重/续接。
  • 误区:断连期间变更丢失了;正解:只要历史未压缩,续接可补齐缺口。

追问

  • Q:如何避免重复处理事件? A:按 revision/资源版本做幂等处理,重复事件不产生副作用。
  • Q:重连风暴怎么缓解? A:指数退避重连,避免大量客户端同时冲击服务端。

08.3.1.3-015 大量 watcher 对 etcd 有什么性能影响?

一句话结论

每个 watcher 占用服务端连接与事件推送资源,海量订阅或宽前缀监听会放大事件匹配与推送开销,需控制订阅范围与连接规模。

概念解释

  • 连接:长连接资源。
  • 匹配:事件需匹配各 watcher 范围。
  • 推送:变更扇出到订阅者。

原理流程

  1. 变更产生事件。
  2. 服务端匹配所有相关 watcher。
  3. 逐个推送,连接与队列占用资源。

代码 / 图示

一次写事件 → 匹配 N 个 watcher → 扇出推送
watcher 越多/前缀越宽 → 匹配与推送开销越大

常见误区

  • 误区:watch 是被动接收,不占服务端资源;正解:长连接、事件队列与匹配都占用 etcd 资源。
  • 误区:宽前缀一次订阅最省事;正解:宽范围带来大量无关事件,增加双方压力。

追问

  • Q:K8s 中 watcher 数量受什么影响? A:组件数量、控制器订阅范围与 apiserver 连接模型,具体以集群规模评估为准。
  • Q:如何降低 watch 压力? A:收窄监听范围、在客户端过滤、避免高频无意义变更。

08.3.1.3-016 watch 事件与 MVCC revision 怎么对应?

一句话结论

每个事件对应一个产生变更的 revision,事件按 revision 顺序排列;客户端可用 revision 判断事件先后与去重,revision 也是历史读与续接的定位点。

概念解释

  • revision:事件全局序号。
  • 顺序:与提交顺序一致。
  • 定位:续接/历史读的依据。

原理流程

  1. 提交写产生新 revision 与事件。
  2. watch 事件携带 revision。
  3. 客户端按 revision 排序与去重。

代码 / 图示

rev 101 put k1
rev 102 delete k2
事件顺序 = revision 顺序;客户端记录最大已处理 rev

常见误区

  • 误区:事件有独立于 revision 的序号;正解:事件定位依托全局 revision。
  • 误区:同一 revision 多个事件无序;正解:同批变更顺序按服务端规则排列,具体以官方语义为准。

追问

  • Q:如何判断事件是否已处理? A:对比本地记录的最大 revision 或资源版本信息。
  • Q:revision 回退会发生吗? A:全局 revision 单调递增,不回退。

08.3.1.3-017 主动 revoke 租约是什么行为?

一句话结论

revoke 主动撤销租约,立即回收其绑定的所有 key;用于实例主动下线、主动释放注册信息,比等 TTL 到期更快摘除。

概念解释

  • 主动撤销:不等 TTL。
  • 级联回收:绑定 key 一并删除。
  • 场景:优雅退出、主动注销。

原理流程

  1. 实例优雅退出前 revoke lease。
  2. 绑定 key 立即被删除。
  3. watch 推送下线事件。

代码 / 示例

# 示意:撤销指定租约,具体子命令以版本为准
etcdctl lease revoke <lease-ID>

常见误区

  • 误区:revoke 只删 key 不释放租约;正解:revoke 撤销租约本身并级联回收绑定 key。
  • 误区:进程崩溃也能执行 revoke;正解:异常宕机无法主动 revoke,只能等 TTL 过期回收。

追问

  • Q:优雅退出流程如何配合? A:先摘流,再 revoke 租约注销注册信息,最后退出进程。
  • Q:revoke 后租约 ID 还能复用吗? A:撤销后租约失效,重新申请新 ID。

08.3.1.3-018 watch/lease 常见故障现象有哪些?

一句话结论

常见现象:watch 反复断开重连、事件延迟推送、租约到期 key 被误删、续接 revision 已压缩报错;需从网络、历史压缩、TTL 与消费速度逐项排查。

概念解释

  • 断连:积压/网络/超时。
  • 误删:续租中断超 TTL。
  • 压缩:续接点超历史窗口。

原理流程

  1. 观察断连频率与事件延迟。
  2. 检查网络、watcher 积压与 compact 策略。
  3. 核对 TTL 与续租间隔、客户端重连逻辑。

代码 / 图示

watch 异常 → 断连频率/延迟 → 网络/积压/压缩窗口
租约误删 → 续租间隔/TTL/客户端进程/网络

常见误区

  • 误区:watch 推送延迟一定是 etcd 慢;正解:也可能是客户端消费慢、网络抖动或事件积压。
  • 误区:key 被删一定是业务主动删除;正解:可能是租约过期回收,需核对事件类型与租约状态。

追问

  • Q:如何判断是压缩导致续接失败? A:续接 revision 早于当前 compact revision,报错指向历史已回收。
  • Q:续租频繁失败先查什么? A:客户端进程健康、到 etcd 网络延迟与 TTL/续租间隔配置。