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":""}