Golang:etcd

321 阅读2分钟

一起养成写作习惯!这是我参与「掘金日新计划 · 4 月更文挑战」的第14天,点击查看活动详情

etcd

简介

etcd是一个go编写的,开源、高可用的分布式key-value存储系统,可用于配置共享服务和注册服务、服务发现。非常适合用来做配置中心

类似的项目有zookeeper和consul,

etcd的特点:简单、安全、非常高的读写性能

与zookeeper相比

  1. etcd更简单。zookeeper部署维护复杂,需要安装客户端,官方只提供了java和c两种语言的接口。而etcd部署简单;简单的接口,使用http作为接口,其他语言也可以接入。
  1. etcd的数据持久化,etcd默认数据已更新就进行持久化
  2. 安全。etcd支持SSL客户端安全认证

etcd的安装

到github上找到对应系统的发行版,github发行页面,下载对应的压缩包,不要下载到源码了,源码不能直接使用

etcd-install.png

启动etcd(我用的win10系统)

来到etcd目录下,打开cmd运行etcd.exe,就启动服务了,其中etcdctl.exe是客户端,可以用它连接etcd。

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""go.etcd.io/etcd/clientv3"
)
​
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, "lmh", "lmh")
    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)
    }
}

etcd-test1.png

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上的新版实例代码才发现写法不对。

etcd-test2.png 错误的引入clientv3:

import "go.etcd.io/etcd/clientv3"

正确的引入clientv3:

import clientv3 "go.etcd.io/etcd/client/v3"