Apollo 统一配置中心

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)依赖

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
        <groupId>com.ctrip.framework.apollo</groupId>
            <artifactId>apollo-client</artifactId>
            <version>1.6.0</version>
        </dependency>
        <!-- 为了编码方便,并非apollo 必须的依赖 -->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.8.1</version>
        </dependency>
</dependencies>
<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.ctrip.framework.apollo</groupId>
                <artifactId>apollo-client</artifactId>
                <version>1.2.0</version>
            </dependency>
        </dependencies>
</dependencyManagement>

  (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<String> 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是企业生产级配置中心,使用范围更广

原文地址:https://www.cnblogs.com/baby123/p/12765304.html