The World Best ST.

Apollo介绍及部署

字数统计: 1.6k阅读时长: 6 min
2019/04/24 Share

Apollo介绍及部署

Apollo简介

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

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

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

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

Apollo优点

  • 统一管理不同环境、不同集群的配置
    • Apollo提供了一个统一界面集中式管理不同环境(environment)、不同集群(cluster)、不同命名空间(namespace)的配置。
    • 同一份代码部署在不同的集群,可以有不同的配置,比如zk的地址等
    • 通过命名空间(namespace)可以很方便的支持多个不同应用共享同一份配置,同时还允许应用对共享的配置进行覆盖
  • 配置修改实时生效(热发布)
    • 用户在Apollo修改完配置并发布后,客户端能实时(1秒)接收到最新的配置,并通知到应用程序。
  • 版本发布管理
    • 所有的配置发布都有版本概念,从而可以方便的支持配置的回滚。
  • 灰度发布
    • 支持配置的灰度发布,比如点了发布后,只对部分应用实例生效,等观察一段时间没问题后再推给所有应用实例。
  • 权限管理、发布审核、操作审计
    • 应用和配置的管理都有完善的权限管理机制,对配置的管理还分为了编辑和发布两个环节,从而减少人为的错误。
    • 所有的操作都有审计日志,可以方便的追踪问题。
  • 客户端配置信息监控
    • 可以方便的看到配置在被哪些实例使用
  • 提供Java和.Net原生客户端
    • 提供了Java和.Net的原生客户端,方便应用集成,并提供了Http接口
    • 支持Spring Placeholder, Annotation和Spring Boot的ConfigurationProperties,方便应用使用(需要Spring 3.1.1+)
  • 提供开放平台API
    • Apollo自身提供了比较完善的统一配置管理界面,支持多环境、多数据中心配置管理、权限、流程治理等特性。
    • 对于这类应用,Apollo支持应用方通过开放接口在Apollo进行配置的修改和发布,并且具备完善的授权和权限控制
  • 部署简单
    • 配置中心作为基础服务,可用性要求非常高,这就要求Apollo对外部依赖尽可能地少
    • 目前只需依赖MySQL与JAVA环境
    • 通过打包脚本,一键就可以生成所有需要的安装包,并且支持自定义运行时参数

统一配置中心对比

参考资料:

https://www.cnblogs.com/xiaoqi/p/configserver-compair.html

简单总结:厉害就完事了

Apollo部署

Quick-Start

用于快速启动Apollo工程

  1. 安装JDK 1.8+
  2. 安装MySQL 5.6+
    • 可用SHOW VARIABLES WHERE Variable_name = 'version';语句查看当前数据库版本
  3. 下载Quick-Start安装包
    • 下载地址https://pan.baidu.com/s/1iftkG14dVtOq-JIyz3AqLA
  4. 解压Quick-Start安装包,进入解压目录下的sql文件夹
  5. 在MySQL数据库内执行两个sql文件
    • 使用以下两个sql语句来验证是否导入成功
    • select `NamespaceId`, `Key`, `Value`, `Comment` from ApolloConfigDB.Item;
    • select `Id`, `AppId`, `Name` from ApolloPortalDB.App;
  6. 编辑demo.sh文件
1
2
3
4
5
6
7
8
9
#apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8
apollo_config_db_username=数据库用户名
apollo_config_db_password=密码(如果没有密码,留空即可)

# apollo portal db info
apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8
apollo_portal_db_username=数据库用户名
apollo_portal_db_password=密码(如果没有密码,留空即可)
  1. 执行./demo.sh start命令,启动Apollo

注:Apollo启动后会使用,8070,8080,8090端口

分布式部署

用于正式环境分布式部署Apollo配置中心

  1. 下载安装包或源码
    • 安装包地址: https://github.com/ctripcorp/apollo/releases
    • 源码地址: https://github.com/ctripcorp/apollo
  2. 由于本人电脑下不动安装包..这里选择源码,若能直接下载安装包可直接跳到第五步
  3. 编辑scripts/build.sh文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?useSSL=false&characterEncoding=utf8
apollo_config_db_username=用户名
apollo_config_db_password=密码(如果没有密码,留空即可)

# apollo portal db info
apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?useSSL=false&characterEncoding=utf8
apollo_portal_db_username=用户名
apollo_portal_db_password=密码(如果没有密码,留空即可)

dev_meta=http://localhost:8080(apollo-configservice部署地址)
fat_meta=http://apollo.fat.xxx.com,http://2.2.2.2:8080(多地址写法)
uat_meta=http://apollo.uat.xxx.com
pro_meta=http://apollo.xxx.com

META_SERVERS_OPTS="-Ddev_meta=$dev_meta -Dfat_meta=$fat_meta -Duat_meta=$uat_meta -Dpro_meta=$pro_meta"
  1. 执行./build.sh,进行编译,结果输出在target文件夹中

注: 对不同环境的config-service和admin-service需要使用不同的数据库连接信息打不同的包,portal只需要打一次包即可

  1. 解压·apollo-configservice-x.x.x-github.zipapollo-adminservice-x.x.x-github.zipapollo-portal-x.x.x-github.zip

  2. 启动apollo-configservice

    • 可以编辑scripts/startup.sh,按照需求增加export JAVA_OPTS="-server -Xms6144m -Xmx6144m -Xss256k -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:NewSize=4096m -XX:MaxNewSize=4096m -XX:SurvivorRatio=18",以配置JVM内存
    • 可以编辑apollo-configservice.conf文件和scripts/startup.sh文件配置日志输出路径(LOG_DIR),默认为/opt/logs/xxxxx
    • 可以编辑scripts/startup.sh修改监听端口(SERVER_PORT),修改此处之后portal中也需要相应修改meta端口信息
  3. 启动apollo-adminservice

    • 可以编辑scripts/startup.sh,按照需求增加export JAVA_OPTS="-server -Xms2560m -Xmx2560m -Xss256k -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:NewSize=1024m -XX:MaxNewSize=1024m -XX:SurvivorRatio=22",以配置JVM内存
    • 可以编辑apollo-adminservice.conf文件和scripts/startup.sh文件配置日志输出路径(LOG_DIR),默认为/opt/logs/xxxxx
    • 可以编辑scripts/startup.sh修改监听端口(SERVER_PORT)
  4. 启动apollo-portal

    • 可以编辑scripts/startup.sh,按照需求增加export JAVA_OPTS="-server -Xms4096m -Xmx4096m -Xss256k -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=384m -XX:NewSize=1536m -XX:MaxNewSize=1536m -XX:SurvivorRatio=22",以配置JVM内存
    • 可以编辑apollo-portal.conf文件和scripts/startup.sh文件配置日志输出路径(LOG_DIR),默认为/opt/logs/xxxxx
    • 可以编辑scripts/startup.sh修改监听端口(SERVER_PORT)

踩的大坑

  • JDK记得要安装在没有空格的路径中

  • Apollo部署程序也需要安装在没有空格的路径中

不然就是无尽的启动不起来~~


本文参考资料:

https://github.com/ctripcorp/apollo

CATALOG
  1. 1. Apollo介绍及部署
    1. 1.1. Apollo简介
      1. 1.1.1. Apollo优点
      2. 1.1.2. 统一配置中心对比
    2. 1.2. Apollo部署
      1. 1.2.1. Quick-Start
      2. 1.2.2. 分布式部署
    3. 1.3. 踩的大坑