一个基于Docker的工具,用于将Spring Boot和Micronaut属性文件加载到Consul K/V存储,支持热重载、文件系统和Git模式,便于配置管理与同步。
9 次收藏下载次数: 0状态:自动构建维护者:jhipster仓库类型:镜像最近更新:
Consul Config Loader
一个基于Docker的小型工具,用于将Spring Boot和/或Micronaut属性文件加载到Consul K/V存储。它支持热重载以及文件系统和Git模式。
核心功能与特性
- 多框架支持:兼容Spring Boot和Micronaut框架,可通过环境变量控制启用状态
- 热重载:自动检测文件变更并同步到Consul K/V存储
- 文件系统模式:监控本地
config/目录下的YAML文件,实时同步到Consul - Git模式:基于https://github.com/Cimpress-MCP/git2consul项目,适合生产环境,支持从Git仓库加载配置
- ACL安全:支持Consul ACL功能,通过主令牌创建客户端令牌,保障KV访问和服务发现的安全性
支持框架配置
默认仅启用Spring Boot支持,可通过以下环境变量控制框架兼容性:
ENABLE_SPRING:是否启用Spring Boot支持,值为true或falseENABLE_MICRONAUT:是否启用Micronaut支持,值为true或false
使用场景
- 开发环境:使用文件系统模式,实时同步本地配置文件到Consul,便于开发调试
- 生产环境:使用Git模式,通过Git仓库管理配置,实现版本控制和集中化配置管理
使用方法
文件系统模式
在此模式下,工具会将config/目录下的所有YAML属性文件推送到Consul K/V存储,并自动检测文件新增或修改以重新加载。
配置步骤
-
在
bootstrap.yml中配置Consul:yamlspring: cloud: consul: config: format: yaml profile-separator: "-" -
启动Consul服务器和配置加载器:
bashdocker-compose -f quickstart/consul-loader-filesystem.yml up -
访问Consul UI查看同步的配置:http://localhost:8500/ui/#/dc1/kv/config/
Git模式
此模式是https://github.com/Cimpress-MCP/git2consul项目的封装,推荐用于生产环境。
配置步骤
-
在
bootstrap.yml中配置Consul:yamlspring: cloud: consul: config: fail-fast: true format: files profile-separator: "-" -
配置
config/git2consul.json文件,指定Git仓库信息 -
启动Consul和配置加载器:
bashdocker-compose -f quickstart/consul-loader-git.yml up
ACL安全配置
工具要求Consul启用ACL功能,并通过环境变量提供令牌:
MASTER_ACL_TOKEN:主ACL令牌,用于创建客户端ACL令牌CLIENT_ACL_TOKEN:客户端ACL令牌,用于KV读取和服务发现写入(默认策略)
注意:MASTER_ACL_TOKEN和CLIENT_ACL_TOKEN必须不同,建议使用随机字符串(如UUID)作为令牌值。
应用配置
在JHipster或Spring Cloud应用中,通过bootstrap.yml配置客户端令牌:
yamlconsul: token: my-client-acl-token
参考链接
- https://cloud.spring.io/spring-cloud-consul/#spring-cloud-consul-config
- https://www.consul.io/docs/agent/http/kv.html
- https://github.com/Cimpress-MCP/git2consul
jhipster 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 consul-config-loader 镜像标签
docker pull docker.xuanyuan.run/jhipster/consul-config-loader:<标签>
DockerHub 原生拉取命令
docker pull jhipster/consul-config-loader:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务