etcd的概念
etcd的目标是构建一个高可用的分布式键值( key-value )数据库,可以用在分布式系统中的各种配置信息管理,服务发现等,这里就不详细讨论了。
etcd的安装
我们介绍etcd的两种安装方式:
1.下载编译好的二进制文件
2.docker安装
下载编译好二进制文件
$ curl -L https://github.com/coreos/etcd/releases/download/v3.2.10/etcd-v3.2.10-linux-amd64.tar.gz -o etcd-v3.2.10-linux-amd64.tar.gz
$ tar xzvf etcd-v3.2.10-linux-amd64.tar.gz
$ cd etcd-v3.2.10-linux-amd64
解压后的文件夹目录结构:
其中etcd为服务主文件,etcdctl为客户端工具用于用户操作etcd。
运行etcd文件:
这时就可以使用etcdctl与服务通信了。
docker安装
由于我拉不下来官方的etcd,所以我选择自己制作etcd镜像
Dockerfile:
FROM alpine:latest
MAINTAINER YBC
RUN apk update && \
apk add --no-cache bash
COPY etcd /bin/
COPY etcdctl /bin/
EXPOSE 2379
EXPOSE 2380
CMD ["etcd"]
然后运动构建命令
docker build -t etcd:v1 .
这里镜像就构建好了,接下来就是运行容器了。
我最初是这样运行的:
docker run -d -p 2379:2379 -p 2380:2380 --name etcd etcd:v1
然后运行成功了
但是我发现在容器外用etcdctl并不能连接到容器中的etcd服务,即使是暴露了端口也不行,会报如下错误
然后用官方的启动方法
$ export NODE1=192.168.1.21
$ docker run --name etcd \
-p 2379:2379 \
-p 2380:2380 \
--volume=etcd-data:/etcd-data \
etcd:v1 \
etcd \
--data-dir=/etcd-data --name node1 \
--initial-advertise-peer-urls http://${NODE1}:2380 --listen-peer-urls http://0.0.0.0:2380 \
--advertise-client-urls http://${NODE1}:2379 --listen-client-urls http://0.0.0.0:2379 \
--initial-cluster node1=http://${NODE1}:2380
启动成功,并且可以连接
好了现在我们来分析一下原因,我们看到之前的启动日志
我们可以看到etcd服务默认是向localhost的同伴进行通信的,向localhost的客户端提供服务的,所以我们从主机连接容器中的etcd服务时由于不是本地连接,所以连接被拒绝了。
etcd常用参配置参数解释
–name:方便理解的节点名称,默认为 default,在集群中应该保持唯一,可以使用 hostname
–data-dir:服务运行数据保存的路径,默认为 ${name}.etcd
–snapshot-count:指定有多少事务(transaction)被提交时,触发截取快照保存到磁盘
–heartbeat-interval:leader 多久发送一次心跳到 followers。默认值是 100ms
–eletion-timeout:重新投票的超时时间,如果 follow 在该时间间隔没有收到心跳包,会触发重新投票,默认为 1000 ms
–listen-peer-urls:和同伴通信的地址(该结点监听通过该端口的来自该IP地址集的同伴的通信),比如 http://ip:2380,如果有多个,使用逗号分隔。需要所有节点都能够访问,所以不要使用 localhost!
–listen-client-urls:对外提供服务的地址(该结点通过该端口向来自该IP地址集的客户端提供服务):比如 http://ip:2379,http://127.0.0.1:2379,客户端会连接到这里和 etcd 交互
–advertise-client-urls:对外公告的该节点客户端监听地址,这个值会告诉集群中其他节点
–initial-advertise-peer-urls:该节点提供给同伴的监听地址,这个值会告诉集群中其他节点
–initial-cluster:集群中所有节点的信息,格式为 node1=http://ip1:2380,node2=http://ip2:2380,…。注意:这里的 node1 是节点的 --name 指定的名字;后面的 ip1:2380 是 --initial-advertise-peer-urls 指定的值
–initial-cluster-state:新建集群的时候,这个值为 new;假如已经存在的集群,这个值为 existing
–initial-cluster-token:创建集群的 token,这个值每个集群保持唯一。这样的话,如果你要重新创建集群,即使配置和之前一样,也会再次生成新的集群和节点 uuid;否则会导致多个集群之间的冲突,造成未知的错误
etcd数据库基本操作
put
$ etcdctl put /testdir/testkey "Hello world"
OK
get
获取指定键的值。例如
$ etcdctl put testkey hello
OK
$ etcdctl get testkey
testkey
hello
支持的选项为
--sort 对结果进行排序
--consistent 将请求发给主节点,保证获取内容的一致性
del
删除某个键值。例如
$ etcdctl del testkey
1
非数据库操作
watch
使用 etcdctl
298
监测一个键值的变化,一旦键值发生更新,就会输出最新的值。
例如,用户更新 testkey 键值为 Hello world 。
$ etcdctl watch testkey
PUT
testkey
2
member
通过 list 、 add 、 update 、 remove 命令列出、添加、更新、删除 etcd 实
例到 etcd 集群中。
例如本地启动一个 etcd 服务实例后,可以用如下命令进行查看。
$ etcdctl member list
422a74f03b622fef, started, node1, http://172.16.238.100:2380, ht
tp://172.16.238.100:23
docker搭建etcd集群
docker-compose.yml内容如下:
version: "3.6"
services:
node1:
image: etcd:v1
volumes:
- node1-data:/etcd-data
expose:
- 2379
- 2380
ports:
- "2379:2379"
- "2380:2380"
networks:
cluster_net:
ipv4_address: 172.16.238.100
environment:
- ETCDCTL_API=3
command:
- etcd
- --data-dir=/etcd-data
- --name
- node1
- --initial-advertise-peer-urls
- http://172.16.238.100:2380
- --listen-peer-urls
- http://0.0.0.0:2380
- --advertise-client-urls
- http://172.16.238.100:2379
- --listen-client-urls
- http://0.0.0.0:2379
- --initial-cluster
- node1=http://172.16.238.100:2380,node2=http://172.16.238.101:2380,node3=http://172.16.238.102:2380
- --initial-cluster-state
- new
- --initial-cluster-token
- docker-etcd
node2:
image: etcd:v1
volumes:
- node2-data:/etcd-data
expose:
- 2379
- 2380
networks:
cluster_net:
ipv4_address: 172.16.238.101
environment:
- ETCDCTL_API=3
command:
- etcd
- --data-dir=/etcd-data
- --name
- node2
- --initial-advertise-peer-urls
- http://172.16.238.101:2380
- --listen-peer-urls
- http://0.0.0.0:2380
- --advertise-client-urls
- http://172.16.238.101:2379
- --listen-client-urls
- http://0.0.0.0:2379
- --initial-cluster
- node1=http://172.16.238.100:2380,node2=http://172.16.238.101:2380,node3=http://172.16.238.102:2380
- --initial-cluster-state
- new
- --initial-cluster-token
- docker-etcd
node3:
image: etcd:v1
volumes:
- node3-data:/etcd-data
expose:
- 2379
- 2380
networks:
cluster_net:
ipv4_address: 172.16.238.102
environment:
- ETCDCTL_API=3
command:
- etcd
- --data-dir=/etcd-data
- --name
- node3
- --initial-advertise-peer-urls
- http://172.16.238.102:2380
- --listen-peer-urls
- http://0.0.0.0:2380
- --advertise-client-urls
- http://172.16.238.102:2379
- --listen-client-urls
- http://0.0.0.0:2379
- --initial-cluster
- node1=http://172.16.238.100:2380,node2=http://172.16.238.101:2380,node3=http://172.16.238.102:2380
- --initial-cluster-state
- new
- --initial-cluster-token
- docker-etcd
volumes:
node1-data:
node2-data:
node3-data:
networks:
cluster_net:
driver: bridge
ipam:
driver: default
config:
- subnet: 172.16.238.0/24
然后运行docker-compose up集群就启动了,用之前的方法去验证。