《Kubernetes 分布式系统原理深入解析》4.1 Lease 资源与续约

K8s 用 coordination.k8s.io 的 Lease 资源实现选主与心跳:Lease 记录 holder、acquireTime、renewTime 与 leaseDurationSeconds。候选人续约是在租期内刷新 renewTime,过期意味着 holder 失联,可被接管。本节拆解 Lease 对象的字段、续约协议与过期判定。lab 用 leaderelection/le.go 验证续约保活与过期接管。

4.1 Lease 资源与续约

选主(Leader Election)是 K8s 控制面「单活组件」的核心机制。它的载体是一个很简单的资源:Lease。本节拆解 Lease 对象本身:字段语义、续约协议、过期判定——这是理解控制器高可用的地基。

Lease 是什么

coordination.k8s.io/v1 的 Lease 是一个普通对象,活在集群里:

apiVersion: coordination.k8s.io/v1
kind: Lease
metadata:
  name: kube-controller-manager
  namespace: kube-system
spec:
  holderIdentity: "host-1_abc123"
  leaseDurationSeconds: 15
  acquireTime: "2026-11-12T09:00:00Z"
  renewTime: "2026-11-12T09:05:00Z"
  leaseTransitions: 3

它不携带业务数据,只描述一件事:谁(holderIdentity)在多久内(leaseDurationSeconds)需要证明自己活着(renewTime)。

四个关键字段

字段含义谁写
holderIdentity当前持锁者胜出者
leaseDurationSeconds租约时长候选人协商
acquireTime拿到锁的时刻胜出者
renewTime最后一次续约时刻持锁者
leaseTransitions易手次数新 holder

判定的核心只有一条:now 超过 renewTime + leaseDurationSeconds 时,租约过期。

续约协议

候选者拿到锁后,进入续约循环:

每 renewInterval(如 2s):
  持锁者 → 把 renewTime 更新为 now
  非持锁者 → 尝试夺取(检查租约是否过期)

续约的意义:用「定期刷新 renewTime」向其他候选者证明「我还活着」。只要 holder 在租期内续约,租约就不过期,别人无法接管。

续约用的是 apiserver 的 Update(带 RV 乐观锁)。两个持锁者不会同时续约同一个 Lease——RV 冲突保证同一时刻只有一个 holder 能写成功。

过期与接管

三种情况会让租约过期:

  1. holder 崩溃:进程停止续约,租约在 leaseDuration 后过期。
  2. holder 网络隔离:无法访问 apiserver,同样无法续约。
  3. holder 被调度杀死:Pod 消失,续约停止。

过期后,任何一个候选者都能接管:写 holderIdentity=self、acquireTime=now、renewTime=now,并递增 leaseTransitions。接管是「抢占式」的——不需要旧 holder 同意。

为什么用「租约」而不是「互斥锁」

分布式锁通常需要锁服务(如 ZooKeeper、etcd 的锁 API)。K8s 选租约的理由:

  • Lease 本身就是资源:它就是 etcd 里的一个对象,无需额外锁服务。选主 = 争抢写一个普通对象。
  • 天然支持故障检测:租约过期 = 自动释放,不需要「释放锁」的显式调用(崩溃时调用不了)。
  • 与心跳合一:kubelet 对节点的保活、controller-manager 的选主,共用同一种 Lease 机制。

租约的分布式语义:锁的持有是有期限的,到期自动失效。这避免了「持锁者崩溃后锁永久卡住」的经典问题——是分布式系统里「超时即放弃」原则的直接体现。

续约周期与租期的权衡

  • 租期太短(如 2s):holder 抖动时频繁易手(flapping),控制器反复重建状态。
  • 租期太长(如 60s):holder 真挂了,备用要等很久才接管,故障恢复慢。
  • 工程折中:leaseDuration 15s、续约 2s(控制器);节点 Lease 40s、续约 10s(kubelet)。

判定原则:租期要远大于续约间隔(保证正常续约不会过期),又要足够短(保证故障能快速暴露)。典型 5~10 倍的关系。

Lease 在 etcd 里没有「定时器」

一个重要认知:Lease 的过期不是 etcd 或 apiserver 的定时器。没有任何组件「盯着租约看它到没到期」。过期是一种「被动判定」:

  • Lease 只是 etcd 里的一个对象,存着 renewTime。
  • 其他候选者读取它,用本地时钟算 renewTime + duration < now 才判定过期。
  • 若没有候选者来读,租约「过期」了也没有任何动作——直到有人来接管。

所以租约机制的正确读法是:

过期 = 候选者观察到「renewTime + duration < now」
接管 = 观察到过期后,写 holderIdentity=self

过期判定依赖观察者,不依赖存储层。两个含义:

  1. 没有观察者就没有故障转移:如果所有候选者都停了(或网络全断),租约过期也无济于事——接管需要有人来写。
  2. 时钟漂移的影响:候选者用自己的时钟判过期。若候选者时钟快,它可能「提前」判定过期并接管一个还在续约的 holder——这正是 4.2 节「双主窗口极小但非零」的来源。

kubelet 的节点心跳:Lease 的另一个用例

Lease 不只用于控制面选主。kubelet 对节点的保活也用 Lease(kube-node-lease 命名空间):

  • kubelet 每 10s 续约一次节点 Lease(租期 40s)。
  • kubectl get node 的 Ready 状态依赖这个 Lease 是否新鲜。
  • 节点失联超过 40s → 节点 Lease 过期 → 节点被标记 NotReady → 控制器把 Pod 疏散到别处。

同一个 Lease 资源、同一套过期判定,服务两种场景:控制面选主(谁动作)与节点心跳(谁活着)。租约是 K8s 的通用「存活证明」原语,这也是它被单独设计成一个 API 资源(coordination.k8s.io)的原因。对比两个用例:

场景holder租期续约间隔过期后果
控制面选主cm 实例15s2s备用接管
节点心跳kubelet40s10s节点 NotReady

两套参数的比例都是 5~7 倍:续约间隔远小于租期,保证「正常续约不会过期、故障能在租期内暴露」——4.1 节的权衡原则在两类用例里都成立。

三个常见误解

  • 「Lease 是锁服务」——错误。Lease 只是 etcd 里的普通对象,选主逻辑在 client 库(controller-manager 里)实现,对象本身无逻辑。
  • 「续约失败 = 立刻失去领导权」——错误。失去领导权发生在租约过期(renewTime+duration),续约只是刷新它;一次续约失败不代表过期。
  • 「holder 崩溃后锁自动释放」——正确但要说清机制:不是「释放」,是「过期」。崩溃进程没法释放,靠租约到期让别人接管。

候选者如何观察租约:读路径与争抢

选主的读路径很简单:候选者周期 GET 同一个 Lease。观察行为有两种:

观察行为数据决策
只读(Renew 自己)renewTime、holder确认「我还是 holder」
读+写(TryAcquire)过期判定决定是否接管

一个细节:候选者读 Lease 也用 informer 缓存吗?通常选主库直连 apiserver GET(不走 informer),因为选主是低频操作(每 2s 一次),且它必须读到「最新」的租约状态——缓存滞后会让过期判定偏差。这是「选主这类关键判定直读 apiserver,控制器日常调谐读缓存」的分工(呼应 3.3 节的一致性边界)。

另外:TryAcquire 的写带乐观锁(RV)。两个候选者同时判定「过期」并同时接管,只有一个人写成功——另一个收到 409 后重新观察,发现 holder 已是别人,转入 standby。乐观锁在这里又一次兜住了并发。这与卷二 2.2 节的机制完全相同,只是用在选主场景。

Lease 的命名空间与访问控制

Lease 对象放在哪个命名空间,决定了谁有权限碰它:

场景Lease 位置谁可写
控制面选主kube-systemcontroller-manager 的 SA
节点心跳kube-node-leasekubelet 的凭据
自研选主自选 namespace自定义 RBAC

选主依赖「只有竞争者是写者」——如果无关进程也能写 Lease,它可以随意抢主或清空 holder,破坏选主。所以 Lease 的 RBAC 是选主正确性的一部分:租约的写入权限必须只授予候选者。这也是为什么自定义控制器做选主时,要显式创建 RBAC 允许它对特定 Lease 的 get/update 操作。

本节 lab

本节验证续约保活与过期接管的核心语义:

cd private/labs/k8s-ctrl-lab
go test ./leaderelection -run 'TestAcquireThenExpire|TestRenewKeepsLeadership' -v
  • TestAcquireThenExpire:空租约被 a 夺取;租约有效期内 b 无法接管;a 超时未续约后 b 接管。
  • TestRenewKeepsLeadership:a 每 2s 续约(租期 10s),跑 50 周期,b 始终无法接管——「按时续约则不被夺权」。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图