Ubuntu16.04安装Consul

1.下载安装包

https://www.consul.io/downloads.html
wget https://releases.hashicorp.com/consul/1.5.3/consul_1.5.3_linux_amd64.zip

2.解压

unzip consul_1.5.3_linux_amd64.zip

3.mv

sudo mv consul /usr/local/bin/consul

4.启动

参考：https://blog.csdn.net/u010046908/article/details/61916389

-dev 开发模式启动的时候，数据是存储在内存中，重启以后数据将丢失

consul agent -dev

-server 生成模式启动的时候，若是是server的话须要指定-server，若是是client的话，须要指定-client，好比

consul agent -ui -server -bootstrap-expect 1 -data-dir /tmp/consul -node=consul-server -bind=192.168.1.100 -client=192.168.1.100

-bootstrap-expect 1 通知consul server咱们如今准备加入的server节点个数，该参数是为了延迟日志复制的启动直到咱们指定数量的server节点成功的加入后启动

-data-dir /tmp/consul 数据持久的路径

-node=consul-server 指定节点在集群中的名称

-bind=192.168.1.100 该地址用来在集群内部的通信，集群内的全部节点到地址都必须是可达的，默认是0.0.0.0，这意味着Consulo会使用第一个可用的私有IP地址，Consul可使用TCP和UDP而且可使用共同的端口，若是存在防火墙，这二者协议必须是容许的

-client 指定节点为client，指定客户端接口的绑定地址，包括：HTTP、DNS、RPC，默认是127.0.0.1，只容许回环接口访问，也就是本机访问，若是要想同一局域网内的其余机器访问，须要修改为本身的内网ip

server节点，指定client等于内网ip，统一局域网的机器能够访问，指定client=0.0.0.0，外网机器能够访问

nohup ./consul agent -ui -server -bootstrap-expect 1 -data-dir /home/dl/projects/consul-1.5.3/consul-data -node=xxx -client=xxx >> ./logs/consul.log 2>&1 &

client节点

nohup ./consul agent -ui -data-dir /home/dl/projects/consul-1.5.3/consul-data -node=xxx -bind=xxxx >> ./logs/consul.log 2>&1 &

join

./consul join server的ip

 

 

5.使用

访问8500端口

5.kv存储

consul支持经过HTTP API和经过CLI API将配置进行存储

put命令

consul kv put app1/config/parameter1 1
Success! Data written to: app1/config/parameter1

put成功以后，就能够在页面中看到该配置

具体数值

 

put以后可使用get命令来获取这个配置

consul kv get app1/config/parameter1
1

递归获取

consul kv get -recurse app1
app1/config/parameter1:1
app1/config/parameter2:2
app1/config/parameter3:3

删除

consul kv delete app1/config/parameter2 2

 

HTTP api

get kv

curl http://xxxx:8500/v1/kv/app1?recurse
[{"LockIndex":0,"Key":"app1/config/parameter1","Flags":0,"Value":"MQ==","CreateIndex":5986,"ModifyIndex":5986},{"LockIndex":0,"Key":"app1/config/parameter2","Flags":0,"Value":"Mg==","CreateIndex":5987,"ModifyIndex":5987}]

get单个

curl http://xxx:8500/v1/kv/app1/config/parameter1
[{"LockIndex":0,"Key":"app1/config/parameter1","Flags":0,"Value":"MQ==","CreateIndex":5986,"ModifyIndex":5986}]

其中kv存储的v的值是通过base64编码过的，须要进行解码

echo 'MQ==' | base64 -d
1

put kv

curl -X PUT -d '1111111' http://xxxx:8500/v1/kv/app1/config/parameter1

 

delete kv

curl -X DELETE -d http://xxx:8500/v1/kv/app1/config/parameter2

 

consul配置导入和导出

export命令

./consul kv export app1/config
[
	{
		"key": "app1/config/parameter1",
		"flags": 0,
		"value": "MTExMTExMWZmcmZmZg=="
	},
	{
		"key": "app1/config/parameter2",
		"flags": 0,
		"value": "Mg=="
	},
	{
		"key": "app1/config/parameter3",
		"flags": 0,
		"value": "Mw=="
	}
]

import命令

./consul kv import @test.json
Imported: app1/config/parameter4
Imported: app1/config/parameter5
Imported: app1/config/parameter6

 

 

watch

https://www.consul.io/docs/agent/watches.html

当配置更新能自动回调

须要写一个配置文件，好比 consul-watch.json

{
  "watches": [
    {
      "type": "key",
      "key": "app1/conf/parameter1",
      "handler_type": "http",
      "http_handler_config": {
         "path":"http://localhost:8000",
         "method": "GET",
         "header": {"x-foo":["bar", "baz"]},
         "timeout": "10s",
         "tls_skip_verify": false
      }
    }
  ]
}

上面的配置是监听单个key的变化，若是想监听多个

"type": "keyprefix",
"prefix": "app1/",

而后在启动命令中加上配置文件夹的地址，好比

-config-dir /home/lintong/software/consul-1.5.3/consul-conf

而后当配置发生变更的时候，会自动调用这个回调接口

若是修改了配置，好比把GET接口换成POST接口，须要reload这个配置，执行下面命令

consul reload

若是是post的回调接口的话，consul回调的时候会往post请求的request中放入更新的这一条配置，headers和body以下

Host: localhost:8000
User-Agent: Go-http-client/1.1
Content-Length: 124
Content-Type: application/json
X-Consul-Index: 5131
X-Foo: bar
X-Foo: baz
Accept-Encoding: gzip
Connection: close

{"Key":"app1/config/parameter1","CreateIndex":7,"ModifyIndex":5131,"LockIndex":0,"Flags":0,"Value":"IjEyMyI=","Session":""}