Go操作etcd的實(shí)現(xiàn)示例
etcd是近幾年比較火熱的一個(gè)開(kāi)源的、分布式的鍵值對(duì)數(shù)據(jù)存儲(chǔ)系統(tǒng)，提供共享配置、服務(wù)的注冊(cè)和發(fā)現(xiàn)，本文主要介紹etcd的安裝和使用。
etcdetcd介紹
etcd是使用Go語(yǔ)言開(kāi)發(fā)的一個(gè)開(kāi)源的、高可用的分布式key-value存儲(chǔ)系統(tǒng)，可以用于配置共享和服務(wù)的注冊(cè)和發(fā)現(xiàn)。
類(lèi)似項(xiàng)目有zookeeper和consul。
etcd具有以下特點(diǎn)：
- 完全復(fù)制：集群中的每個(gè)節(jié)點(diǎn)都可以使用完整的存檔
- 高可用性：Etcd可用于避免硬件的單點(diǎn)故障或網(wǎng)絡(luò)問(wèn)題
- 一致性：每次讀取都會(huì)返回跨多主機(jī)的最新寫(xiě)入
- 簡(jiǎn)單：包括一個(gè)定義良好、面向用戶(hù)的API（gRPC）
- 安全：實(shí)現(xiàn)了帶有可選的客戶(hù)端證書(shū)身份驗(yàn)證的自動(dòng)化TLS
- 快速：每秒10000次寫(xiě)入的基準(zhǔn)速度
- 可靠：使用Raft算法實(shí)現(xiàn)了強(qiáng)一致、高可用的服務(wù)存儲(chǔ)目錄
etcd應(yīng)用場(chǎng)景
服務(wù)發(fā)現(xiàn)
服務(wù)發(fā)現(xiàn)要解決的也是分布式系統(tǒng)中最常見(jiàn)的問(wèn)題之一，即在同一個(gè)分布式集群中的進(jìn)程或服務(wù)，要如何才能找到對(duì)方并建立連接。本質(zhì)上來(lái)說(shuō)，服務(wù)發(fā)現(xiàn)就是想要了解集群中是否有進(jìn)程在監(jiān)聽(tīng) udp 或 tcp 端口，并且通過(guò)名字就可以查找和連接。
配置中心
將一些配置信息放到 etcd 上進(jìn)行集中管理。
這類(lèi)場(chǎng)景的使用方式通常是這樣：應(yīng)用在啟動(dòng)的時(shí)候主動(dòng)從 etcd 獲取一次配置信息，同時(shí)，在 etcd 節(jié)點(diǎn)上注冊(cè)一個(gè) Watcher 并等待，以后每次配置有更新的時(shí)候，etcd 都會(huì)實(shí)時(shí)通知訂閱者，以此達(dá)到獲取最新配置信息的目的。
分布式鎖
因?yàn)?etcd 使用 Raft 算法保持了數(shù)據(jù)的強(qiáng)一致性，某次操作存儲(chǔ)到集群中的值必然是全局一致的，所以很容易實(shí)現(xiàn)分布式鎖。鎖服務(wù)有兩種使用方式，一是保持獨(dú)占，二是控制時(shí)序。
保持獨(dú)占即所有獲取鎖的用戶(hù)最終只有一個(gè)可以得到。etcd 為此提供了一套實(shí)現(xiàn)分布式鎖原子操作 CAS（CompareAndSwap）的 API。通過(guò)設(shè)置prevExist值，可以保證在多個(gè)節(jié)點(diǎn)同時(shí)去創(chuàng)建某個(gè)目錄時(shí)，只有一個(gè)成功。而創(chuàng)建成功的用戶(hù)就可以認(rèn)為是獲得了鎖。
控制時(shí)序，即所有想要獲得鎖的用戶(hù)都會(huì)被安排執(zhí)行，但是獲得鎖的順序也是全局唯一的，同時(shí)決定了執(zhí)行順序。etcd 為此也提供了一套 API（自動(dòng)創(chuàng)建有序鍵），對(duì)一個(gè)目錄建值時(shí)指定為POST動(dòng)作，這樣 etcd 會(huì)自動(dòng)在目錄下生成一個(gè)當(dāng)前最大的值為鍵，存儲(chǔ)這個(gè)新的值（客戶(hù)端編號(hào)）。同時(shí)還可以使用 API 按順序列出所有當(dāng)前目錄下的鍵值。此時(shí)這些鍵的值就是客戶(hù)端的時(shí)序，而這些鍵中存儲(chǔ)的值可以是代表客戶(hù)端的編號(hào)。
為什么用 etcd 而不用ZooKeeper？
etcd 實(shí)現(xiàn)的這些功能，ZooKeeper都能實(shí)現(xiàn)。那么為什么要用 etcd 而非直接使用ZooKeeper呢？
為什么不選擇ZooKeeper？
- 部署維護(hù)復(fù)雜，其使用的
Paxos強(qiáng)一致性算法復(fù)雜難懂。官方只提供了Java和C兩種語(yǔ)言的接口。 - 使用
Java編寫(xiě)引入大量的依賴(lài)。運(yùn)維人員維護(hù)起來(lái)比較麻煩。 - 最近幾年發(fā)展緩慢，不如
etcd和consul等后起之秀。
為什么選擇etcd？
- 簡(jiǎn)單。使用 Go 語(yǔ)言編寫(xiě)部署簡(jiǎn)單；支持HTTP/JSON API,使用簡(jiǎn)單；使用 Raft 算法保證強(qiáng)一致性讓用戶(hù)易于理解。
- etcd 默認(rèn)數(shù)據(jù)一更新就進(jìn)行持久化。
- etcd 支持 SSL 客戶(hù)端安全認(rèn)證。
最后，etcd 作為一個(gè)年輕的項(xiàng)目，正在高速迭代和開(kāi)發(fā)中，這既是一個(gè)優(yōu)點(diǎn)，也是一個(gè)缺點(diǎn)。優(yōu)點(diǎn)是它的未來(lái)具有無(wú)限的可能性，缺點(diǎn)是無(wú)法得到大項(xiàng)目長(zhǎng)時(shí)間使用的檢驗(yàn)。然而，目前 CoreOS、Kubernetes和CloudFoundry等知名項(xiàng)目均在生產(chǎn)環(huán)境中使用了etcd，所以總的來(lái)說(shuō)，etcd值得你去嘗試。
etcd集群
etcd 作為一個(gè)高可用鍵值存儲(chǔ)系統(tǒng)，天生就是為集群化而設(shè)計(jì)的。由于 Raft 算法在做決策時(shí)需要多數(shù)節(jié)點(diǎn)的投票，所以 etcd 一般部署集群推薦奇數(shù)個(gè)節(jié)點(diǎn)，推薦的數(shù)量為 3、5 或者 7 個(gè)節(jié)點(diǎn)構(gòu)成一個(gè)集群。
搭建一個(gè)3節(jié)點(diǎn)集群示例：
在每個(gè)etcd節(jié)點(diǎn)指定集群成員，為了區(qū)分不同的集群最好同時(shí)配置一個(gè)獨(dú)一無(wú)二的token。
下面是提前定義好的集群信息，其中n1、n2和n3表示3個(gè)不同的etcd節(jié)點(diǎn)。
TOKEN=token-01 CLUSTER_STATE=new CLUSTER=n1=http://10.240.0.17:2380,n2=http://10.240.0.18:2380,n3=http://10.240.0.19:2380
在n1這臺(tái)機(jī)器上執(zhí)行以下命令來(lái)啟動(dòng)etcd：
etcd --data-dir=data.etcd --name n1 \
--initial-advertise-peer-urls http://10.240.0.17:2380 --listen-peer-urls http://10.240.0.17:2380 \
--advertise-client-urls http://10.240.0.17:2379 --listen-client-urls http://10.240.0.17:2379 \
--initial-cluster ${CLUSTER} \
--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}
在n2這臺(tái)機(jī)器上執(zhí)行以下命令啟動(dòng)etcd：
etcd --data-dir=data.etcd --name n2 \
--initial-advertise-peer-urls http://10.240.0.18:2380 --listen-peer-urls http://10.240.0.18:2380 \
--advertise-client-urls http://10.240.0.18:2379 --listen-client-urls http://10.240.0.18:2379 \
--initial-cluster ${CLUSTER} \
--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}
在n3這臺(tái)機(jī)器上執(zhí)行以下命令啟動(dòng)etcd：
etcd --data-dir=data.etcd --name n3 \
--initial-advertise-peer-urls http://10.240.0.19:2380 --listen-peer-urls http://10.240.0.19:2380 \
--advertise-client-urls http://10.240.0.19:2379 --listen-client-urls http://10.240.0.19:2379 \
--initial-cluster ${CLUSTER} \
--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}
etcd 官網(wǎng)提供了一個(gè)可以公網(wǎng)訪問(wèn)的 etcd 存儲(chǔ)地址。你可以通過(guò)如下命令得到 etcd 服務(wù)的目錄，并把它作為-discovery參數(shù)使用。
curl https://discovery.etcd.io/new?size=3
https://discovery.etcd.io/a81b5818e67a6ea83e9d4daea5ecbc92
# grab this token
TOKEN=token-01
CLUSTER_STATE=new
DISCOVERY=https://discovery.etcd.io/a81b5818e67a6ea83e9d4daea5ecbc92
etcd --data-dir=data.etcd --name n1 \
--initial-advertise-peer-urls http://10.240.0.17:2380 --listen-peer-urls http://10.240.0.17:2380 \
--advertise-client-urls http://10.240.0.17:2379 --listen-client-urls http://10.240.0.17:2379 \
--discovery ${DISCOVERY} \
--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}
etcd --data-dir=data.etcd --name n2 \
--initial-advertise-peer-urls http://10.240.0.18:2380 --listen-peer-urls http://10.240.0.18:2380 \
--advertise-client-urls http://10.240.0.18:2379 --listen-client-urls http://10.240.0.18:2379 \
--discovery ${DISCOVERY} \
--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}
etcd --data-dir=data.etcd --name n3 \
--initial-advertise-peer-urls http://10.240.0.19:2380 --listen-peer-urls http://10.240.0.19:2380 \
--advertise-client-urls http://10.240.0.19:2379 --listen-client-urls http:/10.240.0.19:2379 \
--discovery ${DISCOVERY} \
--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}
到此etcd集群就搭建起來(lái)了，可以使用etcdctl來(lái)連接etcd。
export ETCDCTL_API=3 HOST_1=10.240.0.17 HOST_2=10.240.0.18 HOST_3=10.240.0.19 ENDPOINTS=$HOST_1:2379,$HOST_2:2379,$HOST_3:2379 etcdctl --endpoints=$ENDPOINTS member lis
Go語(yǔ)言操作etcd
這里使用官方的etcd/clientv3包來(lái)連接etcd并進(jìn)行相關(guān)操作。
安裝
go get go.etcd.io/etcd/clientv3
put和get操作
put命令用來(lái)設(shè)置鍵值對(duì)數(shù)據(jù)，get命令用來(lái)根據(jù)key獲取值。
package main
import (
"context"
"fmt"
"time"
"go.etcd.io/etcd/clientv3"
)
// etcd client put/get demo
// use etcd/clientv3
func main() {
cli, err := clientv3.New(clientv3.Config{
Endpoints: []string{"127.0.0.1:2379"},
DialTimeout: 5 * time.Second,
})
if err != nil {
// handle error!
fmt.Printf("connect to etcd failed, err:%v\n", err)
return
}
fmt.Println("connect to etcd success")
defer cli.Close()
// put
ctx, cancel := context.WithTimeout(context.Background(), time.Second)
_, err = cli.Put(ctx, "q1mi", "dsb")
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, "q1mi")
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操作
watch用來(lái)獲取未來(lái)更改的通知。
package main
import (
"context"
"fmt"
"time"
"go.etcd.io/etcd/clientv3"
)
// watch demo
func main() {
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
}
fmt.Println("connect to etcd success")
defer cli.Close()
// watch key:q1mi change
rch := cli.Watch(context.Background(), "q1mi") // <-chan WatchResponse
for wresp := range rch {
for _, ev := range wresp.Events {
fmt.Printf("Type: %s Key:%s Value:%s\n", ev.Type, ev.Kv.Key, ev.Kv.Value)
}
}
}
將上面的代碼保存編譯執(zhí)行，此時(shí)程序就會(huì)等待etcd中q1mi這個(gè)key的變化。
例如：我們打開(kāi)終端執(zhí)行以下命令修改、刪除、設(shè)置q1mi這個(gè)key。
etcd> etcdctl.exe --endpoints=http://127.0.0.1:2379 put q1mi "dsb2" OK etcd> etcdctl.exe --endpoints=http://127.0.0.1:2379 del q1mi 1 etcd> etcdctl.exe --endpoints=http://127.0.0.1:2379 put q1mi "dsb3" OK
上面的程序都能收到如下通知。
watch>watch.exe connect to etcd success Type: PUT Key:q1mi Value:dsb2 Type: DELETE Key:q1mi Value: Type: PUT Key:q1mi Value:dsb3
lease租約
package main
import (
"fmt"
"time"
)
// etcd lease
import (
"context"
"log"
"go.etcd.io/etcd/clientv3"
)
func main() {
cli, err := clientv3.New(clientv3.Config{
Endpoints: []string{"127.0.0.1:2379"},
DialTimeout: time.Second * 5,
})
if err != nil {
log.Fatal(err)
}
fmt.Println("connect to etcd success.")
defer cli.Close()
// 創(chuàng)建一個(gè)5秒的租約
resp, err := cli.Grant(context.TODO(), 5)
if err != nil {
log.Fatal(err)
}
// 5秒鐘之后, /nazha/ 這個(gè)key就會(huì)被移除
_, err = cli.Put(context.TODO(), "/nazha/", "dsb", clientv3.WithLease(resp.ID))
if err != nil {
log.Fatal(err)
}
}
keepAlive
package main
import (
"context"
"fmt"
"log"
"time"
"go.etcd.io/etcd/clientv3"
)
// etcd keepAlive
func main() {
cli, err := clientv3.New(clientv3.Config{
Endpoints: []string{"127.0.0.1:2379"},
DialTimeout: time.Second * 5,
})
if err != nil {
log.Fatal(err)
}
fmt.Println("connect to etcd success.")
defer cli.Close()
resp, err := cli.Grant(context.TODO(), 5)
if err != nil {
log.Fatal(err)
}
_, err = cli.Put(context.TODO(), "/nazha/", "dsb", clientv3.WithLease(resp.ID))
if err != nil {
log.Fatal(err)
}
// the key 'foo' will be kept forever
ch, kaerr := cli.KeepAlive(context.TODO(), resp.ID)
if kaerr != nil {
log.Fatal(kaerr)
}
for {
ka := <-ch
fmt.Println("ttl:", ka.TTL)
}
}
基于etcd實(shí)現(xiàn)分布式鎖
go.etcd.io/etcd/clientv3/concurrency在etcd之上實(shí)現(xiàn)并發(fā)操作，如分布式鎖、屏障和選舉。
導(dǎo)入該包：
import "go.etcd.io/etcd/clientv3/concurrency"
基于etcd實(shí)現(xiàn)的分布式鎖示例：
cli, err := clientv3.New(clientv3.Config{Endpoints: endpoints})
if err != nil {
log.Fatal(err)
}
defer cli.Close()
// 創(chuàng)建兩個(gè)單獨(dú)的會(huì)話(huà)用來(lái)演示鎖競(jìng)爭(zhēng)
s1, err := concurrency.NewSession(cli)
if err != nil {
log.Fatal(err)
}
defer s1.Close()
m1 := concurrency.NewMutex(s1, "/my-lock/")
s2, err := concurrency.NewSession(cli)
if err != nil {
log.Fatal(err)
}
defer s2.Close()
m2 := concurrency.NewMutex(s2, "/my-lock/")
// 會(huì)話(huà)s1獲取鎖
if err := m1.Lock(context.TODO()); err != nil {
log.Fatal(err)
}
fmt.Println("acquired lock for s1")
m2Locked := make(chan struct{})
go func() {
defer close(m2Locked)
// 等待直到會(huì)話(huà)s1釋放了/my-lock/的鎖
if err := m2.Lock(context.TODO()); err != nil {
log.Fatal(err)
}
}()
if err := m1.Unlock(context.TODO()); err != nil {
log.Fatal(err)
}
fmt.Println("released lock for s1")
<-m2Locked
fmt.Println("acquired lock for s2")
輸出：
acquired lock for s1
released lock for s1
acquired lock for s2
其他操作
其他操作請(qǐng)查看etcd/clientv3官方文檔。
參考鏈接：
https://etcd.io/docs/v3.3.12/demo/
https://www.infoq.cn/article/etcd-interpretation-application-scenario-implement-principle/ 代碼改變世界，腳踏實(shí)地，python、Golang。
到此這篇關(guān)于Go操作etcd的實(shí)現(xiàn)示例的文章就介紹到這了,更多相關(guān)Go操作etcd內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Golang多線程爬蟲(chóng)高效抓取大量數(shù)據(jù)的利器
Golang多線程爬蟲(chóng)是一種高效抓取大量數(shù)據(jù)的利器。Golang語(yǔ)言天生支持并發(fā)和多線程，可以輕松實(shí)現(xiàn)多線程爬蟲(chóng)的開(kāi)發(fā)。通過(guò)使用Golang的協(xié)程和通道，可以實(shí)現(xiàn)爬蟲(chóng)的高效并發(fā)抓取、數(shù)據(jù)處理和存儲(chǔ)2023-05-05
Go語(yǔ)言對(duì)接微信支付與退款指南(示例詳解)
在互聯(lián)網(wǎng)技術(shù)日益發(fā)展的背景下,Go語(yǔ)言憑借并發(fā)處理能力,在后端開(kāi)發(fā)中大放異彩,本文詳細(xì)介紹如何使用Go語(yǔ)言對(duì)接微信支付,完成支付和退款功能,包括準(zhǔn)備工作、初始化微信支付客戶(hù)端、實(shí)現(xiàn)支付功能,以及處理支付回調(diào)和退款等2024-10-10
Go語(yǔ)言中,切片可通過(guò)直接初始化、數(shù)組初始化、切片表達(dá)式等多種方法進(jìn)行初始化,這些方式提供了靈活的數(shù)據(jù)管理方式,適合不同的編程需求和場(chǎng)景,感興趣的可以了解一下2024-10-10
深入探究Golang中flag標(biāo)準(zhǔn)庫(kù)的使用
在本文中，我們將深入探討 flag 標(biāo)準(zhǔn)庫(kù)的實(shí)現(xiàn)原理和使用技巧，以幫助讀者更好地理解和掌握該庫(kù)的使用方法，文中的示例代碼講解詳細(xì)，感興趣的可以了解一下2023-04-04
利用go語(yǔ)言實(shí)現(xiàn)Git?重命名遠(yuǎn)程分支??
這篇文章主要介紹了go語(yǔ)言實(shí)現(xiàn)Git?重命名遠(yuǎn)程分支，文章基于go語(yǔ)言的基礎(chǔ)展開(kāi)Git?重命名遠(yuǎn)程分支的實(shí)現(xiàn)過(guò)程，需要的小伙伴可以參考一下，希望對(duì)你的學(xué)習(xí)有所幫助2022-06-06
逃逸分析是指由編譯器決定內(nèi)存分配的位置，不需要程序員指定，這篇文章主要為大家詳細(xì)介紹了Golang中內(nèi)存逃逸分析的幾種方法，需要的可以參考一下2023-07-07
golang開(kāi)啟mod后import報(bào)紅的簡(jiǎn)單解決方案
這篇文章主要給大家介紹了關(guān)于golang開(kāi)啟mod后import報(bào)紅的簡(jiǎn)單解決方案,文中通過(guò)圖文將解決的辦法介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2024-01-01
關(guān)于Golang中for-loop與goroutine的問(wèn)題詳解
這篇文章主要給大家介紹了關(guān)于Golang中for-loop與goroutine問(wèn)題的相關(guān)資料，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者使用golang具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧。2017-09-09
Go語(yǔ)言實(shí)現(xiàn)的最簡(jiǎn)單數(shù)獨(dú)解法
前面給大家介紹過(guò)使用javascript實(shí)現(xiàn)的簡(jiǎn)單的數(shù)獨(dú)解法，小伙伴們都非常喜歡，今天我們?cè)賮?lái)分享一則go語(yǔ)言實(shí)現(xiàn)的簡(jiǎn)單的數(shù)獨(dú)解法，有需要的小伙伴來(lái)參考下。2015-03-03
golang如何通過(guò)viper讀取config.yaml文件
這篇文章主要介紹了golang通過(guò)viper讀取config.yaml文件，圍繞golang讀取config.yaml文件的相關(guān)資料展開(kāi)詳細(xì)內(nèi)容，需要的小伙伴可以參考一下2022-03-03