什么是配置?

服务运行时能够通过外部动态修改的参数既是配置。在运行时动态变更服务的行为,避免业务发生变更需要修改代码或重启服务等等。

什么是 duic?

duic 是配置管理中心,将配置统一管理提供标准的配置格式及编辑方式。

设计目标是统一不同应用的配置管理方式,打造更人性化的配置编辑方式,提供更灵活的配置获取方式。


如上图:duic 支持任何应用,任何语言的配置管理(Java,Go,Android,Web等),同时 duic 采用 YAML 语法作用配置文件格式,支持数据类型及结构化配置。


如上图采用 YAML 编辑好配置之后通过 RESTful 接口获取配置(PS:官方目前已经提供Java、Android、Go语言的SDK,后期还会支持更多语言)。

为什么采用 YAML 作为配置格式?

YAML 是一种通用的数据格式

YAML 支持结构化配置能够弥补 properties 这类单纯 key=value 格式的不足

YAML 支持数据类型

YAML 支持引用

YAML 支持注释

YAML 可读性高

特性

支持 MongoDB,MySQL,PostgreSQL,Oracle 存储配置信息

配置修改实时更新

支持多配置合并

支持按需获取配置

支持历史版本比较

支持配置克隆

支持用户权限控制

支持 IP/Token 访问限制

支持 Docker

部署

开箱即用,duic 每个 release 版本都可以通过 GitHub Releases 获取 jar 包部署,或者你可以在 Docker Hub 获取 Docker 镜像直接部署。你只需要关注如何使用 duic,而无需关心内部的实现细节,当然你如果对实现细节感兴趣,非常欢迎帮忙审查代码,你的帮助可以让 duic 的代码变得更加精练。

MySQL 部署

在 GitHub Releases 页下载最新版本的 duic-x.x.x.jar 文件。

前提

Java >= 1.8

MySQL >= 5.6

创建数据库

CREATE DATABASE IF NOT EXISTS `duic` CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

配置数据库连接

application.yml

spring:

datasource:

url: jdbc:mysql://127.0.0.1:3306/duic?autoReconnect=true&useServerPrepStmts=true

username: root

password: root

PS:将 application.yml 文件与 duic-x.x.x.jar 文件放置在同一目录中。

duic 是采用 spring-boot 开发,配置文件目录完成遵守 spring-boot 默认加载方式,更多关于 spring-boot 配置可以了解

启动服务

java -Dspring.profiles.active=mysql -jar duic.jar

输出如下日志时,恭喜你 duic 已经启动成功。

______ _ ______

|_ _ `. (_) .' ___ |

| | `. \ __ _ __ / .' \_|

| | | |[ | | | [ || |

_| |_.' / | \_/ |, | |\ `.___.'\

|______.' '.__.'_/[___]`.____ .'

:: duic :: (v1.5.2-SNAPSHOT)

2018-05-03 07:06:05,980 INFO i.z.d.server.Application$Companion - Starting Application.Companion v1.5.2-SNAPSHOT on ubuntu with PID 47440 (/opt/duic/duic.jar started by zy in /opt/duic)

2018-05-03 07:06:05,984 INFO i.z.d.server.Application$Companion - The following profiles are active: mysql,prod

2018-05-03 07:06:09,595 INFO r.i.netty.tcp.BlockingNettyContext - Started HttpServer on /0:0:0:0:0:0:0:0%0:7777

2018-05-03 07:06:09,596 INFO o.s.b.w.e.netty.NettyWebServer - Netty started on port(s): 7777

2018-05-03 07:06:09,600 INFO i.z.d.server.Application$Companion - Started Application.Companion in 4.192 seconds (JVM running for 4.864)

登录控制台编辑你的第一个配置吧

http://[IP]:7777/index.html

PS:记得将 IP 替换为你服务的 IP。

关于 duic 部署在这里就写这么多了,有任何问题请给我留言,我将一一解答,更多关于 duic 部署方面的内容,大家可以参考官方提供的文档 DuiC Wiki。

使用

登录并创建你的第一个配置


spring-boot 加载配置

添加 Maven 依赖

io.zhudy.duic

duic-spring-cloud-config-client

2.0.1

添加 Gradle 依赖

compile "io.zhudy.duic:duic-spring-cloud-config-client:2.0.1"

在 bootstrap.yml 配置文件中添加获取配置信息

duic:

spring:

cloud:

config:

uri: https://duic.zhudy.io/api/v1

name: hello

profile: first

# token: [TOKEN]

uri 配置中心地址前缀

name 配置名称

profile 配置环境名称,多个采用,分隔

配置完成后在 spring-boot 项目中即可使用 @ConfigurationProperties @Value 方式注入配置依赖,duic 并没有提供任何自定义注解,完全遵守 spring-boot 的编程习惯,无缝接入及移除 duic。

spring 加载配置

添加 Maven 依赖

io.zhudy.duic

duic-spring-cloud-config-client

2.0.1

添加 Gradle 依赖

compile "io.zhudy.duic:duic-spring-cloud-config-client:2.0.1"

配置完成 spring bean 之后在项目中即可使用 @Value 注入配置,完全兼容 spring 编程习惯,支持配置热加载。

go 加载配置

引入 duic-go-client 依赖包

go get -u github.com/zhudyos/duic-go-client

初始化配置信息

duic.BaseUri = "https://duic.zhudy.io/api/v1"

duic.Name = "hello"

duic.Profiles = "first"

duic.Init()

获取配置

duic.Bool("key") // 获取一个 bool 配置

duic.Int("key") // 获取一个 int 配置

duic.Float64("key") // 获取一个 float64 配置

duic.String("key") // 获取一个 string 配置

duic.Array("key") // 获取一个数组配置

duic.Object("key") // 获取一个对象配置

结语