使用背景
当前我们项目,所有的配置都在存放在本地的propertise 文件进行配置,如各种链接url、端口、密码等,当我们需要切换环境调整参数的时候,我们必须手动修改这些配置、但这就带来了一个痛点,配置文件增多,采用分布式部署,导致需要每台机器都要更新,这个运维成本就高了,而且很容易出错,因此不得不引入一个分布式配置中心来解决这一痛点。
主流分布式配置中心介绍
Spring Cloud Config
2014年9月开源,Spring Cloud 生态组件,可以和Spring Cloud体系无缝整合。
Apollo
2016年5月,携程开源的配置管理中心,具备规范的权限、流程治理等特性。
Nacos
2018年6月,阿里开源的配置中心,也可以做DNS和RPC的服务发现。
Apollo(阿波罗)是携程框架部门研发的开源配置管理中心,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性。
准备工作(服务端)
1.1 运行时环境
1.1.1 OS
服务端基于Spring Boot,启动脚本理论上支持所有Linux发行版,建议CentOS 7。
1.1.2 JAVA
Apollo服务端:1.8+
Apollo客户端:1.7+
由于需要同时运行服务端和客户端,所以建议安装Java 1.8+。
对于Apollo客户端,运行时环境只需要1.7+即可。
注:对于Apollo客户端,如果有需要的话,可以做少量代码修改来降级到Java 1.6,详细信息可以参考Issue 483
在配置好后,可以通过如下命令检查:
样例输出:
1.2 MYSQL
版本要求:5.6.5+
Apollo的表结构对timestamp使用了多个default声明,所以需要5.6.5以上版本。
连接上MySQL后,可以通过如下命令检查:
注1:MySQL版本可以降级到5.5,详见mysql 依赖降级讨论
导入Apollo的数据库脚本
下载Apollo的安装包
如果不需要定制,下载官方打包好的安装包即可:地址
开始部署
1.1 将下载好的安装包上传至服务器(OS),并解压
**1.2启动流程(configservice→adminservice→portal)
进入configservice的scripts目录,使用./startup.sh 启动configservice
进入adminservice的scripts目录,使用./startup.sh 启动adminservice
进入portal的scripts目录,使用./startup.sh 启动portal
没有执行权限请使用 chmod 777 *.sh 授予权限
异常排查请看: /opt/logs
1.3、停止
进入每个文件夹的scripts目录,使用**./shutdown.sh **停止。
1.4 修改配置文件
进入configservice的config目录,编辑application-github.properties(修改数据库连接)
进入configservice的scripts目录, 编辑startup.sh(修改启动端口)
进入adminservice的config目录,编辑application-github.properties(修改数据库连接)
进入adminservice的scripts目录, 编辑startup.sh(修改启动端口)
进入portal的config目录,编辑application-github.properties(修改数据库连接)
进入portal的config目录,编辑apollo-env.properties(修改protal指向的configservice地址)
进入portal的scripts目录, 编辑startup.sh(修改启动端口)
通过访问http://localhost:8070/可访问web页面的服务端。
初始账号/密码为:admin/apollo
----------------------------------------------------------------至此Apollo安装完成-----------------------------------
客户端使用(以Springboot为例:)
1.创建app
增加配置后会,点击发布后,Apollo才会通知客户端拉取最新的配置
2. 添加Apollo客户端依赖
<!-- https://mvnrepository.com/artifact/com.ctrip.framework.apollo/apollo-client -->
<dependency>
<groupId>com.ctrip.framework.apollo</groupId>
<artifactId>apollo-client</artifactId>
<version>1.4.0</version>
</dependency>
3.新建Springboot项目
4.修改propertise文件
server.port=9520
#应用ID
app.id=apolloapp
#此处是configservice的地址
apollo.meta=http://192.168.139.131:8080
#在应用启动阶段,向Spring容器注入被托管的application.properties文件的配置信息。
apollo.bootstrap.enabled=true
#指定namespace 多个用,隔开
apollo.bootstrap.namespaces=application
#指定环境
env=DEV
#指定配置的缓存路径(!!!当配置中心不可用的时候会加载本地配置,确保有访问权限)
apollo.cacheDir=/opt/apolloapp
5.开启Apollo的支持
在启动类中添加@EnableApolloConfig注解开启Apollo的支持
@SpringBootApplication
@EnableApolloConfig
public class ApollodemoApplication {
public static void main(String[] args) {
SpringApplication.run(ApollodemoApplication.class, args);
}
}
6. 编写相关验证类
/**
* Placeholder方式:
* 代码中直接使用,如:@Value("${name}")
*/
@Component
public class JavaBean {
@Value("${name}")
private String name;
public String getName() {
return name;
}
}
/**
* 查看配置是否生效
*/
@RestController
public class Restful {
protected Logger log = LoggerFactory.getLogger(Restful.class);
private JavaBean bean;
@Autowired
public Restful(JavaBean javaBean) {
this.bean = javaBean;
}
/**
* 获取配置
*
* @return
*/
@RequestMapping("/")
public String changer() {
return bean.getName();
}
/**
* Apollo的配置改变触发的事件
*
* @param changeEvent
*/
@ApolloConfigChangeListener
public void onChange(ConfigChangeEvent changeEvent) {
log.info("发生改变的key列表:{}", changeEvent.changedKeys());
}
}
7. 启动项目
8. 验证配置
访问:http://localhost:9520/
9. 只更改配置的属性值并发布(不重启应用)
10. 重新访问验证接口
第一次写,写的不好,多多关照,欢迎小伙伴指出不足。