Apollo分布式配置中心使用

使用背景

当前我们项目,所有的配置都在存放在本地的propertise 文件进行配置,如各种链接url、端口、密码等,当我们需要切换环境调整参数的时候,我们必须手动修改这些配置、但这就带来了一个痛点,配置文件增多,采用分布式部署,导致需要每台机器都要更新,这个运维成本就高了,而且很容易出错,因此不得不引入一个分布式配置中心来解决这一痛点。

主流分布式配置中心介绍

Spring Cloud Config

2014年9月开源,Spring Cloud 生态组件,可以和Spring Cloud体系无缝整合。

Apollo

2016年5月,携程开源的配置管理中心,具备规范的权限、流程治理等特性。

Nacos

2018年6月,阿里开源的配置中心,也可以做DNS和RPC的服务发现。

Apollo(阿波罗)是携程框架部门研发的开源配置管理中心,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性。

参照图1

参照图2

准备工作(服务端)

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

在配置好后,可以通过如下命令检查:

使用命令查看JDK版本

样例输出:

JDK版本

1.2 MYSQL

版本要求:5.6.5+

Apollo的表结构对timestamp使用了多个default声明,所以需要5.6.5以上版本。

连接上MySQL后,可以通过如下命令检查:

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


创建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. 只更改配置的属性值并发布(不重启应用)


Apollo的事件被出发,说明配置成功跟新

10. 重新访问验证接口

属性更新成功

第一次写,写的不好,多多关照,欢迎小伙伴指出不足。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,185评论 6 503
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,652评论 3 393
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,524评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,339评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,387评论 6 391
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,287评论 1 301
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,130评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,985评论 0 275
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,420评论 1 313
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,617评论 3 334
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,779评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,477评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,088评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,716评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,857评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,876评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,700评论 2 354

推荐阅读更多精彩内容