【轉載請註明出處】:https://developer.aliyun.com/article/760145
Consul-Template簡介
Consul-Template是基於Consul的自動替換配置文件的應用。在Consul-Template沒出現之前,大家構建服務發現系統大多采用的是Zookeeper、Etcd+Confd這樣類似的系統。
Consul官方推出了自己的模板系統Consul-Template後,動態的配置系統可以分化為Etcd+Confd和Consul+Consul-Template兩大陣營。Consul-Template的定位和Confd差不多,Confd的後端可以是Etcd或者Consul。
Consul-Template提供了一個便捷的方式從Consul中獲取存儲的值,Consul-Template守護進程會查詢Consul實例來更新系統上指定的任何模板。當更新完成後,模板還可以選擇運行一些任意的命令。
Consul-Template的使用場景
Consul-Template可以查詢Consul中的服務目錄、Key、Key-values等。這種強大的抽象功能和查詢語言模板可以使Consul-Template特別適合動態的創建配置文件。例如:創建Apache/Nginx Proxy Balancers、Haproxy Backends、Varnish Servers、Application Configurations等。
Consul-Template特性
- Quiescence:Consul-Template內置靜止平衡功能,可以智能的發現Consul實例中的更改信息。這個功能可以防止頻繁的更新模板而引起系統的波動。
- Dry Mode:不確定當前架構的狀態,擔心模板的變化會破壞子系統?無須擔心。因為Consul-Template還有Dry模式。在Dry模式,Consul-Template會將結果呈現在STDOUT,所以操作員可以檢查輸出是否正常,以決定更換模板是否安全。
- CLI and Config:Consul-Template同時支持命令行和配置文件。
- Verbose Debugging:即使每件事你都做的近乎完美,但是有時候還是會有失敗發生。Consul-Template可以提供更詳細的Debug日誌信息。
項目地址:https://github.com/hashicorp/consul-template
Consul-Template安裝
Consul-Template和Consul一樣,也是用Golang實現。因此具有天然可移植性(支持 Linux、windows 和macOS)。安裝包僅包含一個可執行文件。Consul-Template安裝非常簡單,只需要下載對應系統的軟件包並解壓後就可使用。
這裡以Linux系統為例:
$ wget https://releases.hashicorp.com/consul-template/0.18.3/consul-template_0.18.3_linux_amd64.zip
$ unzip consul-template_0.18.3_linux_amd64.zip
$ mv consul-template /usr/local/bin/
其它系統版本可在這裡下載:https://releases.hashicorp.com/consul-template/
Consul-Template常用命令
-consul-auth=<username[:password]> 設置基本的認證用戶名和密碼。
-consul-addr=<address> 設置Consul實例的地址。
-max-stale=<duration> 查詢過期的最大頻率,默認是1s。
-dedup 啟用重複數據刪除,當許多consul template實例渲染一個模板的時候可以降低consul的負載。
-consul-ssl 使用https連接Consul。
-consul-ssl-verify 通過SSL連接的時候檢查證書。
-consul-ssl-cert SSL客戶端證書發送給服務器。
-consul-ssl-key 客戶端認證時使用的SSL/TLS私鑰。
-consul-ssl-ca-cert 驗證服務器的CA證書列表。
-consul-token=<token> 設置Consul API的token。
-syslog 把標準輸出和標準錯誤重定向到syslog,syslog的默認級別是local0。
-syslog-facility=<facility> 設置syslog級別,默認是local0,必須和-syslog配合使用。
-template=<template> 增加一個需要監控的模板,格式是:'templatePath:outputPath(:command)',多個模板則可以設置多次。
-wait=<duration> 當呈現一個新的模板到系統和觸發一個命令的時候,等待的最大最小時間。如果最大值被忽略,默認是最小值的4倍。
-retry=<duration> 當在和consul api交互的返回值是error的時候,等待的時間,默認是5s。
-config=<path> 配置文件或者配置目錄的路徑。
-pid-file=<path> PID文件的路徑。
-log-level=<level> 設置日誌級別,可以是"debug","info", "warn" (default), and "err"。
-dry Dump生成的模板到標準輸出,不會生成到磁盤。
-once 運行consul-template一次後退出,不以守護進程運行。
Consul-Template使用實例
在進行以下測試前,你首先得有一個Consul集群。如果你還沒有,可搭建一個,當然單節點Consul環境也是可以的。
下面就以動態配置nginx為例來說明,還需要提前啟動好一個端口是8090的tomcat服務、安裝好Nginx。
1、先向Consul註冊服務
curl -X PUT http://127.0.0.1:8500/v1/catalog/register -d '{"Datacenter": "dc1","Node": "tomcat1","Address": "127.0.0.1","Service": { "Id": "127.0.0.1:8090", "Service": "api_tomcat1","tags": [ "dev" ],"Port": 8090}}'
查看註冊的信息
curl -X GET http://127.0.0.1:8500/v1/catalog/service/api_tomcat1
2、準備Nginx啟動腳本start_nginx.sh
#!/bin/sh
ps -ef |grep nginx |grep -v grep |grep -v .sh
if [ $? -ne 0 ]; then
nginx;
echo "nginx start"
else
nginx -s reload;
echo "nginx reload"
fi
3、在Nginx配置目錄/etc/nginx/conf.d/
準備一個空配置文件test-consul-template.conf
4、編寫Nginx配置文件模板nginx.conf.ctmpl
{{range services}} {{$name := .Name}} {{$service := service .Name}}
upstream {{$name}} {
zone upstream-{{$name}} 64k;
{{range $service}}server {{.Address}}:{{.Port}} max_fails=3 fail_timeout=60 weight=1;
{{else}}server 127.0.0.1:65535 down; # force a 502{{end}}
} {{end}}
server {
listen 80 default_server;
{{range services}} {{$name := .Name}}
location /{{$name}} {
proxy_pass http://{{$name}};
}
{{end}}
}
模板的語法可以參考官網 https://github.com/hashicorp/consul-template#templating-language
5、使用配置文件的方式啟動Consul-Template
編輯配置文件nginx.hcl
consul {
address = "127.0.0.1:8500"
}
template {
source = "nginx.conf.ctmpl"
destination = "/etc/nginx/conf.d/test-consul-template.conf"
command = "./start_nginx.sh"
}
6、啟動Consul-Template
consul-template -config "nginx.hcl"
7、測試
請求http://127.0.0.1/api_tomcat/info
已經通了。
【轉載請註明出處】:https://developer.aliyun.com/article/760145