etcd通信接口之客户端API核心方法实战_Golang

etcd通信接口之客户端API核心方法实战

2022-10-23 16:16aoho Golang

这篇文章主要为大家介绍了etcd通信接口之客户端API核心方法实战，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪

前言

我们在前面介绍了 etcd 的整体架构。学习客户端与 etcd 服务端的通信以及 etcd 集群节点的内部通信接口对于我们更好地使用和掌握 etcd 组件很有帮助，也是所必需了解的内容。我们将会介绍 etcd 的 gRPC 通信接口以及客户端的实践。

etcd clientv3 客户端

etcd 客户端 clientv3 接入的示例将会以 Go 客户端为主，读者需要准备好基本的开发环境。

首先是 etcd clientv3 的初始化，我们根据指定的 etcd 节点，建立客户端与 etcd 集群的连接。

				?

									cli,err := clientv3.New(clientv3.Config{

									    Endpoints:[]string{"localhost:2379"},

									    DialTimeout: 5 * time.Second,

									})

如上的代码实例化了一个 client，这里需要传入的两个参数：

Endpoints：etcd 的多个节点服务地址，因为我是单点本机测试，所以只传 1 个。
DialTimeout：创建 client 的首次连接超时，这里传了 5 秒，如果 5 秒都没有连接成功就会返回 err；值得注意的是，一旦 client 创建成功，我们就不用再关心后续底层连接的状态了，client 内部会重连。

etcd 客户端初始化

解决完包依赖之后，我们初始化 etcd 客户端。客户端初始化代码如下所示：

				?

									// client_init_test.go

									package client

									import (

									    "context"

									    "fmt"

									    "go.etcd.io/etcd/clientv3"

									    "testing"

									    "time"

									)

									// 测试客户端连接

									func TestEtcdClientInit(t *testing.T) {

									    var (

									        config clientv3.Config

									        client *clientv3.Client

									        err    error

									    )

									    // 客户端配置

									    config = clientv3.Config{

									        // 节点配置

									        Endpoints:   []string{"localhost:2379"},

									        DialTimeout: 5 * time.Second,

									    }

									    // 建立连接

									    if client, err = clientv3.New(config); err != nil {

									        fmt.Println(err)

									    } else {

									        // 输出集群信息

									        fmt.Println(client.Cluster.MemberList(context.TODO()))

									    }

									    client.Close()

									}

如上的代码，预期的执行结果如下：

=== RUN TestEtcdClientInit
&{cluster_id:14841639068965178418 member_id:10276657743932975437 raft_term:3 [ID:10276657743932975437 name:"default" peerURLs:"http://localhost:2380" clientURLs:"http://0.0.0.0:2379" ] {} [] 0} <nil>
--- PASS: TestEtcdClientInit (0.08s)
PASS

可以看到 clientv3 与 etcd Server 的节点 localhost:2379 成功建立了连接，并且输出了集群的信息，下面我们就可以对 etcd 进行操作了。

client 定义

接着我们来看一下 client 的定义：

				?

									type Client struct {

									    Cluster

									    KV

									    Lease

									    Watcher

									    Auth

									    Maintenance

									    // Username is a user name for authentication.

									    Username string

									    // Password is a password for authentication.

									    Password string

									}