广告
返回顶部
首页 > 资讯 > 后端开发 > Python >SpringBoot整合Apollo配置中心快速使用详解
  • 598
分享到

SpringBoot整合Apollo配置中心快速使用详解

2024-04-02 19:04:59 598人浏览 八月长安

Python 官方文档:入门教程 => 点击学习

摘要

目录一、简介二、使用1. 测试项目搭建2. Apollo配置中心的配置3. 项目启动与测试4.常见整合问题附录一、简介 1.Apollo 是什么?Apollo(阿波罗)是携程框架部门

一、简介

1.Apollo 是什么?Apollo(阿波罗)是携程框架部门研发的分布式配置中心。服务端基于Spring Bootspring cloud开发

2.为什么要使用Apollo?

  • 安全性:配置跟随源代码保存在代码库中,容易造成配置泄漏
  • 时效性:普通方式配置,修改配置,需要重启服务才能生效
  • 局限性:无法支持动态调整:例如日志开关、功能开关

二、使用

1. 测试项目搭建

注:本文主要介绍SpringBoot 整合 Apollo 实现动态配置

1.1 添加Maven依赖


<dependency>
  <groupId>com.ctrip.framework.apollo</groupId>
  <artifactId>apollo-client</artifactId>
  <version>1.3.0</version>
</dependency>

1.2 配置文件


# apollo集成
# apollo 配置应用的 appid
app.id=springboot-apollo-demo1
# apollo meta-server地址,一般同config-server地址
apollo.meta=Http://192.168.0.153:8080
#启用apollo配置开关
apollo.bootstrap.enabled=true
apollo.bootstrap.eagerLoad.enabled=true
# apollo 使用配置的命名空间,多个以逗号分隔
apollo.bootstrap.namespaces = application

配置说明:

  • app.id:在配置中心配置的应用身份信息。
  • apollo.bootstrap.enabled:在应用启动阶段是否向Spring容器注入被托管的properties文件配置信息。
  • apollo.bootstrap.eagerLoad.enabled:将Apollo配置加载提到初始化日志系统之前。
  • apollo.bootstrap.namespaces:配置的命名空间,多个逗号分隔,一个namespace相当于一个配置文件。
  • **apollo.meta:**当前环境服务配置地址,生产环境建议至少双节点,可以填写多个逗号分隔,使用一个单独的域,如 http://config.xxx.com(由Nginx等软件负载平衡器支持),而不是多个IP地址,因为服务器可能会扩展或缩小。

图示说明:

在这里插入图片描述

1.3 添加启动类


@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, DataSourceTransactionManagerAutoConfiguration.class})
public class SpringbootApolloApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringbootApolloApplication.class, args);
    }
}

1.4 添加配置开关类

基于@Value注解配置


@Component
public class ValueStyleProperty {

    @Value("${apollo.value.demoKey1}")
    private String demoKey1;


    @Value("${apollo.value.demoKey2}")
    private String demoKey2;
    //省略 get/set 方法
}

1.5 添加测试controller



@RestController
@RequestMapping("/value-style")
public class ValuePropertyController {

    @Autowired
    private ValueStyleProperty keyProperty;

    @Value("${server.port}")
    private String port;

    @Value("${apollo.bootstrap.namespaces:'application'}")
    private String namespaces;

    @GetMapping("/get")
    public Map<String, Object> getProperty() {
        Map<String, Object> map = new LinkedHashMap<>();
        map.put("port", port);
        map.put("namespaces", namespaces);
        map.put("demoKey1", keyProperty.getDemoKey1());
        map.put("demoKey2", keyProperty.getDemoKey2());
        return map;
    }
}

2. Apollo配置中心的配置

2.1 创建项目

在这里插入图片描述

2.2 填写配置信息

在这里插入图片描述

配置说明:

  • 部门:选择应用所在的部门。(可自定义部门)
  • 应用AppId:用来标识应用身份的唯一id,格式为string,需与application.properties中配置的app.id一致。
  • 应用名称:应用名,仅用于界面展示。
  • 应用负责人:选择的人默认会成为该项目的管理员,具备项目权限管理、集群创建、Namespace创建等权限。

项目配置主页截图

在这里插入图片描述

2.3 添加配置

2.3.1 表格形式单个添加

注:不能批量操作

在这里插入图片描述

在这里插入图片描述

2.3.2 文本形式批量添加

注:可实现批量操作

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

2.4 发布配置

注:配置只有发布后才会生效

在这里插入图片描述

点击发布按钮

在这里插入图片描述

2.5 多环境同步配置

注意事项:

通过同步配置功能,可以使多个环境、集群间的配置保持一致需要注意的是,同步完之后需要发布后才会对应用生效

点击同步配置

在这里插入图片描述

选择需要同步的配置,以及目标环境

在这里插入图片描述

点击同步

在这里插入图片描述

目标环境查看

在这里插入图片描述

3. 项目启动与测试

3.1 初始启动读取测试

在这里插入图片描述

3.2 自动更新属性测试

在这里插入图片描述

发布后控制台变化

在这里插入图片描述

测试输出值变化

在这里插入图片描述

4.常见整合问题

4.1@ConfigurationProperties注解整合Apollo不生效问题

示例配置类



@Component
@ConfigurationProperties(prefix = "apollo.first.config")
public class ConfigFirstProperty {

    
    private Integer oneNumber;

    
    private String oneStr;

    
    private Boolean oneEnableFlag;

    
    private BigDecimal oneTaxRate = new BigDecimal("0.03");
   //省略 get/set 方法

}

解决方案
添加监听配置


import com.ctrip.framework.apollo.model.ConfiGChange;
import com.ctrip.framework.apollo.model.ConfigChangeEvent;
import com.ctrip.framework.apollo.spring.annotation.ApolloConfigChangeListener;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.BeansException;
import org.springframework.context.ApplicationContext;
import org.springframework.context.ApplicationContextAware;
import org.springframework.stereotype.Component;
import org.springframework.cloud.context.environment.EnvironmentChangeEvent;


@Configuration
public class ApolloConfigListener implements ApplicationContextAware {

    
    private static final Logger LOGGER = LoggerFactory.getLogger(ApolloConfigListener.class);

    private ApplicationContext applicationContext;

   
    @ApolloConfigChangeListener
    private void onChange(ConfigChangeEvent changeEvent) {
        LOGGER.info("【Apollo-config-change】start");
        for (String key : changeEvent.changedKeys()) {
            ConfigChange change = changeEvent.getChange(key);
            LOGGER.info("key={} , propertyName={} , oldValue={} , newValue={} ", key, change.getPropertyName(), change.getOldValue(), change.getNewValue());
        }
        // 更新相应的bean的属性值,主要是存在@ConfigurationProperties注解的bean
        this.applicationContext.publishEvent(new EnvironmentChangeEvent(changeEvent.changedKeys()));

        LOGGER.info("【Apollo-config-change】end");
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }
}

4.2日志级别未更新问题

示例配置


logging.level.com.example=info

解决方案-日志监听器


import com.ctrip.framework.apollo.model.ConfigChange;
import com.ctrip.framework.apollo.model.ConfigChangeEvent;
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.boot.logging.LogLevel;
import org.springframework.boot.logging.LoggingSystem;
import org.springframework.context.annotation.Configuration;
import javax.annotation.Resource;


@Configuration
public class LoggerConfigListener {

    private static final Logger LOGGER = LoggerFactory.getLogger(LoggerConfigListener.class);
    private static final String LOGGER_TAG = "logging.level.";

    @Resource
    private LoggingSystem loggingSystem;

    
    @ApolloConfigChangeListener(interestedKeyPrefixes = LOGGER_TAG)
    private void onChangeLogger(ConfigChangeEvent changeEvent) {
        LOGGER.info("【Apollo-logger-config-change】>> start");
        refreshLoggingLevel(changeEvent);
        LOGGER.info("【Apollo-logger-config-change】>> end");
    }

    
    private void refreshLoggingLevel(ConfigChangeEvent changeEvent) {
        if (null == loggingSystem) {
            return;
        }
        for (String key : changeEvent.changedKeys()) {
            ConfigChange change = changeEvent.getChange(key);
            if (!StringUtils.containsIgnoreCase(key, LOGGER_TAG)) {
                continue;
            }
            LOGGER.info("【Apollo-logger-config-change】>> key={} , propertyName={} , oldValue={} , newValue={} ",
                    key, change.getPropertyName(), change.getOldValue(), change.getNewValue());
            String newLevel = change.getNewValue();
            LogLevel level = LogLevel.valueOf(newLevel.toUpperCase());
            loggingSystem.setLogLevel(key.replace(LOGGER_TAG, ""), level);
            LOGGER.info("【Apollo-logger-config-change】>> {} -> {}", key, newLevel);
        }
    }
}

4.3日志+配置类自动刷新整合监听

注:由于 4.1与4.2监听有重合,所以最好放在一起处理


import com.ctrip.framework.apollo.model.ConfigChange;
import com.ctrip.framework.apollo.model.ConfigChangeEvent;
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.BeansException;
import org.springframework.boot.logging.LogLevel;
import org.springframework.boot.logging.LoggingSystem;
import org.springframework.cloud.context.environment.EnvironmentChangeEvent;
import org.springframework.context.ApplicationContext;
import org.springframework.context.ApplicationContextAware;
import org.springframework.context.annotation.Configuration;
import javax.annotation.Resource;


@Configuration
public class ApolloConfigListener implements ApplicationContextAware {
    
    private static final Logger LOGGER = LoggerFactory.getLogger(ApolloConfigListener.class);
    
    private static final String LOGGER_TAG = "logging.level.";

    @Resource
    private LoggingSystem loggingSystem;

    private ApplicationContext applicationContext;

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }


    
    @ApolloConfigChangeListener
    private void onChangeConfig(ConfigChangeEvent changeEvent) {
        LOGGER.info("【Apollo-config-change】>> start");
        for (String key : changeEvent.changedKeys()) {
            ConfigChange change = changeEvent.getChange(key);
            LOGGER.info("【Apollo-config-change】>> key={} , propertyName={} , oldValue={} , newValue={} ",
                    key, change.getPropertyName(), change.getOldValue(), change.getNewValue());
            //是否为日志配置
            if (StringUtils.containsIgnoreCase(key, LOGGER_TAG)) {
                //日志配置刷新
                changeLoggingLevel(key, change);
                continue;
            }
            // 更新相应的bean的属性值,主要是存在@ConfigurationProperties注解的bean
            this.applicationContext.publishEvent(new EnvironmentChangeEvent(changeEvent.changedKeys()));
        }
        LOGGER.info("【Apollo-config-change】>> end");
    }

    
    private void changeLoggingLevel(String key, ConfigChange change) {
        if (null == loggingSystem) {
            return;
        }
        String newLevel = change.getNewValue();
        LogLevel level = LogLevel.valueOf(newLevel.toUpperCase());
        loggingSystem.setLogLevel(key.replace(LOGGER_TAG, ""), level);
        LOGGER.info("【Apollo-logger-config-change】>> {} -> {}", key, newLevel);
    }
}

4.4 其它问题

4.4.1配置文件与配置中心同时存在配置,启用的是那一份
apollo 配置开关开启情况下,配置中心配置会覆盖本地配置
注:配置开关 apollo.bootstrap.enabled=true

4.4.2 配置中心挂掉会影响已发布的项目吗?
项目启动后配置会存在缓存中,配置中心挂掉,已发布的项目不影响

4.4.3 是否支持更新端口配置
支持更新端口配置,但是必需要重启生效,同时也需要考虑服务器的端口占用问题。

附录

Apollo官方文档相关

官方源码地址:https://GitHub.com/ctripcorp/apollo
官方演示环境(Demo):

106.54.227.205
账号/密码:apollo/admin

快速搭建本地测试环境
分布式部署指南(生产环境建议使用)

到此这篇关于SpringBoot整合Apollo配置中心快速使用详解的文章就介绍到这了,更多相关SpringBoot整合Apollo配置内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

--结束END--

本文标题: SpringBoot整合Apollo配置中心快速使用详解

本文链接: https://www.lsjlt.com/news/136350.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑,方便收藏和打印~

下载Word文档
猜你喜欢
  • SpringBoot整合Apollo配置中心快速使用详解
    目录一、简介二、使用1. 测试项目搭建2. Apollo配置中心的配置3. 项目启动与测试4.常见整合问题附录一、简介 1.Apollo 是什么?Apollo(阿波罗)是携程框架部门...
    99+
    2022-11-12
  • 使用Springboot整合Apollo配置中心
    Apollo简介 Apollo(阿波罗)是携程框架部门研发的分布式配置中心,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理...
    99+
    2022-11-12
  • 如何使用Springboot整合Apollo配置中心
    本篇内容介绍了“如何使用Springboot整合Apollo配置中心”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!Apollo简介Apoll...
    99+
    2023-06-20
  • Springboot项目中使用redis的配置详解
    程序结构: 一、配置  1. 在pom.xml中添加依赖 pom.xml文件如下: <?xml version="1.0" encoding="UTF-...
    99+
    2022-11-12
  • SpringCloudConfig分布式配置中心使用介绍详解
    目录1、分布式配置中心应用场景2、Spring Cloud Config2.1、Config简介2.2、Config分布式配置应用2.3、构建Config Server统一配置中心2...
    99+
    2022-11-13
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作