Apollo原理分析及功能详解（配置管理、集群管理等）

最新推荐文章于 2025-03-05 10:05:54 发布
最新推荐文章于 2025-03-05 10:05:54 发布
阅读量6.8k 收藏 22
点赞数 4
分类专栏： 中间件 文章标签： spring cloud java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_41432730/article/details/122268606
版权
本文详细介绍了Apollo配置中心的工作原理、核心概念，包括应用、环境、集群和命名空间等，并展示了如何进行项目管理、配置管理、多项目配置、集群管理和配置发布。此外，还解析了配置发布的内部机制，包括通知客户端的实现方式和客户端的配置读取设计。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

官方文档：https://www.apolloconfig.com/#/zh/README

1. Apollo工作原理

下图是Apollo架构模块的概览：

image-20220101151226786

1.1 各模块职责

上图简要描述了Apollo的总体设计，我们可以从下往上看：

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

  • Admin Service提供配置的修改、发布等功能，服务对象是Apollo Portal（管理界面）

  • Eureka提供服务注册和发现，为了简单起见，目前Eureka在部署时和Config Service是在一个JVM进程中

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

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

  • Client通过域名访问Meta Server获取Confifig 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.2 分步执行流程

  1. Apollo启动后，Config/Admin Service会自动注册到Eureka服务注册中心，并定期发送保活心跳。

  2. Apollo Client和Portal管理端通过配置的Meta Server的域名地址经由Software Load Balancer(软件负载均衡器)进行负载均衡后分配到某一个Meta Server

  3. Meta Server从Eureka获取Config Service和Admin Service的服务信息，相当于是一个Eureka Client

  4. Meta Server获取Config Service和Admin Service（IP+Port）失败后会进行重试

  5. 获取到正确的Config Service和Admin Service的服务信息后，Apollo Client通过Config Service为应用提供配置获取、实时更新等功能；Apollo Portal管理端通过Admin Service提供配置新增、修改、发布等功能

2. 核心概念

  1. application (应用)

    这个很好理解，就是实际使用配置的应用，Apollo客户端在运行时需要知道当前应用是谁，从而可以去获取对应的配置

    关键字：appId

  2. environment (环境)

    配置对应的环境，Apollo客户端在运行时需要知道当前应用处于哪个环境，从而可以去获取应用的配置

    关键字：env

  3. cluster (集群)

    一个应用下不同实例的分组，比如典型的可以按照数据中心分，把上海机房的应用实例分为一个集群，把北京机房的应用实例分为另一个集群。

    关键字：cluster

  4. namespace (命名空间)

    一个应用下不同配置的分组，可以简单地把namespace类比为文件，不同类型的配置存放在不同的文件中，如数据库配置文件，RPC配置文件，应用自身的配置文件等

    关键字：namespaces

它们的关系如下图所示：

image-20220101152425486

3. 项目管理

3.1 基础设置

  1. 部门管理

    apollo 默认部门有两个。要增加自己的部门，可在系统参数中修改：

    • 进入系统参数设置

      image-20220101152550894

    • 输入key查询已存在的部门设置：organizations

      image-20220101152648069

    • 修改value值来添加新部门，下面添加一个微服务部门：

      [{"orgId":"TEST1","orgName":"样例部门1"},{"orgId":"TEST2","orgName":"样例部门2"},{"orgId":"micro_service","orgName":"微服务部门"}]

  2. 添加用户

    apollo默认提供一个超级管理员: apollo，可以自行添加用户。

    • 新建用户张三

      image-20220101152811464

      image-20220101152847345

3.2 创建项目

  1. 打开apollo-portal主页：http://localhost:8070/

  2. 点击“创建项目”：account-service

    image-20220101153001161

  3. 输入项目信息

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

应用AppId：用来标识应用身份的唯一id，格式为string，需要和项目配置文件applications.properties 中配置的app.id对应

应用名称：应用名，仅用于界面展示

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

image-20220101153116062

  1. 点击提交

    创建成功后，会自动跳转到项目首页

image-20220101153149259

  1. 赋予之前添加的用户张三管理account-service服务的权限

    • 使用管理员apollo将指定项目授权给用户张三

      image-20220101153221648

    • 将修改和发布权限都授权给张三

      image-20220101153411052

    • 使用zhangsan登录，查看项目配置

      image-20220101153633032

    • 点击account-service即可管理配置

3.3 删除项目

如果要删除整个项目，点击右上角的“管理员工具–》删除应用、集群…”

首先查询出要删除的项目，点击删除应用.

image-20220101153817368

4. 配置管理

下边在account-service项目中进行配置。

4.1 添加发布配置项

  1. 通过表格模式添加配置

    • 点击新增配置

      image-20220101153934082

    • 输入配置项：sms.enable，点击提交

      image-20220101154010389

  2. 通过文本模式编辑

    Apollo除了支持表格模式，逐个添加、修改配置外，还提供文本模式批量添加、修改。 这个对于从已有的properties文件迁移尤其有用。

    • 切换到文本模式

      image-20220101154109951

    • 输入配置项，并点击提交修改

      image-20220101154142264

  3. 发布配置

    image-20220101154203054

4.2 修改配置

  1. 找到对应的配置项，点击修改

image-20220101154252535

  1. 修改为需要的值，点击提交

  2. 发布配置

4.3 删除配置

  1. 找到需要删除的配置项，点击删除

image-20220101154345646

  1. 确认删除后，点击发布

image-20220101154501089

4.4 添加Namespace

Namespace作为配置的分类，可当成一个配置文件。

以添加rocketmq配置为例，添加“spring-rocketmq” Namespace配置rocketmq相关信息。

  1. 添加项目私有Namespace：spring-rocketmq

    进入项目首页，点击左下脚的“添加Namespace”，共包括两项：关联公共Namespace和创建Namespace，这里选择 创建Namespace

image-20220101154654620

  1. 添加配置项

    rocketmq.name‐server = 127.0.0.1:9876 
rocketmq.producer.group = PID_ACCOUNT

image-20220101154749812

  1. 发布配置

image-20220101154828387

4.5 公共配置

4.5.1 添加公共Namespace

在项目开发中，有一些配置可能是通用的，我们可以通过把这些通用的配置放到公共的Namespace中，这样其他项目要使用时可以直接添加需要的Namespace。

  1. 新建common-template项目

    image-20220101155036296

  2. 添加公共Namespace：spring-boot-http

    进入common-template项目管理页面添加命名空间

image-20220101155157205

  1. 添加配置项并发布

    spring.http.encoding.enabled = true 
spring.http.encoding.charset = UTF‐8 
spring.http.encoding.force = true 
server.tomcat.remote_ip_header = x‐forwarded‐for 
server.tomcat.protocol_header = x‐forwarded‐proto 
server.use‐forward‐headers = true
server.servlet.context‐path = /

    image-20220101155321961

4.5.2 关联公共Namespace

  1. 打开之前创建的account-service项目

  2. 点击左侧的添加Namespace

  3. 添加Namespace

image-20220101155513086

  1. 根据需求可以覆盖引入公共Namespace中的配置，下面以覆盖server.servlet.context-path为例

image-20220101155655282

image-20220101155823894

  1. 修改server.servlet.context-path为：/account-service

image-20220101155905007

  1. 发布修改的配置项

image-20220101155925928

5. 多项目配置

通常一个分布式系统包括多个项目，所以需要多个项目，下边以一个P2P金融的项目为例，添加交易中心微服务transaction-service。

  1. 添加交易中心微服务transaction-service

image-20220101160030055

  1. 关联公共Namespace

    任务应用都可以关联公共Namespace。

image-20220101160104017

  1. 覆盖配置，修改交易中心微服务的context-path为：/transaction
  2. 发布修改后的配置

6. 集群管理

在有些情况下，应用有需求对不同的集群做不同的配置，比如部署在A机房的应用连接的RocketMQ服务器地址和部署在B机房的应用连接的RocketMQ服务器地址不一样。另外在项目开发过程中，也可为不同的开发人员创建不同的集群来满足开发人员的自定义配置。

6.1 创建集群

  1. 点击页面左侧的“添加集群”按钮

image-20220101160940025

image-20220101161046128

  1. 切换到对应的集群，修改配置并发布即可

image-20220101161116803

6.2 同步集群配置

同步集群的配置是指在同一个应用中拷贝某个环境下的集群的配置到目标环境下的目标集群。

  1. 从其他集群同步已有配置到新集群

    • 切换到原有集群

    • 展开要同步的Namespace，点击同步配置

      image-20220101161441547

    • 选择同步到的新集群，再选择要同步的配置

      image-20220101161613565

    • 同步完成后，切换到SHAJQ集群，发布配置

      image-20220101161638718

​

6.3 读取配置

读取某个集群的配置，需要启动应用时指定具体的应用、环境和集群。

-Dapp.id=应用名称

-Denv=环境名称

-Dapollo.cluster=集群名称

-D环境_meta=meta地址

‐Dapp.id=account‐service 
‐Denv=DEV 
‐Dapollo.cluster=SHAJQ 
‐Dapollo.meta=http://localhost:8080

7. 配置发布原理

在配置中心中，一个重要的功能就是配置发布后实时推送到客户端。下面我们简要看一下这块是怎么设计实现的。

image-20220101161838466

上图简要描述了配置发布的主要过程：

  1. 用户在Portal操作配置发布

  2. Portal调用Admin Service的接口操作发布

  3. Admin Service发布配置后，发送ReleaseMessage给各个Config Service

  4. Config Service收到ReleaseMessage后，通知对应的客户端

7.1 发送ReleaseMessage

Admin Service在配置发布后，需要通知所有的Config Service有配置发布，从而Config Service可以通知对应的客户端来拉取最新的配置。

从概念上来看，这是一个典型的消息使用场景，Admin Service作为producer（生产者）发出消息，各个Config Service作为consumer（消费者）消费消息。通过一个消息队列组件（Message Queue）就能很好的实现Admin Service和Config Service的解耦。

在实现上，考虑到Apollo的实际使用场景，以及为了尽可能减少外部依赖，我们没有采用外部的消息中间件，而是通过数据库实现了一个简单的消息队列。相关代码直接下载源码查看即可。

具体实现方式如下：

  1. Admin Service在配置发布后会往ReleaseMessage表插入一条消息记录，消息内容就是配置发布的AppId+Cluster+Namespace

    SELECT * FROM ApolloConfigDB.ReleaseMessage

    image-20220101162310967

    消息发送类：DatabaseMessageSende

image-20220101162412149

  1. Config Service有一个线程会每秒扫描一次ReleaseMessage表，看看是否有新的消息记录。

    消息扫描类：ReleaseMessageScanner

image-20220101162537097

  1. Config Service如果发现有新的消息记录，那么就会通知到所有的消息监听器

image-20220101162607253

  1. NotifificationControllerV2得到配置发布的AppId+Cluster+Namespace后，会通知对应的客户端

image-20220101162713639

7.2 Config Service 通知客户端

上文中简要描述了NotificationControllerV2是如何得知有配置发布的，那NotificationControllerV2在得知有配置发布后是如何通知到客户端的呢？

实现方式如下：

  1. 客户端会发起一个Http请求到Config Service的 notifications/v2 接口NotificationControllerV2

image-20220101162923641

  1. NotificationControllerV2不会立即返回结果，而是把请求挂起。考虑到会有数万客户端向服务端发起长连，因此在服务端使用了async servlet(Spring DeferredResult)来服务Http Long Polling请求。

  2. 如果在60秒内没有该客户端关心的配置发布，那么会返回Http状态码304给客户端。

  3. 如果有该客户端关心的配置发布，NotificationControllerV2会调用DeferredResult的setResult方法，传入有配置变化的namespace信息，同时该请求会立即返回。客户端从返回的结果中获取到配置变化的namespace 后，会立即请求Config Service获取该namespace的最新配置。

7.3 客户端读取设计

除了之前介绍的客户端和服务端保持一个长连接，从而能第一时间获得配置更新的推送外，客户端还会定时从Apollo配置中心服务端拉取应用的最新配置。

  • 这是一个备用机制，为了防止推送机制失效导致配置不更新
  • 客户端定时拉取会上报本地版本，所以一般情况下，对于定时拉取的操作，服务端都会返回304 - Not Modified
  • 定时频率默认为每5分钟拉取一次，客户端也可以通过在运行时指定System Property: apollo.refreshInterval 来覆盖，单位为分钟
Apollo微服务配置中心详解
m0_67390969的博客
07-31 821
Apollo（阿波罗）是携程框架部门研发的分布式配置中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性，适用于微服务配置管理场景。自己在学习过程中发现Apollo配置中心，相对于SpringConfig等配置中心在部署上特别复杂，但是一旦配置完成，使用起来特别方便，因此在学习中应该特别弄明白他的架构模型。本文章图片均来自于Apollo官方文档[Apollo官网](httpsApollo架构模型简单点如下图。...
Springboot apollo原理及使用方法详解
08-19
主要介绍了Springboot apollo原理及使用方法详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
【Apollo】原理详解
qq_42961251的博客
08-06 2099
apollo三个方面，整体框架，应用管理，发布配置应用进行阐述和源码分析
Apollo功能及原理详解
最新发布
weixin_52093727的博客
03-05 737
Apollo是携程开源的一款分布式配置中心，与EUreka是一组黄金搭档。
apollo原理
maqiang88的专栏
05-17 183
https://www.apolloconfig.com/#/zh/design/apollo-design?id=_141-%e4%b8%bb%e4%bd%93e-r-diagram
Apollo之原理和使用讲解
上善若泪
01-14 1903
由于Apollo概念比较多，刚开始使用比较复杂，最好先过一遍概念再动手实践尝试使用。Apollo（阿波罗）是携程框架部门研发的开源配置管理中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性。
Apollo工作原理
batman
03-24 1045
文章目录Apollo工作原理Apollo架构模块的概览分步执行流程核心概念 Apollo工作原理 Apollo架构模块的概览 上图简要描述了Apollo的总体设计，我们可以从下往上看： Config Service提供配置的读取、推送等功能，服务对象是Apollo客户端 Admin Service提供配置的修改、发布等功能，服务对象是Apollo Portal（管理界面） Eureka提供服...
apollo原理简介
weixin_38612401的博客
03-09 7550
apollo简介
Apollo简介及工作原理
weixin_43489515的博客
04-03 6733
一、Apollo简介 1、Apollo是携程框架部门研发的分布式配置中心 　 2、集中化管理应用的不同环境和不同集群的配置 　 3、配置修改后能够实时推送到应用端 4、具备规范的权限、流程治理等特性 二、Apollo组成部分 Apollo包括服务端和客户端 　 服务端：基于Spring Boot和SpringCloud开发，打包后可以直接运行，不需要额外安装Tomcat等应用容器 jav...
初识配置中心Apollo（携程）的设计原理
NYfor2020的博客
03-12 1235
前言 Apollo是携程框架部门研发的开源配置管理中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端。本文介绍了配置的概念、配置中心的必要性以及Apollo的特点，着重拆解分析Apollo客户端的设计原理，了解Apollo的原理，也能帮助读者更加能够理解配置中心的实现原理。 （若文章有不正之处，或难以理解的地方，请多多谅解，欢迎指正） 一、什么是配置 配置是程序运行时...
Apollo详细介绍
weixin_44488927的博客
08-22 188
对程序配置的期望值也越来越高：配置修改后实时生效，灰度发布，分环境、分集群管理配置，完善的权限、审核机制……在这样的大环境下，传统的通过配置文件、数据库等方式已经越来越无法满足开发人员对配置管理的需求。随着程序功能的日益复杂，程序的配置日益增多：各种功能的开关、参数的配置、服务器的地址……Apollo配置中心应运而生！
Apollo配置中心教程、详解
热门推荐
black_pp的博客
12-23 1万+
Apollo（阿波罗）是一款可靠的分布式配置管理中心，诞生于携程框架研发部，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性，适用于微服务配置管理场景。服务端基于Spring Boot和Spring Cloud开发，打包后可以直接运行，不需要额外安装Tomcat等应用容器。Java客户端不依赖任何框架，能够运行于所有Java运行时环境，同时对Spring/Spring Boot环境也有较好的支持。
简介Apollo原理
小鲍侃java
05-21 681
原理 1. 配置发布后的实时推送设计 配置中心最重要的一个特性就是实时推送，正因为有这个特性，我们才可以依赖配置中心做很多事情。如图 所示。 2.各组件介绍 Portal 提供Web界面供用户管理配置 通过Meta Server获取Admin Service服务列表（IP+Port），通过IP+Port访问服务 在Portal侧做load balance、错误重试 Admin Service 提供配置管理接口 提供配置修改、发布等接口 接口服务对象为Portal Co
Apollo学习（超详细）
hyzsuccess的博客
11-15 3352
Apollo（阿波罗）是携程框架部门研发的分布式配置中心，能够集中化管理应用的不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性，适用于微服务配置管理场景。 特性 ： 统一管理不同环境、不同集群的配置，配置修改实时生效（热发布），版本发布管理，灰度发布，权限管理、发布审核、操作审计，客户端配置信息监控，提供Java和.Net原生客户端，提供开放平台API
Apollo(3):Apollo工作原理
u013938578的博客
04-03 2586
1.Apollo工作原理 下图是Apollo架构模块的概览 各模块职责 上图简要描述了Apollo的总体设计，我们可以从下往上看： Config Service提供配置的读取、推送等功能，服务对象是Apollo客户端 Admin Service提供配置的修改、发布等功能，服务对象是Apollo Portal（管理界面） Eureka提供服务注册和发现，为了简单起见，目前Eure...
Apollo 架构原理及特点
zhang的博客
03-11 816
概述：在分布式、微服务架构中，各个服务都有配置文件，为了便于统一对配置文件进行管理，出现配置中心，如携程Apollo，阿里的nacos。 架构原理 业务操作流程如下: 1、在Apollo配置中心修改配置； 2、应用程序通过Apollo客户端从配置中心拉取配置信息； 3、本地缓存文件用于Apollo客户端挂掉后，配置不会丢失； 用户通过Apollo配置中心修改或发布配置后，会有两种机制来保证应用程序来获取最新配置∶ 一种是Apollo配置中心会向客户端推送最新的配置; 另外一种是Ap.
Apollo分布式配置中心原理
qq_43748400的博客
05-30 1969
Apollo分布式配置中心原理一、执行流程二、工作原理1 各模块职责2 分步执行流程3. 核心概念三、发布原理1. 服务端设计3.1.1 发送ReleaseMessage的实现方式3.1.2 NotificationControllerV2通知客户端配置更新 一、执行流程 操作流程如下： 用户修改和发布配置是通过portal调用AdminService，把配置变更保存在数据库中。 客户端通过长轮询访问ConfigService实时监听配置变更。默认超时时间是90秒。如果在超时前有配置变更，就会立即
java的Apollo的功能_Springboot apollo原理及使用方法详解
weixin_34443284的博客
02-25 559
文章背景演示环境(Demo):106.54.227.205账号/密码:apollo/admin添加配置spring-boot中如何使用pom.xml中添加配置com.ctrip.framework.apolloapollo-client1.1.0配置文件中添加apollo地址app:id: komilesapollo:meta: http://106.54.227.205:8080bootstra...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

、楽.

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值