etcd 笔记（03）— etcd 客户端使用（键值的增、删、改、查）、watch监测键、lease使用（创建租约、撤销租约、刷新租期、查询租期）

最新推荐文章于 2024-06-01 09:33:23 发布
最新推荐文章于 2024-06-01 09:33:23 发布
阅读量4k 收藏 5
点赞数 7
分类专栏： etcd
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/wohu1104/article/details/115831832
版权

1. etcd 客户端

etcdctl 是一个命令行客户端，便于我们进行服务测试或手动修改数据库内容，etcdctl 在两个不同的 etcd 版本（v2 和 v3）下的功能和使用方式也完全不同。

一般通过如下方式来指定使用 etcd 的版本：

export ETCDCTL_API=2
export ETCDCTL_API=3

在前面我们已经在 /tmp/etcd-download-test/ 安装了 etcd，那么就可以将当前的安装路径加到环境变量 PATH 中，如下：

vi ~/.bashrc

在最后加入

export PATH=$PATH:/tmp/etcd-download-test/

然后执行以下命令让其生效：

source ~/.bashrc

此时就可以直接输入 etcdctl 命令进行操作了，如下：

wohu@ubuntu-dev:~/tools$ etcdctl -h
NAME:
	etcdctl - A simple command line client for etcd3.

USAGE:
	etcdctl [flags]

VERSION:
	3.4.15

API VERSION:
	3.4

支持的 COMMANDS 见下图：
commands

支持的 OPTIONS 见下图：
options

etcdctl 支持的命令大体上分为数据库操作和非数据库操作两类。

  • 数据库操作基本围绕着对键值和目录的 CRUD 操作（即增删改查）；
  • 非数据库操作如用户、角色、授权、认证相关；

etcd 在键的组织上采用了类似文件系统中目录的概念，即层次化的空间结构，我们指定的键可以作为键名，实际上，此时键值对放于根目录 / 下面。

我们也可以为键的存储指定目录结构，如 /cluster/node/key，如果不存在 /cluster/node 目录，则 etcd Server 将会创建相应的目录结构。

2 键值对操作

键操作包括最常用的增删改查操作，包括 PUT、GET、DELETE 等命令。

  • PUT 设置或者更新某个键的值
wohu@ubuntu-dev:~/tools$ etcdctl put /home/wohu/key1 "hello world1"
OK
wohu@ubuntu-dev:~/tools$ etcdctl put /home/wohu/key2 "hello world2"
OK
wohu@ubuntu-dev:~/tools$ etcdctl put /home/wohu/key3 "hello world3"
OK
wohu@ubuntu-dev:~/tools$
  • GET 获取指定键的值
wohu@ubuntu-dev:~/tools$ etcdctl get /home/wohu/key3 
/home/wohu/key3
hello world3
wohu@ubuntu-dev:~/tools$

加上 --print-value-only 可以读取对应的值。

wohu@ubuntu-dev:~/tools$ etcdctl get /home/wohu/key3  --print-value-only
hello world3
wohu@ubuntu-dev:~/tools$

GET 通过选项 --hex 获取指定键的对应值的 16 进制格式

wohu@ubuntu-dev:~/tools$ etcdctl get /home/wohu/key3 --hex
\x2f\x68\x6f\x6d\x65\x2f\x77\x6f\x68\x75\x2f\x6b\x65\x79\x33
\x68\x65\x6c\x6c\x6f\x20\x77\x6f\x72\x6c\x64\x33
wohu@ubuntu-dev:~/tools$

十六进制在 etcd 中有多处使用，如租约 ID 也是十六进制。

  • GET 指定键范围内的值
wohu@ubuntu-dev:~/tools$ etcdctl get /home/wohu/key1 /home/wohu/key3
/home/wohu/key1
hello world1
/home/wohu/key2
hello world2
wohu@ubuntu-dev:~/tools$

上述操作获取了大于等于 /home/wohu/key1，且小于 /home/wohu/key3 的键值对。key3 不在范围之内，因为范围是半开区间 [key1, key3)，不包含 key3 。

  • 通过 --prefix 获取指定键前缀的所有键值对
wohu@ubuntu-dev:~/tools$ etcdctl get /home/wohu/ --prefix
/home/wohu/key1
hello world1
/home/wohu/key2
hello world2
/home/wohu/key3
hello world3
wohu@ubuntu-dev:~/tools$

这样就能获取所有以 /home/wohu/ 开头的键值对，当前缀获取的结果过多时，还可以通过 --limit=N 限制获取的数量，其中 N 为指定的要返回的个数。

wohu@ubuntu-dev:~/tools$ etcdctl get /home/wohu/ --prefix --limit=2
/home/wohu/key1
hello world1
/home/wohu/key2
hello world2
wohu@ubuntu-dev:~/tools$
  • DELETE 删除一个键或者特定范围的键
  1. 删除单个键
wohu@ubuntu:~$ etcdctl get /home/wohu/key4
/home/wohu/key4
hello world4
wohu@ubuntu:~$ etcdctl del /home/wohu/key4
1
wohu@ubuntu:~$ etcdctl get /home/wohu/key4
wohu@ubuntu:~$
  1. 删除某一范围的键，删除键区间为 [key1 key3)，返回已经删除键的个数
wohu@ubuntu:~$ etcdctl del /home/wohu/key1 /home/wohu/key3
2
wohu@ubuntu:~$
  1. --prev-kv 删除键并返回该键的值
wohu@ubuntu:~$ etcdctl del /home/wohu/key1 --prev-kv 
1
/home/wohu/key1
hello world1
wohu@ubuntu:~$ etcdctl get /home/wohu/key1
wohu@ubuntu:~$
  1. --prefix 删除指定前缀的键
wohu@ubuntu:~$ etcdctl get /home/wohu/key --prefix
/home/wohu/key1
hello world1
/home/wohu/key2
hello world2
/home/wohu/key3
hello world3
wohu@ubuntu:~$ etcdctl del /home/wohu/key --prefix
3
wohu@ubuntu:~$ etcdctl get /home/wohu/key --prefix
wohu@ubuntu:~$

3 watch 对象

watch 监测一个键值的变化，一旦键值发生更新，就会输出最新的值并退出。

其中 watch 终端和 put 分别在不同的终端。

  1. 监听单个键
    图1

  2. 监听某个范围的键
    图2

etcd 保存修订版本以便应用客户端可以读取键的历史版本。但是，为了避免积累无限数量的历史数据，需要对历史的修订版本进行压缩 compact 。经过压缩，etcd 删除历史修订版本，释放存储空间，且在压缩修订版本之前的数据将不可访问。

4 lease 对象

lease 意为租约，类似于 Redis 中的 TTL(Time To Live)。etcd 中的键值对可以绑定到租约上，实现存活周期控制。在实际应用中，常用来实现服务的心跳，即服务在启动时获取租约，将租约与服务地址绑定，并写入 etcd 服务器，为了保持心跳状态，服务会定时刷新租约。

4.1 授予租约

应用客户端可以为 etcd 集群里面的键授予租约。当键被附加到租约时，它的存活时间被绑定到租约的存活时间，而租约的存活时间相应的被 TTL 管理。在授予租约时，每个租约的最小 TTL 值由应用客户端指定。

一旦租约的 TTL 到期，租约就会过期并且所有附带的键都将被删除。

创建一个租约，时间为 100s

wohu@ubuntu:~$ etcdctl lease grant 100
lease 694d78e3bc12d11a granted with TTL(100s)

将创建的租约绑定到键 /home/wohu/key1 上

wohu@ubuntu:~$ etcdctl put /home/wohu/key1 "hello" --lease=694d78e3bc12d11a
OK

查询键，在租约有效期内，可以获取到键值，租约到期后键值对被删除。

wohu@ubuntu:~$ etcdctl get /home/wohu/key1 
/home/wohu/key1
hello
wohu@ubuntu:~$ etcdctl get /home/wohu/key1 
wohu@ubuntu:~$

4.2 撤销租约

应用通过租约 ID 可以撤销租约。撤销租约将删除所有附带的 key。

wohu@ubuntu:~$ etcdctl lease grant 100000
lease 694d78e3bc12d122 granted with TTL(100000s)
wohu@ubuntu:~$ etcdctl put /home/wohu/key1 "hello" --lease=694d78e3bc12d122
OK
wohu@ubuntu:~$ etcdctl lease revoke 694d78e3bc12d122
lease 694d78e3bc12d122 revoked
wohu@ubuntu:~$ etcdctl get /home/wohu/key1

4.3 刷新租期

应用程序可以通过刷新其 TTL 保持租约存活，确保其不会过期。

wohu@ubuntu:~$ etcdctl lease grant 30
lease 694d78e3bc12d134 granted with TTL(30s)
wohu@ubuntu:~$ etcdctl lease keep-alive  694d78e3bc12d134
lease 694d78e3bc12d134 keepalived with TTL(30)
lease 694d78e3bc12d134 keepalived with TTL(30)
lease 694d78e3bc12d134 keepalived with TTL(30)
lease 694d78e3bc12d134 keepalived with TTL(30)
lease 694d78e3bc12d134 keepalived with TTL(30)

4.4 查询租期

客户端可以查询租赁信息，检查续订或租赁的状态，是否存在或者是否已过期。应用客户端还可以查询特定租约绑定的 key。

wohu@ubuntu:~$ etcdctl lease grant 300
lease 694d78e3bc12d137 granted with TTL(300s)
wohu@ubuntu:~$ etcdctl put /home/wohu/key1 "hello" --lease=694d78e3bc12d137
OK
wohu@ubuntu:~$ etcdctl lease timetolive 694d78e3bc12d137
lease 694d78e3bc12d137 granted with TTL(300s), remaining(271s)
wohu@ubuntu:~$ etcdctl lease timetolive 694d78e3bc12d137 --keys
lease 694d78e3bc12d137 granted with TTL(300s), remaining(261s), attached keys([/home/wohu/key1])
wohu@ubuntu:~$
wohu007
关注
  • 7
    点赞
  • 踩
  • 5
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
etcd　指定配置文件启动_etcd 入门使用
weixin_39520988的博客
12-04 670
ETCD 入门Zookeeper，通常用作服务发现和配置共享，ETCD 作为后起之秀，下面是官网对其的描述。A distributed, reliable key-value store for the most critical data of a distributed system.如今的互联网，ETCD 有很多适用场景，下面就介绍如何进行集群部署。集群节点数量与网络分割ETCD 适用 RA...
Etcd数据同步
weixin_56410104的博客
09-02 1112
etcd 数据同步
推荐使用：etcd-client - 强大的Rust版etcd v3客户端
最新发布
gitblog_00069的博客
06-01 407
推荐使用：etcd-client - 强大的Rust版etcd v3客户端 项目地址:https://gitcode.com/etcdv3/etcd-client 在分布式系统中，数据一致性是关键挑战之一。而Etcd，一个高度可用的键值存储系统，为服务发现和配置管理提供了强大的解决方案。现在，有了etcd-client，你可以更方便地在Rust应用程序中集成和利用etcd的强大功能。 1、项目介绍...
etcd系列深入浅出客户端
redenval的专栏
04-13 5622
【摘要】 绪论etcd的v2可以完全使用rest方式访问，v3则也可以通过部署一个grpc-gateway实现rest访问。但是一般来说，我们代码中操作etcd的读写还是会通过etcd提供的client来做。client 屏蔽了etcd server多节点访问的负载均衡问题，v3的的client采用grpc client可以维持长连接，断链自动重连。k8s的storage也是封装了etcd的cli...
Python-一个etcd的python客户端
08-10
基于etcd实现leader election功能，让普通脚本也可以运行在分布式环境实现高可用
etcd-workbench一款免费好用的ETCD客户端，支持SSHTunnel、版本对比等功能
beifengtz
12-24 2028
一个漂亮的、轻量的、可私有化部署的 ETCD 客户端，支持SSL、SSH Tunnel连接，支持多账户 session 管理。
rust-etcd：Rust的etcd客户端库
02-04
3. **租约管理**：etcd中的租约（Lease）机制可以为键值设置生存时间（TTL），rust-etcd提供了创建、续租和撤销租约的接口。 4. **分片和批量操作**：rust-etcd支持批量操作多个键，以及跨分区的键值操作，这对于...
perl-net-etcd：Net :: Etcd etcd v3 gRPC网关Perl客户端
02-05
这个库提供了各种方法来执行etcd v3的主要操作，如读取、写入、删除键值对，以及监视键的变化等。以下是一些关键知识点： 1. **Perl编程**：Perl是一种功能强大的脚本语言，广泛应用于文本处理、网络编程和系统管理...
etcd实战及其原理分析.pdf
02-12
etcd提供了丰富的命令行工具，允许用户进行键值的增删改查、设置权限、创建租约等操作。 2.3 etcd权限管理 etcd支持权限控制，可以设置用户、角色和权限，确保系统安全。 【etcd核心原理分析】 3.1 etcd概念词汇...
etcd-v3.5.0-linux-amd64.tar.gz
01-17
5. **watch 功能**：etcd 提供了 watch 功能，客户端可以监听某个键的变化，一旦键值发生变化，etcd 会主动推送通知给客户端，实现实时更新。 6. **多版本控制**：etcd 实现了多版本控制，每个键可以有多个历史版本...
etcd-browser
04-10
ETCD作为共享配置和服务发现的分布式，一致性的KV存储系统，被广泛应用于许多的分布式项目。许多文章对于etcd的应用场景有过及功能特性有过详细介绍。这里不多作展开。本文仅从配置上介绍etcd集群的搭建和具体的使用场景实例。
windows64位etcd浏览器
11-15
etcd浏览器，用于直接操作etcd服务端，启动服务端后再启动客户端。直接解压后修改server.js文件。
Go资源etcd-v3.5.13.zip
05-15
2. **Watch机制**：允许客户端监听特定键的变化，一旦发生变化，etcd会通知客户端。 3. ** Lease（租约）**：通过租约，可以设置键的有效时间，过期后键将自动删除，常用于实现自动过期的缓存。 4. ** Transactions...
etcd服务端和客户端安装
weixin_30412167的博客
11-15 222
　　下载地址： 　　服务端：http://download.csdn.net/download/wuxun1997/9841277 　　客户端：http://download.csdn.net/download/wuxun1997/10120393 　　上面俩压缩包都是直接解压即可，客户端需修改server.js文件： var etcdHost = process.env.ETCD_H...
ETCD etcdctl：客户端操作 etcd 服务端的工具
小楼一夜听春雨，深巷明朝卖杏花
02-20 3681
安装好 etcd 后，我们将开始体验如何使用 etcd。这一讲，我将会基于 etcd 自带的客户端工具——etcdctl 来演示 etcd 常用的一些操作，帮助你快速入手 etcd。 etcdctl 客户端 etcdctl 是一个命令行客户端，便于我们进行服务测试或手动修改数据库内容，我们刚开始熟悉 etcd 功能时可以通过 etdctl 客户端熟悉相关操作。etcdctl 在两个不同的 etcd 版本（v2 和 v3）下的功能和使用方式也完全不同。一般通过如下方式来指定使用 etcd 的版本： .
断网无忧：ETCD客户端自动重连技术揭秘
跳小闹成长记
03-07 916
之前在设计开发自动限流计数集群系统时，使用了ETCD来实现服务协调和集群选举。去年公司在做断网演练期间发现，ETCD客户端在和服务端断开连接之后，没有办法自动重新连接服务，恢复业务。具体表现如下图，机器心跳正常，但在ETCD上注册的服务离线。于是需要设计实现ETCD客户端与ETCD服务端的自动重连功能。确保在任何网络闪断或者网络临时中断的情况下，ETCD客户端能够在一定时间内自动注册到ETCD服务端，恢复服务。本文将和大家分享如何通过代理模式和观察者模式优雅的实现该自动重连方案。
如何直接修改Kubernetes的etcd数据（不使用K8s API）
weixin_26752759的博客
09-16 1758
如何直接修改Kubernetes的etcd数据(不使用K8s API) (How to modify etcd data of your Kubernetes directly (without K8s API))Have you ever thought about a “low-level” way of changing the etcd data of your Kubernetes ...
etcd 笔记（01）— etcd 简介、特点、应用场景、常用术语
wohu1104的专栏
04-26 9013
1. etcd 简介 etcd 官网定义： A highly-available key value store for shared configuration and service discovery. 即一个用于配置共享和服务发现的键值存储系统。 etcd 是一款分布式存储中间件，使用 Go 语言编写，并通过 Raft 一致性算法处理和确保分布式一致性，解决了分布式系统中数据一致性的问题。 而且作为一款分布式、可靠的键值存储组件，etcd 常用于微服务架构中的服务注册与发现中心，相较于 ZooK
使用jetcd-core获取etcd下的文件目录
05-20
使用jetcd-core可以通过以下步骤获取etcd下的文件目录： 1. 创建EtcdClient对象，连接到etcd服务器： ```java EtcdClient etcdClient = new EtcdClient(URI.create("http://localhost:2379")); ``` 2. 使用get方法获取指定key的值，设置withPrefix参数为true可以获取该key的所有子节点： ```java CompletableFuture<GetResponse> getFuture = etcdClient.get("key", GetOption.newBuilder().withPrefix(true).build()); GetResponse getResponse = getFuture.get(); ``` 3. 遍历getResponse.getKvs()，获取所有子节点的key和value： ```java for (KeyValue keyValue : getResponse.getKvs()) { String key = keyValue.getKey().toStringUtf8(); String value = keyValue.getValue().toStringUtf8(); System.out.println(key + " -> " + value); } ``` 完整代码示例： ```java import io.etcd.jetcd.ByteSequence; import io.etcd.jetcd.Client; import io.etcd.jetcd.KV; import io.etcd.jetcd.KV.GetOption; import io.etcd.jetcd.KV.GetResponse; import io.etcd.jetcd.Lease; import io.etcd.jetcd.LeaseGrantResponse; import io.etcd.jetcd.Lock; import io.etcd.jetcd.Txn; import io.etcd.jetcd.Watch; import io.etcd.jetcd.auth.Auth; import io.etcd.jetcd.auth.Permission; import io.etcd.jetcd.auth.Role; import io.etcd.jetcd.auth.User; import io.etcd.jetcd.cluster.Cluster; import io.etcd.jetcd.launcher.EtcdCluster; import io.etcd.jetcd.launcher.EtcdClusterFactory; import io.etcd.jetcd.launcher.EtcdClusterSpec; import io.etcd.jetcd.lock.LockResponse; import io.etcd.jetcd.options.PutOption; import io.etcd.jetcd.support.CloseableClient; import io.etcd.jetcd.support.Scheduler; import io.etcd.jetcd.support.Schedulers; import io.etcd.jetcd.watch.WatchEvent; import io.etcd.jetcd.watch.WatchResponse; import java.net.URI; import java.util.concurrent.CompletableFuture; public class EtcdExample { public static void main(String[] args) throws Exception { // 创建EtcdClient对象，连接到etcd服务器 EtcdClient etcdClient = new EtcdClient(URI.create("http://localhost:2379")); // 使用get方法获取指定key的值，设置withPrefix参数为true可以获取该key的所有子节点 CompletableFuture<GetResponse> getFuture = etcdClient.get("key", GetOption.newBuilder().withPrefix(true).build()); GetResponse getResponse = getFuture.get(); // 遍历getResponse.getKvs()，获取所有子节点的key和value for (KeyValue keyValue : getResponse.getKvs()) { String key = keyValue.getKey().toStringUtf8(); String value = keyValue.getValue().toStringUtf8(); System.out.println(key + " -> " + value); } // 关闭EtcdClient对象 etcdClient.close(); } } ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值