Consul Template 提供一個(gè)方便的方式從Consul服務(wù)獲取數(shù)據(jù)通過consul-template的后臺(tái)程序保存到文件系統(tǒng)，這個(gè)后臺(tái)進(jìn)程監(jiān)控Consul中數(shù)據(jù)的變化并更新任意數(shù)量的模板到文件系統(tǒng)。模板更新完成后consul-template也可以觸發(fā)相關(guān)的指令或者腳本，此處通過簡(jiǎn)單的實(shí)踐動(dòng)態(tài)更新Nginx的upstream server并且觸發(fā)reloadnginx服務(wù)。當(dāng)然對(duì)于小規(guī)模下的應(yīng)用場(chǎng)景還有很多，比如Haproxy配置文件動(dòng)態(tài)更新等。

這里小小的做個(gè)調(diào)查，你使用過以下那種方案：

下面，我們就開始今天的實(shí)踐目的吧，通過consul-template與consul完成nginx配置文件的自動(dòng)更新：

Docker部署Consul集群

實(shí)驗(yàn)版本信息:

準(zhǔn)備consul集群，你也可以使用單獨(dú)的一個(gè)consul實(shí)例做基礎(chǔ)環(huán)境的支撐，可以參考通過Docker一鍵部署consul集群

 

安裝consul-template以及基礎(chǔ)環(huán)境

此處，安裝下consul-template,然后運(yùn)行一個(gè)nginx容器，并且把nginx配置文件掛載到宿主機(jī)上:

wget https://releases.hashicorp.com/consul-template/0.20.0/consul-template_0.20.0_linux_amd64.zip
unzip consul-template_0.20.0_linux_amd64.zip
chmod +x consul-template
mv consul-template /usr/local/bin/
docker run -d --name nginx --restart=always -p 80:80 nginx:1.18
docker cp nginx:/etc/nginx /tmp/nginx
docker stop nginx && docker rm nginx
docker run -d --name nginx --restart=always -p 80:80 -v /tmp/nginx:/etc/nginx nginx:1.18

準(zhǔn)備一個(gè)腳本文件，當(dāng)consul-template從consul中獲取到數(shù)據(jù)的更新后，觸發(fā)該腳本運(yùn)行nginx_operator.sh，實(shí)現(xiàn)reloadnginx的配置文件。

#!/bin/sh
docker ps -aq --filter "name=nginx"
if [ $? -ne 0 ]; then
 echo "Starting Nginx Server..."
 docker run -d --name nginx --restart=always -p 80:80 -v /tmp/nginx:/etc/nginx nginx:1.18
 echo "nginx start done."
else
 echo "Reloading nginx..."
 docker exec -it nginx nginx -s reload;
 echo "nginx reloading done."
fi

接下來準(zhǔn)備consul-template運(yùn)行的配置文件nginx.hcl，里面通過source指定了我們要使用的模板文件，以及destination指定根據(jù)模板渲染后生成的配置文件存儲(chǔ)的路徑位置，最后一個(gè)command就是當(dāng)完成一次渲染后，要觸發(fā)的動(dòng)作，這里是一個(gè)腳本，就是會(huì)觸發(fā)該腳本的內(nèi)容。

wait {
  min = "3s"
  max = "9s"
}

syslog {
  enabled = true
  facility = "LOCAL5"
}

consul {
  address = "192.168.99.3:8500"
}

template {
  source = "/tmp/nginx/conf.d/consul/backend_nginx.ctmpl"
  destination = "/tmp/nginx/conf.d/consul/nginx01.conf"
  command = "/root/start_nginx.sh"
}

然后，需要準(zhǔn)備一下consul-template要監(jiān)聽的模板文件backend_nginx.ctmpl,consul-template可以同時(shí)指定多個(gè)模板文件，如下所示:

consul-template \
  -consul $consul_cluster_address:8500 \
  -template "$template1:$file1:$command1" \
  -template "$template2:$file2:$comand2" \
  -template "$template3:$file3"

此處只用一個(gè)模板做一下測(cè)試，模板的中的語(yǔ)法是go template語(yǔ)法，這里實(shí)現(xiàn)的比較簡(jiǎn)單，只是做了upstream.server的渲染，對(duì)于實(shí)際使用來說，可以把模板文件中的nginx1與server_name渲染的數(shù)據(jù)也存在consul集群中，這樣也是可以渲染的。

upstream nginx1 {
    server 127.0.0.1:2000 down;
    {{ range service "local.www@dc1" }}
    server {{.Address}}:{{.Port}} weight=1;
    {{end}}
}

server {
     listen 80;
     server_name www.kubemaster.top;
     location / {
         proxy_pass http://nginx1;
     }
}

在這個(gè)實(shí)驗(yàn)中，consul-template通過consul拿到變化后的數(shù)據(jù)，將數(shù)據(jù)成功的渲染到配置文件之后，我們可以通過www.kubeamster.top能正常訪問upstream后的服務(wù)，所以還需要準(zhǔn)備一個(gè)上游服務(wù)，這里直接使用docker快速的運(yùn)行一個(gè)即可

docker run -d --name nginx1 -p 8081:80 nginx:1.18
docker exec -it nginx1 bash
echo "backend server for consul-template" > /usr/share/nginx/html/index.html

此時(shí)，我們就可以把consul-template運(yùn)行起來，作為后端進(jìn)程運(yùn)行著:

[root@node1 consul]# consul-template -config "nginx.hcl" --log-level=info
2021/03/04 19:25:21 [DEBUG] (logging) enabling syslog on LOCAL5
2021/03/04 11:25:21.098622 [INFO] consul-template v0.20.0 (b709612c)
2021/03/04 11:25:21.098767 [INFO] (runner) creating new runner (dry: false, once: false)
2021/03/04 11:25:21.099244 [INFO] (runner) creating watcher
2021/03/04 11:25:21.101210 [INFO] (runner) starting
...

最后我們通過curl或者postman把運(yùn)行的nginx1服務(wù)往consul集群中注冊(cè)一下

curl --location --request PUT 'http://192.168.99.3:8500/v1/catalog/register' \
--header 'Content-Type: application/json' \
--data-raw '{"Datacenter": "dc1","Node": "721d401b9555","Address": "192.168.99.3","Service": { "Id": "172.17.0.12:80", "Service": "www","tags": [ "local" ],"Port": 8081}}'

通過hostctl增加一條本地DNS解析

 

最后，我們通過瀏覽器訪問一下http://www.kubemaster.top查看返回的內(nèi)容就是nginx1的服務(wù)。這說明consul-template按照預(yù)期完成了工作。

 

到這里，基本上完成了使用consul-template與consul實(shí)現(xiàn)nginx配置文件的自動(dòng)更新。