准备consul集群,你也可以使用单独的一个consul实例做基础环境的支撑,可以参考通过Docker一键部署consul集群
安装consul-template
以及基础环境
此处,安装下consul-template,然后运行一个nginx容器,并且把nginx配置文件挂载到宿主机上:
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
准备一个脚本文件,当consul-template从consul中获取到数据的更新后,触发该脚本运行nginx_operator.sh
,实现reload
nginx的配置文件。
#!/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
接下来准备consul-template运行的配置文件nginx.hcl
,里面通过source
指定了我们要使用的模板文件,以及destination
指定根据模板渲染后生成的配置文件存储的路径位置,最后一个command
就是当完成一次渲染后,要触发的动作,这里是一个脚本,就是会触发该脚本的内容。
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"
}
然后,需要准备一下consul-template要监听的模板文件backend_nginx.ctmpl
,consul-template可以同时指定多个模板文件,如下所示:
consul-template \
-consul $consul_cluster_address:8500 \
-template "$template1:$file1:$command1" \
-template "$template2:$file2:$comand2" \
-template "$template3:$file3"
此处只用一个模板做一下测试,模板的中的语法是go template
语法,这里实现的比较简单,只是做了upstream.server
的渲染,对于实际使用来说,可以把模板文件中的nginx1
与server_name
渲染的数据也存在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;
}
}
在这个实验中,consul-template通过consul拿到变化后的数据,将数据成功的渲染到配置文件之后,我们可以通过www.kubeamster.top
能正常访问upstream后的服务,所以还需要准备一个上游服务,这里直接使用docker快速的运行一个即可
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
此时,我们就可以把consul-template运行起来,作为后端进程运行着:
[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
把运行的nginx1
服务往consul集群中注册一下
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
查看返回的内容就是nginx1的服务。这说明consul-template按照预期完成了工作。
到这里,基本上完成了使用consul-template与consul实现nginx配置文件的自动更新。
本文分享自微信公众号 - 云原生生态圈(CloudNativeEcoSystem)。
如有侵权,请联系 [email protected] 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。