在预生产环境跑了一年多,在此记录和分享一下。
问题 & 其他方案
当我们需要在多台服务器部署多个不同的项目时,我们需要一个集中的配置信息管理和同步的工具。考虑过的方案有:
- 用rsync同步
.env
文件:多个项目的配置略繁琐,要ssh到服务器修改再同步 - 用Docker:集群部署比较方便,可以用图形界面修改环境变量,但是更新环境变量要重启容器,大部分项目没迁移到Docker
下面看一下Consul + Consul Template的方案。
安装
Consul和Consul Template都提供了预编译的可执行文件,下载解压即可。
启动Consul:
consul agent -server -bootstrap -ui -bind <ip>
其他服务节点可以通过consul agent -join <ip>
加入到集群。
启动之后通过consul命令、RESTful API、Web UI管理Consul。
Consul KV
Consul提供了一个分布式的键值对存储,可以用来存储应用的动态配置信息,基本操作:
# put 设置一个KV对
consul kv put APP_DEBUG false
# get 获取
consul kv get APP_DEBUG
# exprot 导出JSON
consul kv export > data.json
# import 导入JSON
consul kv import @data.json
# delete 删除
consul kv delete APP_DEBUG
Consul KV支持目录,可以通过/
分隔key实现,例如我们使用configs/<app_name>/
这样的目录来存放一个项目的所有配置。
Consul Template
配置集中管理了,怎样传给Laravel呢?一个方法是在Laravel里用Consul的API获取配置信息,第二个发放是在外部监听KV变化然后写入到.env
文件,Consul Template就是这样的一个外部工具。
我们用的配置模板(.env.tpl
):
{{ range ls "configs/crm" }}
{{ .Key }}={{ .Value }}{{ end }}
意思是遍历config/crm
这个KV目录,生成key=value
格式。
运行:
## 格式: 模板文件:目标文件:更新后执行的命令
consul-template --template \
/path/to/.env.tpl:/path/to/.env:'php /path/to/artisan config:cache'
就可以生成.env文件,并且持续监听变化,一个consul-template实例可以有多个--template多个参数,可以为一台服务器上多个项目生成配置文件。