概述
Apollo(阿波罗)是携程框架部门研发的分布式配置中心,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性,适用于微服务配置管理场景。
服务端基于Spring Boot和Spring Cloud开发,打包后可以直接运行,不需要额外安装Tomcat等应用容器。
Java客户端不依赖任何框架,能够运行于所有Java运行时环境,同时对Spring/Spring Boot环境也有较好的支持。
核心功能
统一管理不同环境、不同集群配置:
1:Apollo提供了一个统一界面集中式管理不同环境(environment)、不同集群(cluster)、不同命名空间(namespace)的配置。
2:同一份代码部署在不同的集群,可以有不同的配置,比如zk的地址等
3:通过命名空间(namespace)可以很方便的支持多个不同应用共享同一份配置,同时还允许应用对共享的配置进行覆盖
4:配置界面支持多语言(中文,English)
热发布:
用户在Apollo修改完配置并发布后,客户端能实时(1秒)接收到最新的配置,并通知到应用程序。
版本发布管理:
所有的配置发布都有版本概念,从而可以方便的支持配置的回滚。
灰度发布:
支持配置的灰度发布,比如点了发布后,只对部分应用实例生效,等观察一段时间没问题后再推给所有应用实例。
权限管理、发布审核、操作审计:
1:应用和配置的管理都有完善的权限管理机制,对配置的管理还分为了编辑和发布两个环节,从而减少人为的错误。
2:所有的操作都有审计日志,可以方便的追踪问题。
客户端配置信息监控:
可以方便的看到配置在被哪些实例使用
提供Java和.Net原生客户端:
1:提供了Java和.Net的原生客户端,方便应用集成
2:支持Spring Placeholder,Annotation和Spring Boot的ConfigurationProperties,方便应用使用(需要Spring 3.1.1+)
3:同时提供了Http接口,非Java和.Net应用也可以方便的使用
提供开放平台API:
1:Apollo自身提供了比较完善的统一配置管理界面,支持多环境、多数据中心配置管理、权限、流程治理等特性。
2:不过Apollo出于通用性考虑,对配置的修改不会做过多限制,只要符合基本的格式就能够保存。
3:在我们的调研中发现,对于有些使用方,它们的配置可能会有比较复杂的格式,如xml, json,需要对格式做校验。
4:还有一些使用方如DAL,不仅有特定的格式,而且对输入的值也需要进行校验后方可保存,如检查数据库、用户名和密码是否匹配。
5:对于这类应用,Apollo支持应用方通过开放接口在Apollo进行配置的修改和发布,并且具备完善的授权和权限控制
部署简单:
1:配置中心作为基础服务,可用性要求非常高,这就要求Apollo对外部依赖尽可能地少
2:目前唯一的外部依赖是MySQL,所以部署非常简单,只要安装好Java和MySQL就可以让Apollo跑起来
3:Apollo还提供了打包脚本,一键就可以生成所有需要的安装包,并且支持自定义运行时参数
工作模式
单节点架构
分布式架构
部署环境说明
MySQL:MySQL建议用5.7,版本要求5.6.5+
Apollo服务端:JDK1.8+
Apollo客户端:JDK1.7+
项目地址:https://github.com/apolloconfig/apollo
使用手册:https://github.com/ctripcorp/apollo/wiki
部署
单机部署(示例版本 2.0.1)
创建数据库
SQL文件下载地址:https://github.com/apolloconfig/apollo/tree/v2.1.0/scripts/sql
1.通过下载的Sql文件创建出【ApolloConfigDB,ApolloProtalDB】两个库
2.修改数据库中的配置信息
ApolloConfigDB(修改Eureka服务服务地址)
ApolloProtalDB(修改环境列表及部门列表信息)
创建YML文件
vim docker-compose-apollo.yml
version: '3.7'
services:
apollo-configservice:
container_name: apollo-configservice
image: apolloconfig/apollo-configservice:2.0.1
volumes:
- ./logs/apollo:/opt/logs
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloConfigDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root #数据库用户名
- SPRING_DATASOURCE_PASSWORD=Weihu12345 #数据库密码
- APOLLO_RUN_MODE=Docker
- SERVER_PORT=18080 #修改服务监听端口
restart: always
network_mode: host #服务端口18080
apollo-adminservice:
depends_on:
- apollo-configservice
container_name: apollo-adminservice
image: apolloconfig/apollo-adminservice:2.0.1
volumes:
- ./logs/apollo-adminservice/:/opt/logs
- ./apollo-adminservice/scripts/:/apollo-adminservice/scripts/
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloConfigDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root
- SPRING_DATASOURCE_PASSWORD=Weihu12345
- APOLLO_RUN_MODE=Docker
restart: always
network_mode: host #服务端口8090
apollo-portal:
depends_on:
- apollo-adminservice
container_name: apollo-portal
image: apolloconfig/apollo-portal:2.0.1
volumes:
- ./logs/apollo-portal/:/opt/logs
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloPortalDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root
- SPRING_DATASOURCE_PASSWORD=Weihu12345
- APOLLO_PORTAL_ENVS=dev #支持的环境列表与数据库中配置的一致(多个以英文逗号分隔)
- DEV_META=http://172.25.186.89:18080 #configserver服务地址(环境接入,多个环境复制此配置即可)
restart: always
network_mode: host #服务端口8070
启动程序
docker-compose -f docker-compose-apollo.yml up -d
查看容器状态
docker-compose -f docker-compose-apollo.yml ps
查看容器日志
docker logs 容器名
访问服务
http://IP:8070(默认超管:apollo/admin)
分布式部署(示例版本 2.0.1)
主机 | IP | 角色 | 环境 |
Apollo主机1 | 192.168.0.1 | configservice1,adminservice1,portal | pro |
Apollo主机2 | 192.168.0.2 | configservice2,adminservice2 | uat |
数据库创建
Apollo主机1:
创建【ApolloConfigDB,ApolloProtalDB】两个库
Apollo主机2:
创建【ApolloConfigDB】库
注意:环境列表及configservice地址的修改。
创建YML文件
Apollo主机1:
vim docker-compose-apollo.yml
version: '3.7'
services:
apollo-configservice:
container_name: apollo-configservice
image: apolloconfig/apollo-configservice:2.0.1
volumes:
- ./logs/apollo:/opt/logs
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloConfigDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root #数据库用户名
- SPRING_DATASOURCE_PASSWORD=Weihu12345 #数据库密码
- APOLLO_RUN_MODE=Docker
- SERVER_PORT=18080 #修改服务监听端口
restart: always
network_mode: host #服务端口18080
apollo-adminservice:
depends_on:
- apollo-configservice
container_name: apollo-adminservice
image: apolloconfig/apollo-adminservice:2.0.1
volumes:
- ./logs/apollo-adminservice/:/opt/logs
- ./apollo-adminservice/scripts/:/apollo-adminservice/scripts/
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloConfigDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root
- SPRING_DATASOURCE_PASSWORD=Weihu12345
- APOLLO_RUN_MODE=Docker
restart: always
network_mode: host #服务端口8090
apollo-portal:
depends_on:
- apollo-adminservice
container_name: apollo-portal
image: apolloconfig/apollo-portal:2.0.1
volumes:
- ./logs/apollo-portal/:/opt/logs
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloPortalDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root
- SPRING_DATASOURCE_PASSWORD=Weihu12345
- APOLLO_PORTAL_ENVS=pro,uat #需要注意的配置
- PRO_META=http://192.168.0.1:18080 #需要注意的配置
- UAT_META=http://192.168.0.2:18080 #需要注意的配置
restart: always
network_mode: host #服务端口8070
Apollo主机2:
vim docker-compose-apollo.yml
version: '3.7'
services:
apollo-configservice:
container_name: apollo-configservice
image: apolloconfig/apollo-configservice:2.0.1
volumes:
- ./logs/apollo:/opt/logs
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloConfigDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root #数据库用户名
- SPRING_DATASOURCE_PASSWORD=Weihu12345 #数据库密码
- APOLLO_RUN_MODE=Docker
- SERVER_PORT=18080 #修改服务监听端口
restart: always
network_mode: host #服务端口18080
apollo-adminservice:
depends_on:
- apollo-configservice
container_name: apollo-adminservice
image: apolloconfig/apollo-adminservice:2.0.1
volumes:
- ./logs/apollo-adminservice/:/opt/logs
environment:
- SPRING_DATASOURCE_URL=jdbc:mysql://mysqlip:mysqlport/ApolloConfigDB?characterEncoding=utf8
- SPRING_DATASOURCE_USERNAME=root
- SPRING_DATASOURCE_PASSWORD=Weihu12345
- APOLLO_RUN_MODE=Docker
restart: always
network_mode: host #服务端口8090
启动程序
docker-compose -f docker-compose-apollo.yml up -d
查看容器状态
docker-compose -f docker-compose-apollo.yml ps
查看容器日志
docker logs 容器名