分布式配置管理中心Apollo
1.简介
Apollo(阿波罗)是一款可靠的分布式配置管理中心,诞生于携程框架研发部,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性,适用于微服务配置管理场景。
服务端基于Spring Boot和Spring Cloud开发,打包后可以直接运行,不需要额外安装Tomcat等应用容器。
Java客户端不依赖任何框架,能够运行于所有Java运行时环境,同时对Spring/Spring Boot环境也有较好的支持。
.Net客户端不依赖任何框架,能够运行于所有.Net运行时环境。
2.特点
①统一管理不同环境、不同集群的配置
l Apollo提供了一个统一界面集中式管理不同环境(environment)、不同集群(cluster)、不同命名空间(namespace)的配置。
l 同一份代码部署在不同的集群,可以有不同的配置,比如zk的地址等
l 通过命名空间(namespace)可以很方便的支持多个不同应用共享同一份配置,同时还允许应用对共享的配置进行覆盖
l 配置界面支持多语言(中文,English)
②配置修改实时生效(热发布)
l 用户在Apollo修改完配置并发布后,客户端能实时(1秒)接收到最新的配置,并通知到应用程序。
③版本发布管理
l 所有的配置发布都有版本概念,从而可以方便的支持配置的回滚。
④灰度发布
l 支持配置的灰度发布,比如点了发布后,只对部分应用实例生效,等观察一段时间没问题后再推给所有应用实例。
⑤权限管理、发布审核、操作审计
l 应用和配置的管理都有完善的权限管理机制,对配置的管理还分为了编辑和发布两个环节,从而减少人为的错误。
l 所有的操作都有审计日志,可以方便的追踪问题。
⑥客户端配置信息监控
l 可以方便的看到配置在被哪些实例使用
⑦提供Java和.Net原生客户端
l 提供了Java和.Net的原生客户端,方便应用集成
l 支持Spring Placeholder,Annotation和Spring Boot的ConfigurationProperties,方便应用使用(需要Spring 3.1.1+)
l 同时提供了Http接口,非Java和.Net应用也可以方便的使用
⑧提供开放平台API
l Apollo自身提供了比较完善的统一配置管理界面,支持多环境、多数据中心配置管理、权限、流程治理等特性。
l 不过Apollo出于通用性考虑,对配置的修改不会做过多限制,只要符合基本的格式就能够保存。
l 在我们的调研中发现,对于有些使用方,它们的配置可能会有比较复杂的格式,如xml, json,需要对格式做校验。
l 还有一些使用方如DAL,不仅有特定的格式,而且对输入的值也需要进行校验后方可保存,如检查数据库、用户名和密码是否匹配。
l 对于这类应用,Apollo支持应用方通过开放接口在Apollo进行配置的修改和发布,并且具备完善的授权和权限控制
⑨部署简单
l 配置中心作为基础服务,可用性要求非常高,这就要求Apollo对外部依赖尽可能地少
l 目前唯一的外部依赖是MySQL,所以部署非常简单,只要安装好Java和MySQL就可以让Apollo跑起来
l Apollo还提供了打包脚本,一键就可以生成所有需要的安装包,并且支持自定义运行时参数
3. 快速开始
3.1.准备工作
l Java
Apollo服务端与客户端都要求1.8+
如需运行在 Java 1.7 运行时环境,请使用 1.x 版本的 apollo 客户端,如 1.9.1
l MySQL
版本要求:5.6.5+
Apollo的表结构对timestamp使用了多个default声明,所以需要5.6.5以上版本。
l 下载安装包
GitHub下载:https://github.com/nobodyiam/apollo-build-scripts
百度网盘下载:https://pan.baidu.com/share/init?surl=Ieelw6y3adECgktO0ea0Gg 提取码:9wwe
下载下来解压即可
3.2.安装步骤
l 导入数据
Apollo服务端需要创建2个数据库,ApolloPortalDB和ApolloConfigDB
l 配置数据库连接信息
编辑demo.sh文件,修改数据库连接信息
#apollo config db info apollo_config_db_url="jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8&serverTimezone=Asia/Shanghai" apollo_config_db_username=用户名 apollo_config_db_password=密码
# apollo portal db info apollo_portal_db_url="jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8&serverTimezone=Asia/Shanghai" apollo_portal_db_username=用户名 apollo_portal_db_password=密码 |
3.3.启动Apollo配置中心
在linux上使用 ./demo.sh start启动,看到如下输出表示启动成功
==== starting service ==== Service logging file is ./service/apollo-service.log Started [10768] Waiting for config service startup....... Config service started. You may visit http://localhost:8080 for service status now! Waiting for admin service startup.... Admin service started ==== starting portal ==== Portal logging file is ./portal/apollo-portal.log Started [10846] Waiting for portal startup...... Portal started. You can visit http://localhost:8070 now! |
我使用的是docker安装,
clone代码https://github.com/apolloconfig/apollo/tree/master/scripts/docker-quick-start
直接在目录中执行命令docker-compose up即可,看到上面的输出就代表成功
3.4.使用apollo配置中心
访问http://localhost:8070/,输入用户名apollo,密码admin后登录
添加配置,然后发布
4.在springboot中使用
新建一个springboot项目,导入apollo的依赖
<dependency> <groupId>com.ctrip.framework.apollo</groupId> <artifactId>apollo-client</artifactId> <version>1.7.0</version> </dependency> |
application.yml配置文件
app: id: hrm #配置文件的Appid apollo: meta: http://localhost:8080 #config-server地址 docker部署的要在参数中指定地址 bootstrap: enabled: true #是否开启 Apollo eagerLoad: enabled: true # 将Apollo加载提到初始化日志系统之前 namespaces: application #指定使用哪个Namespace 的配置,默认 application spring: application: name: apollo-test server: port: 8088 |
控制层Controller
package cn.demo.web.controller;
import org.springframework.beans.factory.annotation.Value; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController;
@RestController public class ApolloController {
@Value("${username:default}") private String username;
@GetMapping("/") public String list() { System.out.println(username); return "获取到的配置:" + username; } } |
在idea中指定环境配置
启动测试,访问接口看能不能获取到apollo的配置而非默认值