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 能写成功。
过期与接管
三种情况会让租约过期:
- holder 崩溃:进程停止续约,租约在 leaseDuration 后过期。
- holder 网络隔离:无法访问 apiserver,同样无法续约。
- 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
过期判定依赖观察者,不依赖存储层。两个含义:
- 没有观察者就没有故障转移:如果所有候选者都停了(或网络全断),租约过期也无济于事——接管需要有人来写。
- 时钟漂移的影响:候选者用自己的时钟判过期。若候选者时钟快,它可能「提前」判定过期并接管一个还在续约的 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 实例 | 15s | 2s | 备用接管 |
| 节点心跳 | kubelet | 40s | 10s | 节点 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-system | controller-manager 的 SA |
| 节点心跳 | kube-node-lease | kubelet 的凭据 |
| 自研选主 | 自选 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 始终无法接管——「按时续约则不被夺权」。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。