柚子快报邀请码778899分享:Apollo 统一配置中心

http://www.51969.com/

Apollo(阿波罗)是携程框架部门研发的开源配置管理中心

能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性

地址 https://github.com/ctripcorp/apollo

特性

统一管理不同环境、不同集群的配置

配置修改实时生效(热发布)

版本发布管理

灰度发布

权限管理、发布审核、操作审计

客户端配置信息监控

提供Java和.Net原生客户端

提供开放平台API

部署简单

Apollo架构图

Config Service提供配置的读取、推送等功能,服务对象是Apollo客户端

Admin Service提供配置的修改、发布等功能,服务对象是Apollo Portal(管理界面)

Config Service和Admin Service都是多实例、无状态部署,所以需要将自己注册到Eureka中并保持心跳

在Eureka之上架了一层Meta Server用于封装Eureka的服务发现接口

  Client通过域名访问Meta Server获取Config Service服务列表(IP+Port),而后直接通过IP+Port访问服务,同时在Client侧会做load balance、错误重试

  Portal通过域名访问Meta Server获取Admin Service服务列表(IP+Port),而后直接通过IP+Port访问服务,同时在Portal侧会做load balance、错误重试

为了简化部署,会把Config Service、Eureka和Meta Server三个逻辑角色部署在同一个JVM进程中

1.搭建 Apollo 配置中心

参照 https://github.com/ctripcorp/apollo/wiki/Quick-Start 

  (1)下载Quick Start安装包

  (2)创建Apollo服务端需要两个数据库

    ApolloPortalDB

    ApolloConfigDB

  (3)解压Quick Start安装包,修改demo.sh数据库配置

# apollo config db info

apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8

apollo_config_db_username=root

apollo_config_db_password=root

# apollo portal db info

apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8

apollo_portal_db_username=root

apollo_portal_db_password=root

  (4)服务启动与关闭

在git下执行启动脚本

./demo.sh start

关闭

./demo.sh stop

  (5)浏览器打开http://localhost:8070/

 

   输入用户名 apollo,密码 admin

http://localhost:8080/

 2.spring boot集成

  (1)依赖

org.springframework.boot

spring-boot-starter-web

com.ctrip.framework.apollo

apollo-client

1.6.0

org.apache.commons

commons-lang3

3.8.1

com.ctrip.framework.apollo

apollo-client

1.2.0

  (2)启动类

package com.xyz.provider;

import com.ctrip.framework.apollo.spring.annotation.EnableApolloConfig;

import org.springframework.boot.SpringApplication;

import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication

@EnableApolloConfig

public class ProviderApplication {

public static void main(String[] args) {

SpringApplication.run(ProviderApplication.class, args);

}

}

  (3)配置

server.port=8010

spring.application.name=service-provider

# 应用全局唯一的身份标识

app.id = springboot-apollo

# Apollo Meta Server 地址

apollo.meta = http://localhost:8080

# 自定义本地配置文件缓存路径

apollo.cacheDir = ./config

# 设置在应用启动阶段就加载 Apollo 配置

apollo.bootstrap.enabled = true

# 注入 application namespace

apollo.bootstrap.namespaces = application

apollo.bootstrap.eagerLoad.enabled = true

logging.level.com.xyz.provider.controller=debug

order.discount = 75

说明:

app.id:AppId是应用的身份信息,是配置中心获取配置的一个重要信息

apollo.bootstrap.enabled:在应用启动阶段,向Spring容器注入被托管的application.properties文件的配置信息

apollo.bootstrap.eagerLoad.enabled:将Apollo配置加载提到初始化日志系统之前

logging.level.com.xyz.provider.controller:调整 controller 包的 log 级别,用来在配置中心动态配置日志级别

  (4)控制器

package com.xyz.provider.controller;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.beans.factory.annotation.Value;

import org.springframework.web.bind.annotation.GetMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController

public class HelloController {

private static Logger logger = LoggerFactory.getLogger(HelloController.class);

@Value("${server.port}")

String port;

@Value(("${order.discount}"))

Integer discount;

@GetMapping("hello")

public String hello(String name) {

logger.debug("debug log...");

logger.info("info log...");

logger.warn("warn log...");

return "hello " + name + " ,i am from port:" + port + ",discount:" + discount;

}

}

    启动项目

GET http://localhost:8010/hello?name=beibei

返回 

hello beibei ,i am from port:8011,discount:75

  (5)配置

    创建项目

 说明:

部门:选择应用所在的部门

应用AppId:用来标识应用身份的唯一id,格式为string,需要和客户端application.properties中配置的app.id对应

应用名称:应用名,仅用于界面展示

应用负责人:选择的人默认会成为该项目的管理员,具备项目权限管理、集群创建、Namespace创建等权限

  新增配置

     发布配置

    编辑完配置后,需要发布配置,才能生效

   发布后再次请求http://localhost:8010/hello?name=beibei

  返回 hello beibei ,i am from port:8011,discount:50

说明:

  服务的端口依然还是 8010,因为 apollo 修改配置,不会像Spring Cloud Config 那样去重启应用

  重启应用后,客户端会使用配置中心中配置的端口

GET http://localhost:8011/hello?name=beibei  

返回

hello beibei ,i am from port:8011,discount:50

控制台输出

2020-05-27 11:19:48.064 DEBUG 14880 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : debug log...2020-05-27 11:19:48.064 INFO 14880 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : info log...2020-05-27 11:19:48.064 WARN 14880 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : warn log...

  配置日志等级

说明:

  在配置中心修改日志等级,发布后也没法立即生效,需要重启应用

重启后

GET http://localhost:8011/hello?name=beibei  

控制台输出

2020-05-27 11:21:57.780 INFO 13200 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : info log...2020-05-27 11:21:57.780 WARN 13200 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : warn log...

  添加监听

package com.xyz.provider.config;

import com.ctrip.framework.apollo.Config;

import com.ctrip.framework.apollo.model.ConfigChangeEvent;

import com.ctrip.framework.apollo.spring.annotation.ApolloConfig;

import com.ctrip.framework.apollo.spring.annotation.ApolloConfigChangeListener;

import org.apache.commons.lang3.StringUtils;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.boot.logging.LogLevel;

import org.springframework.boot.logging.LoggingSystem;

import org.springframework.context.annotation.Configuration;

import javax.annotation.PostConstruct;

import java.util.Set;

@Configuration

public class LoggerConfig {

private static final Logger logger = LoggerFactory.getLogger(LoggerConfig.class);

private static final String LOGGER_TAG = "logging.level.";

@Autowired

private LoggingSystem loggingSystem;

@ApolloConfig

private Config config;

@ApolloConfigChangeListener

private void configChangeListter(ConfigChangeEvent changeEvent) {

refreshLoggingLevels();

}

@PostConstruct

private void refreshLoggingLevels() {

Set keyNames = config.getPropertyNames();

for (String key : keyNames) {

if (StringUtils.containsIgnoreCase(key, LOGGER_TAG)) {

String strLevel = config.getProperty(key, "info");

LogLevel level = LogLevel.valueOf(strLevel.toUpperCase());

loggingSystem.setLogLevel(key.replace(LOGGER_TAG, ""), level);

logger.info("{}:{}", key, strLevel);

}

}

}

}

说明:

@ApolloConfig注解:将Apollo服务端的中的配置注入到这个类中

@ApolloConfigChangeListener注解:监听配置中心配置的更新事件,若该事件发生,则调用refreshLoggingLevels方法处理该事件

ConfigChangeEvent:获取被修改配置项的key集合,以及被修改配置项的新值、旧值和修改类型等信息

重启项目应用

修改配置logging.level.com.xyz.provider.controller为warn

GET http://localhost:8011/hello?name=beibei  

控制台输出

2020-05-27 11:26:18.211  WARN 4636 --- [nio-8011-exec-4] c.x.provider.controller.HelloController  : warn log...

Apollo与SpringCloud Config的对比

 

 Apollo

 Spring Cloud Config

 配置界面

 同一界面管理不同环境/集群配置

 无,通过git操作

 配置生效时间

 实时

 重启生效,或Refresh,git hook+MQ

 版本管理

 界面尚志杰提供发布历史和回滚按钮

 无

 灰度发布

 支持

 不支持

 授权/审计/审核

 界面直接操作,且支持修改和发布权限分离

 需要通过git仓库设置,且不支持修改和发布权限分离

 实时配置监控

可以方便看到当前那些客户端在使用哪些配置 

 不支持

 配置获取性能

 快

 较慢

 客户端支持

 原生支持Java/.Net,提供API,支持Spring annotation

 Spring应用+annotation支持

 

 

 

 

 

Apollo是企业生产级配置中心,使用范围更广

柚子快报邀请码778899分享:Apollo 统一配置中心

http://www.51969.com/

查看原文