Consul安装集群搭建

1 consul的安装和配置

1.1 consul agent 命令介绍

下载consul_1.0.0_linux_amd64.zip解压，里面只有一个consul可执行文件，其中，consul最常用到的命令是agent

输入consul agent -h 可以查看帮助。其中常见的参数解释如下：

 -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  

要想利用consul提供的服务实现服务的注册与发现，我们需要建立consul cluster。

在consul方案中，每个提供服务的节点上都要部署和运行consul的agent，所有运行consul agent节点的集合构成consul cluster。

consul agent有两种运行模式：server和client。这里的server和client只是consul集群层面的区分，与搭建在cluster之上的应用服务无关。

以server模式运行的consul agent节点用于维护consul集群的状态，官方建议每个consul cluster至少有3个或以上的运行在server mode的agent，client节点不限。

1.2 consul_1.0.0_linux_amd64安装

我们这里以安装三个节点为例，环境配置如下：

172.16.0.27 以server模式运行

172.16.0.26，192.168.1.72以client模式运行

1.2.1 配置consul

（三个节点依次按照下面的步骤配置consul）

将下载好的安装包上传到linux上，存放在/home/user/tools/cluster目录。

1） 把下载的consul_1.0.0_linux_amd64.zip文件解压

unzip -o -d ./ consul_1.0.0_linux_amd64.zip #解压到当前路径

2） 并把解压后的consul拷贝到/opt/consul目录，然后把/opt/consul目录加入到环境变量。（如果不是root用户，执行下面命名之前需要加上sudo）。

mkdir /opt/consul

cp consul /opt/consul

vim /etc/profile  

加入：export PATH=/opt/consul:$PATH

    source /etc/profile

1.2.2 运行

1：在172.16.0.27节点上面进行

cd /opt/consul

mkdir data

consul agent -server -bootstrap -bind=0.0.0.0 -client=172.16.0.27 -data-dir=data -ui -node=172.16.0.27

consul agent -server -bootstrap-expect 1 -data-dir data   -config-dir /etc/consul.d

这样，就启动了一个server节点 

2：在172.16.0.26节点上面进行

cd /opt/consul

sudo  mkdir data

sudo consul agent -bind=0.0.0.0 -client=172.16.0.26 -data-dir=data -node=172.16.0.26 -join=172.16.0.27 -ui

如果linux系统的防火墙没关，可能会报下面的错，需要将server跟client的防火墙都关闭：

centos7系统：

#查看默认防火墙状态（关闭后显示notrunning，开启后显示running）

firewall-cmd --state

使用如下命令关闭firewall：

systemctl stop firewalld.service #停止firewall

systemctl disable firewalld.service #禁止firewall开机启动

3：在另一个linux服务节点上面进行

1.2.3 验证

全部节点启动完之后

访问http://172.16.0.27:8500/  即可查看consul集群的管理页面

在任意节点执行consul members 即可查看集群节点信息。

这里在172.16.0.27节点执行

consul members -http-addr=”http://172.16.0.27:8500”

或者

consul members -http-addr=172.16.0.27:8500 

也可用：

curl localhost:8500/v1/catalog/nodes

等同于浏览器访问http://172.16.0.27:8500/v1/catalog/nodes：

1.2.4 关闭节点

1、consul leave -http-addr=172.16.0.26:8500

2、停止agent服务，在第一个终端中，你可以使用ctrl-c来优雅的停止agent，如果你停止的是client，当你优雅的离开后，consul会通知集群中的其他成员你这个节点以及处于left状态。如果你是强制killed掉agent，集群中的其他成员会认为你是failed了。当成员leaves后，该成员的services和checks会从catalog被移除，当成员fails后，该成员的健康状态会被简单的标记为critical，但是不会从catalog删除。consul会自动的尝试链接failed的节点，这样允许节点在某些网络状况中恢复，如果节点是left状态，则不会再联系该节点。

之前版本中默认server的http端口是8400，次consul1.0的http是8500

http://172.16.0.26:8500/v1/agent/service/consul-provider-client1/

http://172.16.0.27:8500/ui/consul-provider-client2

1.3使用命令注册服务

1. 创建文件夹/etc/consul.d

.d代表有许多配置文件在里面

2. 将服务配置文件写入文件夹内

如 $ echo '{"service": {"name": "web", "tags": ["rails"], "port": 80}}'  >/etc/consul.d/web.json

3. 重启consul，并将配置文件的路径给consul

$ consul agent -server -bootstrap-expect 1 -data-dir /tmp/consul   -config-dir /etc/consul.d

4. 查询ip和端口

DNS方式：dig @127.0.0.1 -p 8600 web.service.consul SRV

Http方式：curl http://localhost:8500/v1/catalog/service/web

5. 更新

通过http api能对service配置文件增删改查，如果更新完成后，可以通过signup命令来生效

consul agent -server -bootstrap -bind=0.0.0.0 -client=172.16.0.27 -data-dir=data -ui -node=172.16.0.27 -config-dir /etc/consul.d

consul agent -server -bootstrap -bind=0.0.0.0 -client=172.16.0.27 -data-dir=data -ui -node=172.16.0.27 -config-dir /etc/consul.d

Issue：

如果在配置 Consul的时候，出现了下面错误：

==> Error decoding '/etc/consul.d/hwapp_web.json': invalid character 'ï' lookingfor beginning of value

错误的原因是文件编码问题，需要将 Encoding修改为ANSI编码（可以用 TXT修改）。

使用curl操作 K/V

consul还提供了键/值存储的功能。

如 查询 所有K/V

curl -v http://localhost:8500/v1/kv/?recurse

保存键为web/key2, flags 为42， 值为true的记录。

curl -X PUT -d 'test' http://localhost:8500/v1/kv/web/key2?flags=42

true 

删除记录：

curl -X DELETE http://localhost:8500/v1/kv/web/sub?recurse

更新值：

curl -X PUT -d 'newval' http://localhost:8500/v1/kv/web/key1?cas=97

true

更新index：

curl "http://localhost:8500/v1/kv/web/key2?index=101&wait=5s"

结果：[{"CreateIndex":98,"ModifyIndex":101,"Key":"web/key2","Flags":42,"Value":"dGVzdA=="}]

转载：https://blog.csdn.net/u013719805/article/details/78843614