etcd通信接口之客户端API核心方法怎么使用
本篇内容介绍了“etcd通信接口之客户端API核心方法怎么使用”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!
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.gopackage clientimport ("context""fmt""go.etcd.io/etcd/clientv3""testing""time")// 测试客户端连接func TestEtcdClientInit(t *testing.T) {var (config clientv3.Configclient *clientv3.Clienterr 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}
注意,这里显示的都是可导出的模块结构字段,代表了客户端能够使用的几大核心模块,其具体功能介绍如下:
Cluster:向集群里增加 etcd 服务端节点之类,属于管理员操作。
KV:我们主要使用的功能,即操作 K-V。
Lease:租约相关操作,比如申请一个 TTL=10 秒的租约。
Watcher:观察订阅,从而监听最新的数据变化。
Auth:管理 etcd 的用户和权限,属于管理员操作。
Maintenance:维护 etcd,比如主动迁移 etcd 的 leader 节点,属于管理员操作
“etcd通信接口之客户端API核心方法怎么使用”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注编程网网站,小编将为大家输出更多高质量的实用文章!
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341