⭐⭐⭐ Spring Boot 项目实战 ⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》 《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》 《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》 《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》 《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Apollo/install/ 「芋道源码」欢迎转载,保留摘要,谢谢!


🙂🙂🙂关注**微信公众号:【芋道源码】**有福利:

  1. RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表
  2. RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址
  3. 您对于源码的疑问每条留言将得到认真回复。甚至不知道如何读源码也可以请教噢
  4. 新的源码解析文章实时收到通知。每周更新一篇左右
  5. 认真的源码交流微信群。

推荐阅读如下 Apollo 文章:

1. 概述

Apollo 算国内开源中间件,文档完善程度最好的产品,可能唯一能够比肩的只有 Dubbo 的文档了。

1.1 介绍

Apollo 是什么?其官方文档自我介绍如下:

FROM 《Apollo 设计文档 —— Home》

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

服务端基于 Spring Boot 和 Spring Cloud 开发,打包后可以直接运行,不需要额外安装 Tomcat 等应用容器。

Java 客户端不依赖任何框架,能够运行于所有 Java 运行时环境,同时对 Spring/Spring Boot 环境也有额外支持。

.Net 客户端不依赖任何框架,能够运行于所有 .Net 运行时环境。

1.2 核心功能

Apollo 有哪些功能?其官方文档自我介绍如下:

  • 统一管理不同环境、不同集群的配置
  • 配置修改实时生效(热发布)
  • 版本发布管理
  • 灰度发布
  • 权限管理、发布审核、操作审计
  • 客户端配置信息监控
  • 提供 Java 和 .Net 原生客户端
  • 提供开放平台 API
  • 部署简单

详细的功能说明,胖友可以访问 《Apollo 功能列表》 查看。

2. 单机部署

操作系统:macOS 10.14

其它系统,基本一致的。

本小节,参考《Apollo 部署文档 —— 分布式部署指南》《Apollo 部署文档 —— Quick Start》文章,我们来单机部署一个 Apollo 服务。如下图所示:单机部署

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

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

    为什么 Config Service 和 Admin Service 分离呢?在图中,我们可以看到 Config Service 和 Admin Service 读取的是相同的 ApolloPortalDB 数据库,理论上来说可以做成一个服务。

    不过 Admin Service 因为需要不断开发 API 接口提供给 Apollo Portal,因此可能会不定期重启。而 Config Service 功能比较单纯,基本不会有太多更新,因此基本不太会重启。所以,将 Admin Service 和 Config Service 拆分成两个服务。

  • Apollo Portal:Apollo 的管理界面,进行配置想丢该,服务对象是开发者和 开放平台 API。

    为什么 Admin Service 和 Portal 分离呢?在 Apollo 的设计中,不同的 DEV、FAT、UAT、PROD 环境,会部署在不同的网络环境下,进行隔离。

    因此,每个环境会部署一套 Admin Service + Config Service。而 Portal 通过调用不同环境部署的 Admin Service 提供的 API 接口,进行不同环境的配置管理。

    另外,权限管理、开放平台 API 都是由 Portal 统一实现来提供的。

2.1 MySQL 安装

相信大家都会,艿艿就不瞎哔哔了。嘿嘿~注意,推荐安装 MySQL 5.6.5 以上版本,因为 Apollo 的表结构 timestamp 使用了多个 default 声明。例如说,艿艿采用的是 MySQL 8.0.17 版本。

  • 注 1:MySQL版本可以降级到5.5,详见mysql 依赖降级讨论

  • 注 2:如果希望使用 Oracle 的话,可以参考 vanpersl 在 Apollo 0.8.0 基础上开发的 Oracle适配代码,Oracle版本为 10.2.0.1.0。

  • 注 3:如果希望使用 Postgres 的话,可以参考 oaksharks 在 Apollo 0.9.1 基础上开发的 Pg适配代码,Postgres 的版本为 9.3.20,也可以参考 xiao0yy 在 Apollo 0.10.2 基础上开发的 Pg适配代码,Postgres的版本为 9.5。

2.2 Portal 安装

① 下载 Apollo

打开 Apollo 下载页面,选择想要的 Apollo 版本。这里,我们选择 1.5.0 最新版本。

# 创建目录
$ mkdir -p /Users/yunai/Apollo
$ cd /Users/yunai/Apollo

# 下载
$ wget https://github.com/ctripcorp/apollo/releases/download/v1.5.0/apollo-portal-1.5.0-github.zip
$ wget https://github.com/ctripcorp/apollo/releases/download/v1.5.0/apollo-adminservice-1.5.0-github.zip
$ wget https://github.com/ctripcorp/apollo/releases/download/v1.5.0/apollo-configservice-1.5.0-github.zip

# 先只看 Portal 相关

# 解压到 apollo-portal 目录
$ unzip apollo-portal-1.5.0-github.zip -d apollo-portal
$ cd apollo-portal

# 查看目录
$ ls -ls
2312 -rwxr-xr-x 1 yunai staff 1183431 Oct 19 18:17 apollo-portal-1.5.0-sources.jar # 源码
82704 -rwxr-xr-x 1 yunai staff 42342050 Oct 19 18:17 apollo-portal-1.5.0.jar # jar 包
8 -rw-r--r-- 1 yunai staff 57 Feb 24 2019 apollo-portal.conf
0 drwxr-xr-x 5 yunai staff 160 Jan 25 12:34 config # 配置文件
0 drwxr-xr-x 4 yunai staff 128 Mar 1 2019 scripts # 执行脚本

② 初始化数据库

使用 apolloportaldb.sql 脚本,在 MySQL 中初始化 ApolloPortalDB 库。结果如下图: 库

③ 配置数据库连接

修改 conf/application-github.properties 配置文件,设置成 ApolloPortalDB 数据库的信息。配置内容如下:

# DataSource
spring.datasource.url = jdbc:mysql://127.0.0.1:3306/ApolloPortalDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =

④ 配置 Apollo 环境

在上文中,我们提到过不同环境下,我们会配置不同的 Config Service + Admin Service 服务。所以,我们需要修改 config/apollo-env.properties,设置对应服务的地址。配置内容如下:

local.meta=http://localhost:8080
dev.meta=http://127.0.0.1:8080
fat.meta=http://fill-in-fat-meta-server:8080
uat.meta=http://fill-in-uat-meta-server:8080
lpt.meta=${lpt_meta}
pro.meta=http://fill-in-pro-meta-server:8080

默认情况下,我们只需要配置 DEV 环境的,因为在 ServerConfig 表中,只配置了 Portal 支持的环境列表为 DEV 环境。如下图所示:ServerConfig

这里,我们只设置了 dev.meta 配置项为 http://127.0.0.1:8080,也就是我们后续会启动的 DEV 环境的 Config Service 地址。

另外,配置文件中的 meta 指的是 Apollo Meta Server,其官方文档解释如下:

FROM 《系统使用文档 —— Java客户端使用指南》

Apollo支持应用在不同的环境有不同的配置,所以需要在运行提供给Apollo客户端当前环境的 Apollo Meta Server 信息。默认情况下,meta server 和 config service 是部署在同一个 JVM 进程,所以 meta server 的地址就是 config service 的地址。

为了实现 meta server 的高可用,推荐通过 SLB(Software Load Balancer)做动态负载均衡。Meta server 地址也可以填入 IP,如 http://1.1.1.1:8080,http://2.2.2.2:8080,不过生产环境还是建议使用域名(走 slb),因为机器扩容、缩容等都可能导致 IP 列表的变化。

  • 简单来说,我们可以把 Apollo Meta Server 当成注册中心,通过它可以获得到所有 Admin Service 和 Config Service 的地址。不过要注意哈,Meta Server 也是一个环境对应一个。

⑤ 启动 Portal 服务

执行 sh scripts/startup.sh 命令,启动 Portal 服务。操作命令如下:

$ sh scripts/startup.sh
Sat Jan 25 19:06:35 CST 2020 ==== Starting ====
Started [47441]
Waiting for server startup...
Sat Jan 25 19:06:50 CST 2020 Server started in 15 seconds!

另外,我们可以在 /opt/logs/100003173 目录下,查看到对应的 Portal 服务的日志。不过,因为此时我们并未启动 DEV 服务的 Config Service,所以在 /opt/logs/100003173/apollo-portal.log 日志文件中,会报如下异常:

2020-01-25 19:12:59.943 ERROR 47688 --- [Apollo-EnvHealthChecker-1] c.c.f.a.portal.component.PortalSettings  : Env is down. env: DEV, failed times: 3, meta server address: http://127.0.0.1:8080

  • 这个问题不大,暂时忽略即可。

⑥ 访问 Portal 服务

使用浏览器,访问 http://127.0.0.1:8070 地址,进入 Portal 管理界面的登录页。如下图所示:Portal 登录界面

使用默认账号「apollo/admin」进行登录。登录完成后,进入首页。如下图所示:Portal 首页

稍后,我们在使用 Portal 进行配置的创建等操作,先继续搭建 Config Service 和 Admin Service 服务。注意,这里我们是搭建的 DEV 环境的 Config Service + Admin Service 服务噢。

2.3 Config Service 安装

① 解压 Config Service

# 进入 Apollo 目录
$ cd /Users/yunai/Apollo

# 解压到 apollo-config 目录
$ unzip apollo-configservice-1.5.0-github.zip -d apollo-configservice
$ cd apollo-configservice

# 查看目录
$ ls -ls
80 -rwxr-xr-x 1 yunai staff 40252 Oct 19 18:17 apollo-configservice-1.5.0-sources.jar # 源码
121080 -rwxr-xr-x 1 yunai staff 61991599 Oct 19 18:17 apollo-configservice-1.5.0.jar # jar 包
8 -rw-r--r-- 1 yunai staff 57 Feb 24 2019 apollo-configservice.conf
0 drwxr-xr-x 4 yunai staff 128 Aug 6 09:00 config # 配置文件
0 drwxr-xr-x 4 yunai staff 128 Jan 25 20:33 scripts # 执行脚本

② 初始化数据库

使用 apolloconfigdb.sql 脚本,在 MySQL 中初始化 ApolloConfigDB 库。结果如下图: 库

③ 配置数据库连接

修改 conf/application-github.properties 配置文件,设置成 ApolloConfigDB 数据库的信息。配置内容如下:

# DataSource
spring.datasource.url = jdbc:mysql://127.0.0.1:3306/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =

④ 启动 Config Service 服务

执行 sh scripts/startup.sh 命令,启动 Config Service 服务。操作命令如下:

$ sh scripts/startup.sh
Sat Jan 25 22:31:41 CST 2020 ==== Starting ====
Started [50317]
Waiting for server startup....
Sat Jan 25 22:32:02 CST 2020 Server started in 20 seconds!

另外,我们可以在 /opt/logs/100003171 目录下,查看到对应的 Portal 服务的日志。不过,因为此时我们并未启动 DEV 服务的 Config Service,所以在 /opt/logs/100003171/apollo-configservice.log 日志文件中。

此时,如果我们看下 /opt/logs/100003173/apollo-portal.log 日志文件,已经不会报错了。

⑤ 访问 Meta Server 服务

使用浏览器,访问 http://127.0.0.1:8080 地址,进入 Meta Server 首页。可以看到 Config Service 注册到其上,如下图所示:Meta Server 首页

因为 Apollo Meta Server 是基于 Eureka 注册中心实现,所以看到的是 Eureka 界面。

2.4 Admin Service 安装

① 解压 Config Service

# 进入 Apollo 目录
$ cd /Users/yunai/Apollo

# 解压到 apollo-config 目录
$ unzip apollo-adminservice-1.5.0-github.zip -d apollo-adminservice
$ cd apollo-adminservice

# 查看目录
$ ls -ls
56 -rwxr-xr-x 1 yunai staff 25994 Oct 19 18:17 apollo-adminservice-1.5.0-sources.jar # 源码
113984 -rwxr-xr-x 1 yunai staff 58358563 Oct 19 18:17 apollo-adminservice-1.5.0.jar # jar 包
8 -rw-r--r-- 1 yunai staff 57 Feb 24 2019 apollo-adminservice.conf
0 drwxr-xr-x 4 yunai staff 128 Feb 24 2019 config # 配置文件
0 drwxr-xr-x 4 yunai staff 128 Mar 1 2019 scripts # 执行脚本

② 配置数据库连接

因为我们在安装 Config Service 时,已经初始化了 ApolloConfigDB 数据库,所以无需重新初始化。

修改 conf/application-github.properties 配置文件,设置成 ApolloConfigDB 数据库的信息。配置内容如下:

# DataSource
spring.datasource.url = jdbc:mysql://127.0.0.1:3306/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =

④ 启动 Admin Service 服务

执行 sh scripts/startup.sh 命令,启动 Admin Service 服务。操作命令如下:

$ sh scripts/startup.sh
Sat Jan 25 23:30:06 CST 2020 ==== Starting ====
Started [51526]
Waiting for server startup
Sat Jan 25 23:30:06 CST 2020 Server started in 0 seconds!

另外,我们可以在 /opt/logs/100003172 目录下,查看到对应的 Portal 服务的日志。不过,因为此时我们并未启动 DEV 服务的 Config Service,所以在 /opt/logs/100003172/apollo-adminservice.log 日志文件中。

⑤ 访问 Meta Server 服务

使用浏览器,访问 http://127.0.0.1:8080 地址,进入 Meta Server 首页。可以看到 Admin Service 也注册到其上,如下图所示:Meta Server 首页

2.5 使用指南

参考《Apollo 开发文档 —— Apollo 使用指南》文章,我们来创建一个 Apollo 项目,并添加该项目的配置,最终进行一次配置的发布。

① 创建项目(应用)

使用浏览器,打开 http://127.0.0.1:8070/ 地址,访问 Portal 首页。如下图所示:Portal 首页

点击「创建项目」按钮,进入「创建项目」界面。按照自己想要创建的项目信息进行填写,例如艿艿输入如下信息:创建项目

  • 部门:选择应用所在的部门。部门数据来自 ApolloPortalDB 库的 ServerConfig 表的 Key = organizations 对应的记录。
  • 应用 AppId:用来标识应用身份的唯一 id,格式为 string,需要和客户端 app.properties 中配置的 app.id 对应。
  • 应用名称:应用名,仅用于界面展示。
  • 应用负责人:默认具有项目管理员权限。
  • 项目管理员:可以创建 Namespace 和集群、分配用户权限。

点击「提交」按钮,完成项目的创建。创建成功后,自动跳转到该项目的首页。如下图所示:项目首页

② 新增配置项

点击右上角的「新增配置」按钮,弹出「添加配置项」的窗口。按照自己想要创建的配置项进行填写,例如艿艿输入如下信息:新增项目

点击「提交」按钮,完成配置项的创建。此时该项目的界面如下图:项目首页

③ 发布配置

点击右上角的「发布」按钮,弹出「发布」的窗口。如下图所示:发布

点击「发布」按钮,完成配置的发布。此时该项目的界面如下图:项目首页

至此,我们完成了一次配置的发布。更多 Apollo 的使用指南,推荐详细阅读下《Apollo 开发文档 —— Apollo 使用指南》文章。

3. 集群部署

在生产环境下,我们需要搭建 Apollo 集群,确保高可用。因为《Apollo 部署文档 —— 分布式部署指南》已经编写详细的教程,艿艿就不重复赘述。

不喜欢看文章,想要看视频的胖友,可以访问分布式配置中心 Apollo 极简入门地址,查看视频教程。

相比「2. 单机部署」来说,我们需要额外做的事情:

  • 搭建 Portal 多个节点,实现 Portal 的高可用。

  • 搭建 FAT、UAT、PROD 的 Config Service + Admin Service。并且,每个环境的 Config Service + Admin Service 都需要部署多个节点,保证它们的高可用。另外,在每个环境的 ApolloConfigDB 数据库的 ServerConfig 表的 KEY = eureka.service.url 对应记录的 Value 为对应环境的 Config Service 的所有节点的地址。

  • 搭建 Nginx 多个节点,实现 Nginx 的高可用。后续,对 Portal 和 Config Service(Meta Server)进行负载均衡。

  • 搭建 MySQL 多节点,实现 MySQL 的高可用。

搭建完多环境的 Config Service + Admin Service 之后,需要在 Portal 中进行如下设置,使 Portal 可以对对应环境可以进行配置管理:

  • 在 Portal 的 config/apollo-env.properties 配置文件,需要 DEV、FAT、UAT、PROD 经过 Nginx 负载均衡后的 Meta Server 高可用的地址。
  • 同时,修改 ApolloPortalDB 数据库的 ServerConfig 表的 KEY = apollo.portal.envs 对应记录的 Valuedev,fat,uat,prod,从而开启多环境的支持。

4. 集成到 Spring Boot

详细内容,可见《芋道 Spring Boot 配置中心 Apollo 入门》文章。

5. 集成到 Spring Cloud

详细内容,可见《芋道 Spring Cloud 配置中心 Apollo 入门》文章。

6. 集成到 Dubbo

TODO

666. 彩蛋

如果对源码感兴趣的胖友,可以看看《Apollo 源码解析》噢。

文章目录
  1. 1. 1. 概述
    1. 1.1. 1.1 介绍
    2. 1.2. 1.2 核心功能
  2. 2. 2. 单机部署
    1. 2.1. 2.1 MySQL 安装
    2. 2.2. 2.2 Portal 安装
    3. 2.3. 2.3 Config Service 安装
    4. 2.4. 2.4 Admin Service 安装
    5. 2.5. 2.5 使用指南
  3. 3. 3. 集群部署
  4. 4. 4. 集成到 Spring Boot
  5. 5. 5. 集成到 Spring Cloud
  6. 6. 6. 集成到 Dubbo
  7. 7. 666. 彩蛋