使用etcd集群官方示例（演示版）

最新推荐文章于 2024-05-26 09:03:06 发布
最新推荐文章于 2024-05-26 09:03:06 发布
阅读量626 收藏
点赞数
分类专栏： 分布式随笔 文章标签： 分布式 etcd
原文链接：https://etcd.io/docs/v3.3.13/demo/
版权

官方原文地址：https://etcd.io/docs/v3.3.13/demo/

启动集群(Set up a cluster)

在每个etcd节点上，指定集群成员:

TOKEN=token-01
CLUSTER_STATE=new
NAME_1=machine-1
NAME_2=machine-2
NAME_3=machine-3
HOST_1=10.240.0.17
HOST_2=10.240.0.18
HOST_3=10.240.0.19
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

 

在每个etcd节点上进行如下操作:

# For machine 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# For machine 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# For machine 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

 

或使用我们的公共发现服务:

curl https://discovery.etcd.io/new?size=3
https://discovery.etcd.io/a81b5818e67a6ea83e9d4daea5ecbc92

# grab this token
TOKEN=token-01
CLUSTER_STATE=new
NAME_1=machine-1
NAME_2=machine-2
NAME_3=machine-3
HOST_1=10.240.0.17
HOST_2=10.240.0.18
HOST_3=10.240.0.19
DISCOVERY=https://discovery.etcd.io/a81b5818e67a6ea83e9d4daea5ecbc92

THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
    --discovery ${DISCOVERY} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
    --discovery ${DISCOVERY} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
    --discovery ${DISCOVERY} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

 

现在etcd准备好了！使用etcdctl连接到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 list

访问etcd(Access etcd)

put 写操作:

etcdctl --endpoints=$ENDPOINTS put foo "Hello World!"

 

get 读操作:

etcdctl --endpoints=$ENDPOINTS get foo
etcdctl --endpoints=$ENDPOINTS --write-out="json" get foo

前缀查找(Get by prefix)

 

etcdctl --endpoints=$ENDPOINTS put web1 value1
etcdctl --endpoints=$ENDPOINTS put web2 value2
etcdctl --endpoints=$ENDPOINTS put web3 value3

etcdctl --endpoints=$ENDPOINTS get web --prefix

删除操作(Delete)

 

etcdctl --endpoints=$ENDPOINTS put key myvalue
etcdctl --endpoints=$ENDPOINTS del key

etcdctl --endpoints=$ENDPOINTS put k1 value1
etcdctl --endpoints=$ENDPOINTS put k2 value2
etcdctl --endpoints=$ENDPOINTS del k --prefix

事务(Transactional write)

etcd中事务是原子执行的，只支持if … then … else …这种表达，类似三元表达式:

 

etcdctl --endpoints=$ENDPOINTS put user1 bad
etcdctl --endpoints=$ENDPOINTS txn --interactive

compares:
value("user1") = "bad"      

success requests (get, put, delete):
del user1  

failure requests (get, put, delete):
put user1 good

监听(Watch)

watch to get notified of future changes:

 

etcdctl --endpoints=$ENDPOINTS watch stock1
etcdctl --endpoints=$ENDPOINTS put stock1 1000

etcdctl --endpoints=$ENDPOINTS watch stock --prefix
etcdctl --endpoints=$ENDPOINTS put stock1 10
etcdctl --endpoints=$ENDPOINTS put stock2 20

租约(Lease)

lease to write with TTL:

 

etcdctl --endpoints=$ENDPOINTS lease grant 300
# lease 2be7547fbc6a5afa granted with TTL(300s)

etcdctl --endpoints=$ENDPOINTS put sample value --lease=2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS get sample

etcdctl --endpoints=$ENDPOINTS lease keep-alive 2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS lease revoke 2be7547fbc6a5afa
# or after 300 seconds
etcdctl --endpoints=$ENDPOINTS get sample

分布式锁(Distributed locks)

lock for distributed lock:

 

etcdctl --endpoints=$ENDPOINTS lock mutex1

# another client with the same name blocks
etcdctl --endpoints=$ENDPOINTS lock mutex1

选举(Elections)

elect for leader election:

 

etcdctl --endpoints=$ENDPOINTS elect one p1

# another client with the same name blocks
etcdctl --endpoints=$ENDPOINTS elect one p2

集群状态监控(Cluster status)

健康状态检查

 

etcdctl --write-out=table --endpoints=$ENDPOINTS endpoint status

+------------------+------------------+---------+---------+-----------+-----------+------------+
|     ENDPOINT     |        ID        | VERSION | DB SIZE | IS LEADER | RAFT TERM | RAFT INDEX |
+------------------+------------------+---------+---------+-----------+-----------+------------+
| 10.240.0.17:2379 | 4917a7ab173fabe7 | 3.0.0   | 45 kB   | true      |         4 |      16726 |
| 10.240.0.18:2379 | 59796ba9cd1bcd72 | 3.0.0   | 45 kB   | false     |         4 |      16726 |
| 10.240.0.19:2379 | 94df724b66343e6c | 3.0.0   | 45 kB   | false     |         4 |      16726 |
+------------------+------------------+---------+---------+-----------+-----------+------------+

 

etcdctl --endpoints=$ENDPOINTS endpoint health

10.240.0.17:2379 is healthy: successfully committed proposal: took = 3.345431ms
10.240.0.19:2379 is healthy: successfully committed proposal: took = 3.767967ms
10.240.0.18:2379 is healthy: successfully committed proposal: took = 4.025451ms

快照(Snapshot)

snapshot 用于保存etcd数据库的快照:

 

etcdctl --endpoints=$ENDPOINTS snapshot save my.db

Snapshot saved at my.db

 

etcdctl --write-out=table --endpoints=$ENDPOINTS snapshot status my.db

+---------+----------+------------+------------+
|  HASH   | REVISION | TOTAL KEYS | TOTAL SIZE |
+---------+----------+------------+------------+
| c55e8b8 |        9 |         13 | 25 kB      |
+---------+----------+------------+------------+

(迁移)Migrate

migrate 用于将v2迁移到v3:

 

# write key in etcd version 2 store
export ETCDCTL_API=2
etcdctl --endpoints=http://$ENDPOINT set foo bar

# read key in etcd v2
etcdctl --endpoints=$ENDPOINTS --output="json" get foo

# stop etcd node to migrate, one by one

# migrate v2 data
export ETCDCTL_API=3
etcdctl --endpoints=$ENDPOINT migrate --data-dir="default.etcd" --wal-dir="default.etcd/member/wal"

# restart etcd node after migrate, one by one

# confirm that the key got migrated
etcdctl --endpoints=$ENDPOINTS get /foo

集群成员管理(Member)

member 用于添加，删除，更新成员:

 

# For each machine
TOKEN=my-etcd-token-1
CLUSTER_STATE=new
NAME_1=etcd-node-1
NAME_2=etcd-node-2
NAME_3=etcd-node-3
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_3=10.240.0.15
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

# For node 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 \
    --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 \
    --listen-client-urls http://${THIS_IP}:2379 \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} \
    --initial-cluster-token ${TOKEN}

# For node 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 \
    --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 \
    --listen-client-urls http://${THIS_IP}:2379 \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} \
    --initial-cluster-token ${TOKEN}

# For node 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 \
    --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 \
    --listen-client-urls http://${THIS_IP}:2379 \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} \
    --initial-cluster-token ${TOKEN}

然后使用命令 member remove 和 member add替换成员:

 

# get member ID
export ETCDCTL_API=3
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_3=10.240.0.15
etcdctl --endpoints=${HOST_1}:2379,${HOST_2}:2379,${HOST_3}:2379 member list

# remove the member
MEMBER_ID=278c654c9a6dfd3b
etcdctl --endpoints=${HOST_1}:2379,${HOST_2}:2379,${HOST_3}:2379 \
    member remove ${MEMBER_ID}

# add a new member (node 4)
export ETCDCTL_API=3
NAME_1=etcd-node-1
NAME_2=etcd-node-2
NAME_4=etcd-node-4
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_4=10.240.0.16 # new member
etcdctl --endpoints=${HOST_1}:2379,${HOST_2}:2379 \
    member add ${NAME_4} \
    --peer-urls=http://${HOST_4}:2380

接下来启动新成员，使用--initial-cluster-state标志:

 

# [WARNING] If the new member starts from the same disk space,
# make sure to remove the data directory of the old member
# [警告] 如果新成员和旧成员使用同一个磁盘空间，需要先清除旧成员的历史数据
#
# restart with 'existing' flag
TOKEN=my-etcd-token-1
CLUSTER_STATE=existing
NAME_1=etcd-node-1
NAME_2=etcd-node-2
NAME_4=etcd-node-4
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_4=10.240.0.16 # new member
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_4}=http://${HOST_4}:2380

THIS_NAME=${NAME_4}
THIS_IP=${HOST_4}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
    --initial-advertise-peer-urls http://${THIS_IP}:2380 \
    --listen-peer-urls http://${THIS_IP}:2380 \
    --advertise-client-urls http://${THIS_IP}:2379 \
    --listen-client-urls http://${THIS_IP}:2379 \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} \
    --initial-cluster-token ${TOKEN}

权限(Auth)

auth,user,role for authentication:

 

export ETCDCTL_API=3
ENDPOINTS=localhost:2379

etcdctl --endpoints=${ENDPOINTS} role add root
etcdctl --endpoints=${ENDPOINTS} role grant-permission root readwrite foo
etcdctl --endpoints=${ENDPOINTS} role get root

etcdctl --endpoints=${ENDPOINTS} user add root
etcdctl --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=root:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
etcdctl --endpoints=${ENDPOINTS} --user=root:123 get foo
etcdctl --endpoints=${ENDPOINTS} --user=root:123 get foo1

 

~橘子~
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
etcd 集群搭建及常用场景分析
zhojhon的博客
08-31 4万+
概述 etcd 是一个分布式一致性k-v存储系统，可用于服务注册发现与共享配置，具有以下优点。 简单 ： 相比于晦涩难懂的paxos算法，etcd基于相对简单且易实现的raft算法实现一致性，并通过gRPC提供接口调用 安全：支持TLS通信，并可以针对不同的用户进行对key的读写控制 高性能：10,000 /秒的写性能 1. etcd单机模式 单机模式的etcd
etcd的应用举例
jinyuttt的专栏
05-10 301
1.服务发现 （1) 先用LeaseGrant获取租约ID; (2)Key:系统名称/服务名称/服务版本/服务唯一ID Value：服务地址 （3）用Put方法存储并有租约 （4）定时用LeaseKeepAlive方法刷新 这样服务发现和心跳都有了 2.订阅发布 （1）创建Topic节点 （2）用put方法在该节点下发布值：key:主题名称 value:数据的 （3）订阅方用WatchRange方法监视Topic节点 3.负责均衡 类似服...
etcd集群部署
wyl9527的博客
05-26 1047
etcd是一个Go语言编写的分布式、高可用的一致性键值存储系统,用于提供可靠的分布式键值(keyvalue)存储、配置共享和服务发现等功能。etcd官网文档地址。
单个虚拟机部署三个etcd实例/一个ectd实例
weixin_37871174的博客
09-14 1106
1、安装etcd:yum install etcd 2、查看etcd版本：etcd --version 3、在一个目录下创建三个文件(etcd1_conf.yml,etcd2_conf.yml,etcd2_conf.yml)和三个文件夹(etcd1/data,etcd2/data,etcd3/data)分别存放三个etcd实例的配置文件和其对应的运行目录。 etcd1_conf.yml内容 name: etcd1 data-dir: /home/test/etcd_conf/etcd1..
etcd官方教程
weixin_30823683的博客
02-16 167
This series of examples shows the basic procedures for working with an etcd cluster. Set up a cluster On each etcd node, specify the cluster members: TOKEN=token-01 CLUSTER_STATE=new NAME_1=mac...
Etcdctl工具-管理操作etcd集群
因上努力，果上随缘。但行好事，莫问前程。
09-13 5191
etcd就是个分布式非关系型数据库.3 个节点组成的集群，可以容忍 1 个节点故障。生成环境中，不推荐使用单个节点的 etcd 集群。
etcd-terraform-example:示例演示如何使用 Terraform 创建自我发现的 Etcd 集群
05-31
此 repo 演示了使用 Terraform 创建自我发现的 Etcd 集群。 Google 是此处使用的云提供商，但 CoreOS 和 Terraform 支持的任何其他云提供商也能正常工作（例如 AWS）。 有关更多背景信息，请参阅。 要求 地形 一个...
etcd:安装ETCD集群的角色
05-28
角色名称 ... 要求 Ansible本身或角色未涵盖的任何前提条件都应在此处提及。...包括一个如何使用您的角色的示例（例如，将变量作为参数传递）也总是对用户有利的： - hosts: servers roles: - { role: ansible-e
kubeadm初始化高可用k8s1.20.4集群-etcd集群独立在k8s集群外-kubernetes安装包和详细文档笔记整理
最新发布
05-29
在本主题中，我们将深入探讨如何使用`kubeadm`工具来初始化一个高可用性的Kubernetes（k8s）1.20.4集群，其中etcd集群独立于k8s集群之外运行。这对于确保数据存储的稳定性和可扩展性至关重要。etcd是Kubernetes的...
Go 版本 Etcd 客户端操作 Etcd
03-23
在 Go 语言环境下，通过官方提供的客户端库，我们可以方便地进行 Etcd 的各种操作，如写入、读取、监听和更新元数据。本文将深入探讨如何使用 Go 语言客户端来操作 Etcd。 首先，我们要导入 Etcd 的 Go 客户端库。...
基于外部etcd+部署容器版kubernetes1.25.14集群资源合集
09-19
这些图片可能包括etcd集群的架构图、Kubernetes部署流程图、命令行输出示例等。 值得注意的是，Kubernetes 1.25.14版本可能引入了一些新的特性和增强。例如，可能有新的API对象、调度器优化、网络策略增强，或者是...
Etcd官网文档中文版.pdf
04-12
Etcd官网文档中文版.pdf Etcd官网文档中文版.pdf Etcd官网文档中文版.pdf
node-etcd:Node.js的Etcd客户端
04-13
节点等 用coffee-script编写的nodejs库。 安装 对于> = 6.x的节点： $ npm install node-etcd 对于节点4.x <=节点<6.x： $ npm install node-etcd@6 对于0.10.x <= nodejs <= 4.x和iojs： $ npm install node-etcd@5.1.0 对于nodejs == 0.8： $ npm install node-etcd@3.0.2 变化 7.0.0 修复漏洞 删除对Node.js版本4和4的支持 6.0.0 从下划线迁移到lodash以提高性能/ @derektbrown 更新的软件包版本/ @derektbrown 更新去同步调用以获取较新的节点版本/ @derektbrown 添加伊斯坦布尔报道报告/ @derektbrown 5.1.0 升级deas
etcd官方docker镜像及dockerfile问题处理
m0_37570494的博客
01-12 926
当然我还尝试了，在镜像打包好，然后把etcd_server在docker容器中直接手动启动，这个是无法解决的，由于docker中该服务并没有启动，所以端口没有暴露出去。此处算是把etcd的docker镜像部署收尾了。
Etcd集群的搭建以及分析
热门推荐
m0_37997046的博客
11-10 1万+
etcd的架构 从 etcd 的架构图中我们可以看到，etcd 主要分为四个部分。 HTTP Server： 用于处理用户发送的 API 请求以及其它 etcd 节点的同步与心跳信息请求。 Store：用于处理 etcd 支持的各类功能的事务，包括数据索引、节点状态变更、监控与反馈、事件处理与执行等等，是 etcd 对用户提供的大多数 API 功能的具体实现。 Raft：Raft 强一致性算法...
Etcd集群搭建和使用简介
weixin_34015860的博客
08-07 280
Etcd集群搭建 环境信息 主机1 主机2 主机3 10.25.72.164 10.25.72.233 10.25.73.196 安装etcd yum install -y etcd 安装etcd 配置第一台 编辑etcd配置文件 vim /etc/etcd/etcd.conf ETCD_DATA_DIR="/var/lib/etcd/def...
云原生微服务治理etcd应用实战
fegus的博客
07-13 1082
我很早就关注了微服务架构，对云原生、微服务、容器化、分布式中间件等都有过深入的研究，同时带领公司团队从零开始，基于 Kubernetes 搭建较为完善的开发、运维部署和容器调度的平台。目前公司的整体业务都在基于这一套架构运行，这让我在 etcd 作为服务注册与发现中心、分布式键值对存储等场景中，积累了大量的实践经验。互联网应用经历了从早期单一架构到垂直架构，再到分布式架构的技术发展过程。在业务体系不断发展变化，用户体量和性能要求远非传统行业所能比拟的当下，越来越多的公司跨入了分布式、云原生架构的行列，分布式
ETCD_WEB_demo
u013328965的博客
01-15 260
从零开始搭建etcd分布式存储系统+web管理界面 什么是ETCD 随着CoreOS和Kubernetes等项目在开源社区日益火热，它们项目中都用到的etcd组件作为一个高可用、强一致性的服务发现存储仓库，渐渐为开发人员所关注。 在云计算时代，如何让服务快速透明地接入到计算集群中，如何让共享配置信息快速被集群中的所有机器发现， 更为重要的是，如何构建这样一套高可用、安全、易于部署以及...
kubeadm-config.yaml使用外部etcd集群如何编写
05-12
如果您想在 Kubernetes 集群中使用外部 etcd 集群，需要在 kubeadm-config.yaml 文件中指定 etcd 集群的地址和端口号。以下是一个示例 kubeadm-config.yaml 文件，其中包含了外部 etcd 集群的配置： ``` apiVersion...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值