一、Consul官网
说明:https://www.consul.io/intro/
文档:https://www.consul.io/docs/commands/
二、Consul功能
Service Discovery 服务发现
Failure Detection 故障探测
Multi Datacenter 多数据中心
Key/Value Storage KV存储
三、配置环境
操作系统:CentOS 7.0
软件版本:consul-0.7.5
采用3节点consul server
192.168.1.101
192.168.1.102
192.168.1.103
192.168.1.104
101,102,103做server,104做client
(一).Server端
https://www.consul.io/intro/getting-started/agent.html
1.安装(所有节点)
wget https://releases.hashicorp.com/consul/0.7.5/consul_0.7.5_linux_amd64.zip
wget https://releases.hashicorp.com/consul/0.7.5/consul_0.7.5_web_ui.zip
mkdir /home/maxbill/consul/admin/
mkdir /home/maxbill/consul/webui/
unzip consul_0.7.5_linux_amd64.zip -d /home/maxbill/consul/admin/
unzip consul_0.7.5_web_ui.zip -d /home/maxbill/consul/webui/
注:/home/maxbill/consul/admin/和/home/maxbill/consul/webui/是我自定义的目录
2.配置server cluster
101节点
consul agent -server -bootstrap -ui-dir=../webui/ -data-dir=data -client=0.0.0.0 -node=101
提示:-bootstrap一般只在集群初始化时使用一次
单节点测试,还可以-bootstrap-expect=1来自我选举为leader
102节点
consul agent -server -ui-dir=../webui/ -data-dir=data -client=0.0.0.0
-join=192.168.192.101 -node=102
103节点
consul agent -server -ui-dir=../webui/ -data-dir=data -client=0.0.0.0
-join=192.168.192.101 -node=103
如果没有正常选出leader,可以手动触发bootstrap consul join 192.168.192.101
参数说明:https://www.consul.io/docs/agent/options.html
-advertise:通知展现地址用来改变我们给集群中的其他节点展现的地址,一般情况下-bind地址就是展现地
址
-bootstrap:用来控制一个server是否在bootstrap模式,在一个datacenter中只能有一个server处于
bootstrap模式,当一个server处于bootstrap模式时,可以自己选举为raft leader。
-bootstrap-expect:在一个datacenter中期望提供的server节点数目,当该值提供的时候,consul一直等
到达到指定sever数目的时候才会引导整个集群,该标记不能和bootstrap公用
-bind:该地址用来在集群内部的通讯,集群内的所有节点到地址都必须是可达的,默认是0.0.0.0
-client:consul绑定在哪个client地址上,这个地址提供HTTP、DNS、RPC等服务,默认是127.0.0.1
-config-file:明确的指定要加载哪个配置文件
-config-dir:配置文件目录,里面所有以.json结尾的文件都会被加载
-data-dir:提供一个目录用来存放agent的状态,所有的agent允许都需要该目录,该目录必须是稳定的,
系统重启后都继续存在
-dc:该标记控制agent允许的datacenter的名称,默认是dc1
-encrypt:指定secret key,使consul在通讯时进行加密,key可以通过consul keygen生成,同一个集群中
的节点必须使用相同的key
-join:加入一个已经启动的agent的ip地址,可以多次指定多个agent的地址。如果consul不能加入任何指
定的地址中,则agent会启动失败,默认agent启动时不会加入任何节点。
-retry-join:和join类似,但是允许你在第一次失败后进行尝试。
-retry-interval:两次join之间的时间间隔,默认是30s
-retry-max:尝试重复join的次数,默认是0,也就是无限次尝试
-log-level:consul agent启动后显示的日志信息级别。默认是info,可选:trace、debug、info、warn、
err。
-node:节点在集群中的名称,在一个集群中必须是唯一的,默认是该节点的主机名
-protocol:consul使用的协议版本
-rejoin:使consul忽略先前的离开,在再次启动后仍旧尝试加入集群中。
-server:定义agent运行在server模式,每个集群至少有一个server,建议每个集群的server不要超过5个
-syslog:开启系统日志功能,只在linux/osx上生效
-ui-dir:提供存放web ui资源的路径,该目录必须是可读的
-pid-file:提供一个路径来存放pid文件,可以使用该文件进行SIGINT/SIGHUP(关闭/更新)agent
端口说明:
dns - The DNS server, -1 to disable. Default 8600.
http - The HTTP API, -1 to disable. Default 8500.
https - The HTTPS API, -1 to disable. Default -1 (disabled).
rpc - The CLI RPC endpoint. Default 8400.
serf_lan - The Serf LAN port. Default 8301.
serf_wan - The Serf WAN port. Default 8302.
server - Server RPC address. Default 8300.
[root@admin]# consul version
Consul v0.7.5
Consul Protocol: 3 (Understands back to: 1)
[root@admin]# netstat -tunlp|grep consul
tcp6 0 0 :::8300 :::* LISTEN 2581/consul
tcp6 0 0 :::8301 :::* LISTEN 2581/consul
tcp6 0 0 :::8302 :::* LISTEN 2581/consul
tcp6 0 0 :::8400 :::* LISTEN 2581/consul
tcp6 0 0 :::8500 :::* LISTEN 2581/consul
tcp6 0 0 :::8600 :::* LISTEN 2581/consul
udp6 0 0 :::8600 :::* 2581/consul
udp6 0 0 :::8301 :::* 2581/consul
udp6 0 0 :::8302 :::* 2581/consul
https://www.consul.io/docs/agent/http/status.html
[root@admin]# curl localhost:8500/v1/status/leader
"192.168.192.101:8300"
[root@admin]# curl localhost:8500/v1/status/peers
["192.168.192.101:8300","192.168.192.102:8300","192.168.192.103:8300"]
3.web ui
因为所有consul server都安装有web ui,因此,任意一台consul server节点都可以查看
二.Client端
1.安装
和server一致
2.配置consul agent
104节点
consul agent -data-dir=data -client=0.0.0.0 -join=192.168.192.101 -node=104
**说明:**客户端没有-server参数,web ui也可省略
[root@admin]# consul members
Node Address Status Type Build Protocol DC
101 192.168.192.101:8301 alive server 0.7.5 2 dc1
102 192.168.192.102:8301 alive server 0.7.5 2 dc1
103 192.168.192.103:8301 alive server 0.7.5 2 dc1
104 192.168.192.104:8301 alive client 0.7.5 2 dc1