Docker部署Apollo
简单介绍:
-
- 统一管理不同环境、不同集群的配置
- Apollo提供了一个统一界面集中式管理不同环境(environment)、不同集群(cluster)、不同命名空间(namespace)的配置。
- 同一份代码部署在不同的集群,可以有不同的配置,比如zookeeper的地址等
- 通过命名空间(namespace)可以很方便地支持多个不同应用共享同一份配置,同时还允许应用对共享的配置进行覆盖
- 配置修改实时生效(热发布)
- 用户在Apollo修改完配置并发布后,客户端能实时(1秒)接收到最新的配置,并通知到应用程序
- 版本发布管理
- 所有的配置发布都有版本概念,从而可以方便地支持配置的回滚
- 灰度发布
- 支持配置的灰度发布,比如点了发布后,只对部分应用实例生效,等观察一段时间没问题后再推给所有应用实例
- 权限管理、发布审核、操作审计
- 应用和配置的管理都有完善的权限管理机制,对配置的管理还分为了编辑和发布两个环节,从而减少人为的错误。
- 所有的操作都有审计日志,可以方便地追踪问题
- 客户端配置信息监控
- 可以在界面上方便地看到配置在被哪些实例使用
- 提供Java和.Net原生客户端
- .Net的原生客户端,方便应用集成
- 同时提供了Http接口,非Java和.Net应用也可以方便地使用
- 提供开放平台API
- Apollo自身提供了比较完善的统一配置管理界面,支持多环境、多数据中心配置管理、权限、流程治理等特性。不过Apollo出于通用性考虑,不会对配置的修改做过多限制,只要符合基本的格式就能保存,不会针对不同的配置值进行针对性的校验,如数据库用户名、密码,Redis服务地址等
- 对于这类应用配置,Apollo支持应用方通过开放平台API在Apollo进行配置的修改和发布,并且具备完善的授权和权限控制
- 部署简单
- 配置中心作为基础服务,可用性要求非常高,这就要求Apollo对外部依赖尽可能地少
- 目前唯一的外部依赖是MySQL,所以部署非常简单,只要安装好Java和MySQL就可以让Apollo跑起来
- Apollo还提供了打包脚本,一键就可以生成所有需要的安装包,并且支持自定义运行时参数
- 统一管理不同环境、不同集群的配置
一:Config Service提供配置的读取、推送等功能,服务对象是Apollo客户端
-
- 提供配置获取接口
- 提供配置更新推送接口(基于Http long polling)
- 服务端使用Spring DeferredResult实现异步化,从而大大增加长连接数量
- 目前使用的tomcat embed默认配置是最多10000个连接(可以调整),使用了4C8G的虚拟机实测可以支撑10000个连接,所以满足需求(一个应用实例只会发起一个长连接)。
- 接口服务对象为Apollo客户端
二:Admin Service提供配置的修改、发布等功能,服务对象是Apollo Portal(管理界面)
-
- 提供配置管理接口
- 提供配置修改、发布等接口
- 接口服务对象为Portal
三: Meta Server 在Eureka之上我们架了一层Meta Server用于封装Eureka的服务发现接口
-
- Portal通过域名访问Meta Server获取Admin Service服务列表(IP+Port)
- Client通过域名访问Meta Server获取Config Service服务列表(IP+Port)
- Meta Server从Eureka获取Config Service和Admin Service的服务信息,相当于是一个Eureka Client
- 增设一个Meta Server的角色主要是为了封装服务发现的细节,对Portal和Client而言,永远通过一个Http接口获取Admin Service和Config Service的服务信息,而不需要关心背后实际的服务注册和发现组件
- Meta Server只是一个逻辑角色,在部署时和Config Service是在一个JVM进程中的,所以IP、端口和Config Service一致
四:Eureka java的一个服务发现的组件
-
- 基于Eureka和Spring Cloud Netflix提供服务注册和发现
- Config Service和Admin Service会向Eureka注册服务,并保持心跳
- 为了简单起见,目前Eureka在部署时和Config Service是在一个JVM进程中的(通过Spring Cloud Netflix)
五: Portal
-
- 提供Web界面供用户管理配置
- 通过Meta Server获取Admin Service服务列表(IP+Port),通过IP+Port访问服务
- 在Portal侧做load balance、错误重试
六:Client 客户端
-
- Apollo提供的客户端程序,为应用提供配置获取、实时更新等功能
- 通过Meta Server获取Config Service服务列表(IP+Port),通过IP+Port访问服务
- 在Client侧做load balance、错误重试
部署
目前我们开发有多个开发的环境:dev ,devmt,uat ,等环境,阿波罗可以多环境部署,需要明确环境来部署
apollo 多环境部署,Config Service,Admin Service 需要根据环境各自部署一份,Portal 可以只部署一份,管理所有的环境
GitHub下载: https://github.com/ctripcorp/apollo 源码
自定义环境变量 源码修改 ,建议查看源码的 github 文档 文件中有代码的具体路径
现在开始部署
部署前需了解Apollo的项目结构——由一个(Portal:管理界面)和 一个或多个(apolloConfigservice:配置服务)(apolloAdminservice:管理服务)根据个人配置的环境而定
如果只配置一个dev环境那么就是一个Portal、apolloConfigservice、apolloAdminservice服务如果说要部署dev、test、pro环境那就是由一个Portal、三个(apolloConfigservice:配置服务 分别是dev、test、pro)三个(apolloAdminservice:管理服务 分别是dev、test、pro)这个很重要,先了解继续看下面
上面提到需要外部依赖也就是mysql进行数据存储,所以需要先创建一个mysql并且进行初始化数据 那么先用docker-compose进行编写
apollo-db: image: mysql:5.7 container_name: apollo-db restart: always command: --default-authentication-plugin=mysql_native_password environment: TZ: Asia/Shanghai MYSQL_ROOT_PASSWORD: hzs888 ports: - "23306:3306"
然后执行docker-compose -f apollodb.yml 创建容器,然后开始导入数据,导入数据可以参考官网上给出的地址
官方文档: https://www.apolloconfig.com/
SERVER_SERVLET_CONTEXT_PATH: Portal挂载到nginx/slb后如何设置相对路径
apolloportaldb.sql: https://github.com/apolloconfig/apollo/blob/master/scripts/sql/apolloportaldb.sql
apolloconfigdb.sql: https://github.com/apolloconfig/apollo/blob/master/scripts/sql/apolloconfigdb.sql
先拿到两个sql文件,但是不要着急执行,先完下面操作后操作
然后开始准备apollo-compose.yml 文件
version: '3' services: apolloConfigservice-dev: container_name: apolloConfigservice-dev image: apolloconfig/apollo-configservice volumes: - ./config_dev_logs:/opt/logs ports: - "28080:8080" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://xxx.xx.xx.xxx:23306/ApolloConfigDBdev?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=root - SPRING_DATASOURCE_PASSWORD=hzs888 restart: always apolloAdminservice-dev: depends_on: - apolloConfigservice-dev container_name: apolloAdminservice-dev image: apolloconfig/apollo-adminservice volumes: - ./admin_dev_logs:/opt/logs ports: - "28090:8090" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://xxx.xx.xx.xxx:23306/ApolloConfigDBdev?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=root - SPRING_DATASOURCE_PASSWORD=hzs888 restart: always apolloPortal: depends_on: - apolloAdminservice-dev container_name: apolloPortal image: apolloconfig/apollo-portal volumes: - ./portal_logs:/opt/logs ports: - 28070:8070 environment: - SPRING_DATASOURCE_URL=jdbc:mysql://xxx.xx.xx.xxx:23306/ApolloPortalDB?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=root - SPRING_DATASOURCE_PASSWORD=hzs888 - APOLLO_PORTAL_ENVS=dev - DEV_META=http://xxx.xx.xx.xxx:28080 restart: always
这里要注意的是 apollo-compose.yml文件的配置内容要与之前创建的数据库内容一致,不然服务无法正常启动,可以通过 docker-compose logs id -f --tail=500 查看
然后在执行 docker-compose up -d 命令拉取镜像生成容器 (开放端口)
然后进入mysql修改配置信息 eureka.service.url修改成自己的服务器的地址
修改后apollo-configservice会从DB中读取数据
然后通过浏览器登录:http://xxx.xx.xx.xxx:28070/、http://xxx.xx.xx.xxx:28080/、http://xxx.xx.xx.xxx:28090/如果开放端口后都是可访问的 (默认登录账号/密码: apollo/admin)
如果部署的有问题这里会提示问题的所在,就需要自己看日志去排查了
下面继续介绍部署多个环境 dev、test、pro环境的配置信息
MY_HOST=xxx SPRING_DATASOURCE_HOST_PORT=xxx:31111 SPRING_DATASOURCE_USERNAME=root SPRING_DATASOURCE_PASSWORD=xxx SERVER_PORT_CONFIG_DEV=8081 SERVER_PORT_CONFIG_TEST=8082 SERVER_PORT_CONFIG_PRO=8083 SERVER_PORT_ADMIN_DEV=8091 SERVER_PORT_ADMIN_TEST=8092 SERVER_PORT_ADMIN_PRO=8093 SERVER_PORT_PORTAL=8071
version: '3' services: apolloConfigservice-dev: container_name: apolloConfigservice-dev image: apolloconfig/apollo-configservice volumes: - ./config_dev_logs:/opt/logs ports: - "${SERVER_PORT_CONFIG_DEV}:8080" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/ApolloConfigDBdev?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME} - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD} restart: always apolloConfigservice-test: container_name: apolloConfigservice-test image: apolloconfig/apollo-configservice volumes: - ./config_test_logs:/opt/logs ports: - "${SERVER_PORT_CONFIG_TEST}:8080" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/ApolloConfigDBtest?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME} - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD} restart: always apolloConfigservice-pro: container_name: apolloConfigservice-pro image: apolloconfig/apollo-configservice volumes: - ./config_pro_logs:/opt/logs ports: - "${SERVER_PORT_CONFIG_PRO}:8080" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/ApolloConfigDBpro?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME} - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD} restart: always apolloAdminservice-dev: depends_on: - apolloConfigservice-dev container_name: apolloAdminservice-dev image: apolloconfig/apollo-adminservice volumes: - ./admin_dev_logs:/opt/logs ports: - "${SERVER_PORT_ADMIN_DEV}:8090" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/ApolloConfigDBdev?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME} - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD} restart: always apolloAdminservice-test: depends_on: - apolloConfigservice-test container_name: apolloAdminservice-test image: apolloconfig/apollo-adminservice volumes: - ./admin_test_logs:/opt/logs ports: - "${SERVER_PORT_ADMIN_TEST}:8090" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/ApolloConfigDBtest?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME} - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD} restart: always apolloAdminservice-pro: depends_on: - apolloConfigservice-pro container_name: apolloAdminservice-pro image: apolloconfig/apollo-adminservice volumes: - ./admin_pro_logs:/opt/logs ports: - "${SERVER_PORT_ADMIN_PRO}:8090" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/ApolloConfigDBpro?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME} - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD} restart: always apolloPortal: depends_on: - apolloAdminservice-dev - apolloAdminservice-test - apolloAdminservice-pro container_name: apolloPortal image: apolloconfig/apollo-portal volumes: - ./portal_logs:/opt/logs ports: - 8071:8070 ports: - "${SERVER_PORT_PORTAL}:8070" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/ApolloPortalDB?characterEncoding=utf8 - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME} - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD} - APOLLO_PORTAL_ENVS=dev,test,pro - DEV_META=http://${MY_HOST}:${SERVER_PORT_CONFIG_DEV} - TEST_META=http://${MY_HOST}:${SERVER_PORT_CONFIG_TEST} - PRO_META=http://${MY_HOST}:${SERVER_PORT_CONFIG_PRO} restart: always
然后个人参考链接如下:https://blog.csdn.net/weixin_45509582/article/details/128929099
有问题后续再补充
最后是通过.net core6进行注入并读取配置
#region 注入Apollo配置中心 // 添加Apollo配置中心 builder.Host.ConfigureAppConfiguration((context, b) => { b.AddApollo(b.Build().GetSection("Apollo")) //b.AddApollo(configuration.GetSection("apollo")) .AddDefault(); }); #endregion IConfiguration configuration = builder.Configuration;
通过configuration["mysqlConnection"]进行获取值