【ETCD】【实操篇（九）】如何在 Go 和 Java 中使用 ETCD 租约？详细代码示例解析

ETCD 是一个广泛使用的分布式键值存储系统，广泛应用于服务注册、配置管理、分布式锁等场景。ETCD 的 租约（Lease） 特性为我们提供了一种管理临时资源和自动过期机制的方案。本文将介绍 ETCD 租约的概念、应用场景以及如何通过 etcdctl、Go 客户端和 Java 客户端来创建和管理 ETCD 租约。

1. ETCD 租约概述

ETCD 的 租约 提供了一种机制，使客户端能够在一定时间内拥有对资源（如键值对）的“租用”权。每个租约都有一个到期时间，如果没有续约，相关的资源将自动失效或删除。

ETCD 租约的常见应用场景包括：

• 临时键：在一段时间内有效的键值对，过期后自动删除。
• 服务发现：服务注册时绑定租约，确保服务下线时能自动从服务注册表中移除。
• 分布式锁：通过租约机制实现分布式锁，确保在锁过期后自动释放。

2. ETCD 租约操作流程

ETCD 的租约机制包括以下步骤：

1. 创建租约并获得租约 ID。
2. 将租约 ID 绑定到某个键，确保该键在租约到期后自动删除。
3. 根据需要，定期续约租约。
4. 租约到期后，ETCD 会自动删除与租约关联的键值。

3. 使用 etcdctl 创建和管理租约

etcdctl 是 ETCD 提供的命令行工具，可以方便地创建、续约和撤销租约。以下是如何使用 etcdctl 来操作租约。

3.1 配置 ETCD 环境变量

首先，配置 ETCD 的地址和认证信息（如果有）：

export ETCDCTL_API=3  # 使用 ETCD v3 API
export ETCD_ENDPOINTS="http://127.0.0.1:2379"  # ETCD 集群地址

3.2 创建租约

通过 etcdctl 创建一个租约，并指定租期（例如：60秒）：

etcdctl lease grant 60

此命令返回一个租约 ID，例如：lease granted with ID 1234567890。

3.3 将键绑定到租约

将键与租约 ID 绑定，例如将键 /etcd/zhshl 与租约 1234567890 绑定：

etcdctl put /etcd/zhshl "value" --lease 1234567890

3.4 租约续约

如果需要续约租约，可以使用以下命令延长租期：

etcdctl lease keep-alive 1234567890

3.5 查看租约信息

查看租约的剩余有效时间：

etcdctl lease time-to-live 1234567890

3.6 撤销租约

如果不再需要租约，可以使用以下命令撤销租约：

etcdctl lease revoke 1234567890

---

4. 使用 Golang 客户端操作 ETCD 租约

在 Go 中操作 ETCD 租约也非常简单。以下是通过 Go 客户端创建和管理租约的示例。

4.1 安装 ETCD Go 客户端

使用 go get 命令安装 ETCD 的 Go 客户端：

go get go.etcd.io/etcd/v3

4.2 Go 代码示例

以下是一个简单的 Go 程序，展示如何创建租约、绑定键值并续约：

package main

import (
    "context"
    "fmt"
    "log"
    "go.etcd.io/etcd/v3/clientv3"
    "time"
)

func init() {
   
	// 初始化etcd客户端
	var err error
	cli, err = clientv3.New(clientv3.Config{
   
		Endpoints:   []string{
   "127.0.0.1:2379"