etcd通訊介面之使用者端API核心方法實戰

2022-06-17 18:02:08

前言

我們在前面介紹了 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
}

注意，這裡顯示的都是可匯出的模組結構欄位，代表了使用者端能夠使用的幾大核心模組，其具體功能介紹如下：

Cluster：向叢集裡增加 etcd 伺服器端節點之類，屬於管理員操作。
KV：我們主要使用的功能，即操作 K-V。
Lease：租約相關操作，比如申請一個 TTL=10 秒的租約。
Watcher：觀察訂閱，從而監聽最新的資料變化。
Auth：管理 etcd 的使用者和許可權，屬於管理員操作。
Maintenance：維護 etcd，比如主動遷移 etcd 的 leader 節點，屬於管理員操作

以上就是etcd通訊介面之使用者端API核心方法實戰的詳細內容，更多關於etcd通訊介面使用者端API的資料請關注it145.com其它相關文章！

etcd通訊介面之使用者端API核心方法實戰

目錄

前言

etcd clientv3 使用者端

etcd 使用者端初始化

client 定義

熱門文章