etcd
简介
etcd是一个go编写的,开源、高可用的分布式key-value存储系统,可用于配置共享服务和注册服务、服务发现。非常适合用来做配置中心
类似的项目有zookeeper和consul,
etcd的特点:简单、安全、非常高的读写性能
与zookeeper相比
-
etcd更简单。zookeeper部署维护复杂,需要安装客户端,官方只提供了java和c两种语言的接口。而etcd部署简单;简单的接口,使用http作为接口,其他语言也可以接入。
-
etcd的数据持久化,etcd默认数据已更新就进行持久化
-
安全。etcd支持SSL客户端安全认证
etcd的安装
到github上找到对应系统的发行版,github发行页面,下载对应的压缩包,不要下载到源码了,源码不能直接使用
启动etcd(我用的win10系统)
来到etcd目录下,打开cmd运行etcd.exe
,就启动服务了,其中etcdctl.exe
是客户端,可以用它连接etcd。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-vpNatyq6-1649989587589)(F:\白云学院\go\doc\img\tail-kafka\etcd-start.png)]
服务启动后默认监听本地2379端口
golang操作etcd
因为etcd是golang编写的,是有对应golang的客户端连接工具的。但是他不在github上。下载过程中如果出现了找不到,尝试切换一下代理。一般问题百度都有答案。
包位置:go.etcd.io/etcd/clientv3
安装命令: go get go.etcd.io/etcd/clientv3
使用上
key-value存储
etcd
的写入操作是put
,修改是使用覆写的方式,因此没有所谓的update。获取用的是get
。
关键代码
package main
import (
"context"
"fmt"
"time"
clientv3 "go.etcd.io/etcd/client/v3"
)
func main() {
cli, err := clientv3.New(clientv3.Config{
Endpoints: []string{"127.0.0.1:2379"},
DialTimeout: 5 * time.Second,
})
if err != nil {
panic(err)
}
fmt.Println("etcd boot success")
defer cli.Close()
// put
ctx, cancel := context.WithTimeout(context.Background(), time.Second)
_, err = cli.Put(ctx, "age", "18")
cancel()
if err != nil {
fmt.Printf("put to etcd failed, err:%v\n", err)
return
}
// get
ctx, cancel = context.WithTimeout(context.Background(), time.Second)
resp, err := cli.Get(ctx, "lmh")
cancel()
if err != nil {
fmt.Printf("get from etcd failed, err:%v\n", err)
return
}
for _, ev := range resp.Kvs {
fmt.Printf("%s:%s\n", ev.Key, ev.Value)
}
}
watch 监听
etcd
可以监听key的变化,例如删除或修改,都会触发watch。可以将配置项加入到etcd中,通过监听配置的键值变化来做动态加载配置。
cli, err := clientv3.New(clientv3.Config{
Endpoints: []string{"127.0.0.1:2379"},
DialTimeout: 5 * time.Second,
})
if err != nil {
fmt.Printf("connect to etcd failed, err:%v\n", err)
return
}
defer cli.Close()
wch := cli.Watch(context.Background(), "age")
fmt.Println("ch:")
fmt.Println(wch)
for wresp := range wch {
for _, ev := range wresp.Events {
fmt.Printf("Type: %s Key:%s Value:%s\n", ev.Type, ev.Kv.Key, ev.Kv.Value)
}
}
v3版本的一个小问题
v3版本有个小问题,网上教程下载着3.x的版本,文档却是早期的文档,代码运行就错,顺着报错去查挺多没用的操作,看的还挺相关的,都是etcd引入错误。最后看到github上的新版实例代码才发现写法不对。
错误的引入clientv3
:
import "go.etcd.io/etcd/clientv3"
正确的引入clientv3
:
import clientv3 "go.etcd.io/etcd/client/v3"