apollo-demo

Apollo部署添加多环境demo

本项目核心作用是实现多环境配置，因而项目本身并不重要，只是一个restful接口，用来验证环境切换以后配置也随之发生了变动

---

Apollo架构设计图

相关模块及其作用

四个核心模块

• ConfigService，服务于Apollo客户端
  • 提供配置获取接口
  • 提供配置推送接口
• AdminService，服务于管理界面Portal
  • 提供配置管理接口
  • 提供配置修改发布接口
• Client，集成了Apollo配置中心的应用均可认为是Apollo的客户端
  • 为应用获取配置，支持实时更新
  • 通过MetaServer获取ConfigService的服务列表
  • 使用客户端软负载SLB(software load balance)方式调用ConfigService
• Portal，Apollo自己的配置管理界面
  • 通过MetaServer获取AdminService的服务列表
  • 使用客户端软负载SLB(Software load balance)方式调用AdminService

三个辅助服务

• Eureka
  • 用于服务发现和注册
    • 帮助Config/Admin Service 注册实例并定期检测其心跳
  • 和ConfigService集成在同一个模块中
• MetaServer
  • Portal通过域名访问MetaServer获取AdminService的地址列表
  • Client通过域名访问MetaServer获取ConfigService的地址列表
  • 封装了Eureka，是Portal和Client访问Eureka的中介
  • 一个逻辑角色，和ConfigService、Eureka集成在同一个模块中
• NginxLB
  • 和域名系统配合，协助Portal访问MetaServer获取AdminService的地址列表
  • 和域名系统配合，协助Client访问MetaServer获取ConfigService的地址列表
  • 和域名系统配合，协助用户访问Portal进行配置管理

部署步骤

• 基本要求：部署支持开发dev和测试fat的两套配置

• 在Apollo项目的release页面下载三个包，分别是Apollo-portal、Apollo-configService、Apollo-adminService

  • 解压三个包
  • 将Apollo-configService、Apollo-adminService各复制一份，并分别冠以-dev以及-fat的后缀
  • 修改后的目录结构应当如下：

      - apollo-portal
      | - dev
          | - Apollo-configService-dev
          | - Apollo-configService-dev
      | - fat
          |- Apollo-configService-fat
          |- Apollo-configService-fat
  

• 从另一个仓库中获取快捷部署的sql文件，分别是apolloconfigdb.sql、apolloportaldb.sql

  • 在mysql的可视化工具上，例如: Navicat for mysql 工具上执行apolloportaldb.sql
  • 将apolloconfigdb.sql中的database名改为ApolloConfigDB_dev和ApolloConfigDB_fat分别执行一次，为dev和fat分别创建配置地址

• dev部署

  • 进入Apollo-configService-dev中：
    • startup.sh中修改端口为8082，避免端口冲突
    • 修改数据库连接信息，将用户名和密码，以及url均改为本地的数据库对应信息，此外url中的database改为ApolloConfigDB_dev
    • 启动了该模块后，已经可以使配置和demo进行连通，但是要想实现配置管理及热部署，还要部署另外两个模块
  • 进入Apollo-adminService-dev中：
    • startup.sh中修改端口为8092，避免端口冲突
    • 修改数据库连接信息，将用户名和密码，以及url均改为本地的数据库对应信息，此外url中的database改为ApolloConfigDB_dev
  • 进入数据库ApolloConfigDB_dev中，找到表serverconfig，修改其中的eureka.service.url，将Eureka端口改为8082，对应前面Apollo-configService-dev中的端口
    • 之所以Apollo-configService-dev的端口和Eureka对应，是因为在Apollo的架构中，Apollo-configService即是metaServer也是Eureka、也是configService，该模块同时具备三个逻辑角色于一体
  • 通过Apollo-configService-dev目录下的scripts中的startup.sh启动Apollo-configService-dev，成功后访问localhost:8082，此时应当可以看到服务本身也注册成功了
  • 通过Apollo-adminService-dev目录下的scripts中的startup.sh启动Apollo-adminService-dev，启动成功后，访问localhost:8082中应当有该服务的注册信息，此外访问localhost:8092应当可以访问成功

• 至此，dev环境已部署成功，并且可以向其他应用提供配置服务

• 修改数据库ApolloPortalDB中serverconfig表中的apollo.portal.envs，将dev改为dev,fat，表示新增fat环境

• 修改apollo-portal中的信息：

  • 将config目录下的application-github.properties中的数据库信息改为本地对应的数据库信息
  • 将config目录下的apollo-env.properties中的dev.meta改为localhost:8082
  • 将config目录下的apollo-env.properties中的fat.meta改为localhost:8084

• 启动Apollo-portal，访问localhost:8070，用户名和密码分别是apollo和admin

  • 进入系统能看到当前拥有的环境是dev

• 按照dev的部署模式，将Apollo-configService-fat、Apollo-adminService-fat中的数据库、端口信息分别修改并启动，就能在apollo-portal中看到对应的fat信息

• 在spring-boot项目中集成apollo，本项目同样采用了该方式进行集成

  • 添加依赖
  • 增加配置文件
    • 核心是以下四条信息

    apollo.meta=http://localhost:8084
    apollo.bootstrap.enabled = true
    app.id=SampleApp
    apollo.autoUpdateInjectedSpringProperties=false

  • 在项目中使用对应配置

• 启动本项目，通过restful接口访问，不断修改apollo-portal页面上的对应apollo.meta的值，从页面上值的变化，可以看出，配置中心搭建成功

• 本项目只是一个简单的demo，用于快速上手apollo同时可以帮助理解它的设计和架构，生产上落地apollo应当要整合自己的权限系统以及Eureka

相关连接

• apollo wiki
• 携程Apollo配置中心架构剖析