架构与系统设计 / 系统课时
用etcd验证租约与选主行为
用etcd验证租约与选主行为
本篇用本地 etcd 实际观察“租约仍活着、续租中断、领导权转移”三种状态。完成后,你能把抽象的共识与故障检测,映射成键是否存活、会话是否续租,以及哪个节点取得应用级领导权。
学习目标
- 用
etcdctl创建租约并验证续租停止后的键过期行为。 - 用 etcd 的分布式锁观察单领导者与故障后的接管过程。
- 区分 etcd 集群内部的 Raft Leader 与业务系统自己的应用级 Leader。
准备可验证的 etcd 环境
以下操作假设本机已有可访问的 etcd,并安装了与服务端兼容的 etcdctl。默认端点为 http://127.0.0.1:2379;若你的环境不同,把它替换为实际地址。
先用一个脚本同时验证端点、租约和续租。租约 TTL 设为 5 秒,后台 keep-alive 会不断刷新它;停止 keep-alive 后,绑定键应在 TTL 窗口后自动消失。
set -e
export ETCDCTL_ENDPOINTS="http://127.0.0.1:2379"
etcdctl endpoint health >/dev/null
echo "endpoint=healthy"
LEASE_ID=$(etcdctl lease grant 5 | awk '{print $2}')
etcdctl put /demo/lease-probe alive --lease="$LEASE_ID" >/dev/null
etcdctl lease keep-alive "$LEASE_ID" >/tmp/etcd-keepalive.log 2>&1 &
KEEP_PID=$!
sleep 6
echo "during=$(etcdctl get /demo/lease-probe --print-value-only)"
kill "$KEEP_PID" 2>/dev/null || true
sleep 7
VALUE=$(etcdctl get /demo/lease-probe --print-value-only)
if [ -z "$VALUE" ]; then
echo "after=expired"
else
echo "after=$VALUE"
fi预期输出
endpoint=healthy
during=alive
after=expired如果最终仍是 after=alive,先检查 keep-alive 进程是否真的停止,再用 etcdctl lease timetolive <ID> 查看剩余 TTL。<ID> 是运行时生成的租约 ID,实际值每次不同。
从租约过期理解故障检测
租约不是“节点永久拥有某个身份”,而是一段需要持续证明存活的时间窗口。客户端定期续租,相当于告诉 etcd“我还活着”;续租停止后,服务端等 TTL 到期并删除绑定到该租约的键。

这正是工程上常见的失效检测语义:系统不是瞬间知道节点“死了”,而是在一段时间内收不到续租后,把它视为失去资格。因此 TTL 越短,接管更快,但对网络抖动越敏感;TTL 越长,误判更少,但故障转移更慢。
用分布式锁观察应用级选主
etcd 的锁建立在会话与租约之上,可以用来直观看“只有一个节点持有领导权,失效后另一个节点接管”。下面是片段示例,需要在两个终端分别运行;两边都沿用前面的 ETCDCTL_ENDPOINTS。
# 终端 A
etcdctl lock /demo/app-leader sh -c 'echo "node-a=leader"; sleep 300'
# 终端 B
etcdctl lock /demo/app-leader sh -c 'echo "node-b=leader"; sleep 300'预期输出先出现在终端 A:
node-a=leader终端 B 会等待,不会同时成为领导者。此时终止终端 A 中的命令,待 A 的会话释放或租约失效后,终端 B 获得锁并输出:
node-b=leader这个实验验证的是应用级 Leader:多个业务节点竞争同一协调资源。它不同于 etcd 服务端自身通过 Raft 选出的集群 Leader;前者用于“谁执行任务”,后者用于“etcd 集群内部谁负责一致性复制中的领导职责”。
把实验现象映射到生产设计
生产系统不要把“拿到领导权”理解成无限期授权。真正可靠的实现必须让领导权绑定租约或会话,并让写操作具备防止旧 Leader 继续写入的机制,例如结合版本号、revision 或 fencing token 做二次校验。
因此,租约负责把“持续存活”转成可观察的过期条件,协调原语负责把多个候选者收敛为一个当前持有者,而底层 Raft 共识负责保证这些状态变化在 etcd 集群中以一致顺序被确认。