docker-compose 部署 apollo 配置中心

说明

本次部署采用的 apollo-config :2.2.0 版本，mysql8.0.31（2.2.0版本源码的驱动应该是最高能支持到 mysql8.2.0），参考官方的 部署架构 单机，三个环境 架构，在本地使用 docker-compose 完成 dev、fat、uat 和 pro 四个环境的部署，仅用于测试。生产部署，可以参考官方的高可用部署。

建议先看看官方的部署架构，比较重要的是，configservice 和 adminservice 是一一对应的，每多一套环境，至少需要部署一个 configservice 和 adminservice

其他一些参考的官方文档：
apollo 配置中心 github repo
apollo 配置中心文档
docker 部署文档
使用docker-compose搭建高可用Apollo配置中心
客户端sdk: shima-park/agollo

部署流程

  • 创建数据库

Apollo服务端共需要两个数据库：ApolloPortalDB 和 ApolloConfigDB，数据库、表的创建和样例数据都分别准备了 sql 文件，只需要导入数据库即可。

需要注意的是 ApolloPortalDB 只需要在生产环境部署一个即可，而 ApolloConfigDB 需要在每个环境部署一套，如 dev、fat、uat 和 pro 分别部署4套 ApolloConfigDB。

下载地址：https://www.apolloconfig.com/#/zh/deployment/distributed-deployment-guide?id=_211-%e5%88%9b%e5%bb%baapolloportaldb

导入，以原生mysql客户端为例：

source /your_local_path/scripts/sql/profiles/mysql-default/apolloportaldb.sql

source /your_local_path/scripts/sql/profiles/mysql-default/apolloconfigdb.sql

导入成功后执行sql进行验证：

# ApolloPortalDB
select `Id`, `Key`, `Value`, `Comment` from `ApolloPortalDB`.`ServerConfig` limit 1;

# ApolloConfigDB
select `Id`, `Key`, `Value`, `Comment` from `ApolloPortalDB`.`ServerConfig` limit 1;
  • 修改数据库配置

修改 ApolloConfigDB dev、fat、uat、pro 四个库的配置，找到ServerConfig 表的 eureka.service.url 这项配置，修改其 value

image.png

如 pro 环境修改为 http://apollo-configservice-pro:8080/eureka/ ，通过docker 网络访问，默认的 http://localhost:8080/eureka/ 可能导致eureka 注册不上

  • 使用到的 docker 镜像
docker pull apolloconfig/apollo-configservice:2.2.0
docker pull apolloconfig/apollo-adminservice:2.2.0
docker pull apolloconfig/apollo-portal:2.2.0
  • 使用 docker-compose 编排容器（本地）

docker-compose.yml 配置参考：

https://github.com/apolloconfig/apollo/blob/a73d0328e41101153e475a9934cb4e9e508afe0e/docs/zh/deployment/distributed-deployment-guide.md?plain=1#L803

最终的目录如下：


image.png
  • .env 文件内容：
# local 环境 .env 文件

# 数据库配置,默认 config 和 portal 在一个集群里
SPRING_DATASOURCE_HOST_PORT=mysql8.0.31:3306
SPRING_DATASOURCE_PORTAL_DBNAME=ApolloPortalDB
SPRING_DATASOURCE_CONFIG_DBNAME_DEV=ApolloConfigDBDev
SPRING_DATASOURCE_CONFIG_DBNAME_FAT=ApolloConfigDBFat
SPRING_DATASOURCE_CONFIG_DBNAME_UAT=ApolloConfigDBUat
SPRING_DATASOURCE_CONFIG_DBNAME_PRO=ApolloConfigDBPro
SPRING_DATASOURCE_USERNAME=root
SPRING_DATASOURCE_PASSWORD=root

# config server 配置
SERVER_PORT_CONFIG_DEV=8080
SERVER_PORT_CONFIG_FAT=8082
SERVER_PORT_CONFIG_UAT=8083
SERVER_PORT_CONFIG_PRO=8084

# admin server 配置
SERVER_PORT_ADMIN_DEV=8090
SERVER_PORT_ADMIN_FAT=8092
SERVER_PORT_ADMIN_UAT=8093
SERVER_PORT_ADMIN_PRO=8094

# portal server 配置
SERVER_PORT_PORTAL=8070

# 宿主机地址
MY_HOST=localhost
# 是否重启 always、no、on-failure
RESTART=no
# 网络
NETWORK=mysql_default
  • docker-compose-local.yml 文件内容：
    到 local 目录下运行命令：docker-compose -f docker-compose-local.yml up -d
    ps: 程序启动比较慢，容器运行起来2-3分钟左右，功能才可完全使用
version: "3"
services:
  # ================================ dev 环境 ================================
  apollo-configservice-dev: # Config Service提供配置的读取、推送等功能，服务对象是Apollo客户端
    image: apolloconfig/apollo-configservice:2.2.0  
    container_name: apollo-configservice-dev
    volumes:
          - ./logs/apollo-configservice-dev:/opt/logs
    ports:
      - "${SERVER_PORT_CONFIG_DEV}:8080"
    environment:
      #- SERVER_PORT=8080
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-configservice-dev:8080
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-dev
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_DEV}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}
  apollo-adminservice-dev: # Admin Service提供配置的修改、发布等功能，服务对象是Apollo Portal（管理界面）
    image: apolloconfig/apollo-adminservice:2.2.0
    container_name: apollo-adminservice-dev
    volumes:
      - ./logs/apollo-adminservice-dev:/opt/logs
    ports:
      - "${SERVER_PORT_ADMIN_DEV}:8090"
    depends_on:
      - apollo-configservice-dev
    environment:    
      #- SERVER_PORT=8090
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-adminservice-dev:8090
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-dev      
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_DEV}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}

  # ================================ fat 环境 ================================
  apollo-configservice-fat: # Config Service提供配置的读取、推送等功能，服务对象是Apollo客户端
    image: apolloconfig/apollo-configservice:2.2.0  
    container_name: apollo-configservice-fat
    volumes:
          - ./logs/apollo-configservice-fat:/opt/logs
    ports:
      - "${SERVER_PORT_CONFIG_FAT}:8080"
    environment:
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-configservice-fat:8080
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-fat
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_FAT}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}
  apollo-adminservice-fat: # Admin Service提供配置的修改、发布等功能，服务对象是Apollo Portal（管理界面）
    image: apolloconfig/apollo-adminservice:2.2.0
    container_name: apollo-adminservice-fat
    volumes:
      - ./logs/apollo-adminservice-fat:/opt/logs
    ports:
      - "${SERVER_PORT_ADMIN_FAT}:8090"
    depends_on:
      - apollo-configservice-fat
    environment:    
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-adminservice-fat:8090
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-fat
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_FAT}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}

  # ================================ uat 环境 ================================
  apollo-configservice-uat: # Config Service提供配置的读取、推送等功能，服务对象是Apollo客户端
    image: apolloconfig/apollo-configservice:2.2.0  
    container_name: apollo-configservice-uat
    volumes:
          - ./logs/apollo-configservice-uat:/opt/logs
    ports:
      - "${SERVER_PORT_CONFIG_UAT}:8080"
    environment:
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-configservice-uat:8080
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-uat
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_UAT}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}
  apollo-adminservice-uat: # Admin Service提供配置的修改、发布等功能，服务对象是Apollo Portal（管理界面）
    image: apolloconfig/apollo-adminservice:2.2.0
    container_name: apollo-adminservice-uat
    volumes:
      - ./logs/apollo-adminservice-uat:/opt/logs
    ports:
      - "${SERVER_PORT_ADMIN_UAT}:8090"
    depends_on:
      - apollo-configservice-uat
    environment:    
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-adminservice-uat:8090
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-uat
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_UAT}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}

  # ================================ prod 环境 ================================  
  apollo-configservice-pro: # Config Service提供配置的读取、推送等功能，服务对象是Apollo客户端
    image: apolloconfig/apollo-configservice:2.2.0  
    container_name: apollo-configservice-pro
    volumes:
          - ./logs/apollo-configservice-pro:/opt/logs
    ports:
      - "${SERVER_PORT_CONFIG_PRO}:8080"
    environment:
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-configservice-pro:8080
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-pro
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_PRO}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}
  apollo-adminservice-pro: # Admin Service提供配置的修改、发布等功能，服务对象是Apollo Portal（管理界面）
    image: apolloconfig/apollo-adminservice:2.2.0
    container_name: apollo-adminservice-pro
    volumes:
      - ./logs/apollo-adminservice-pro:/opt/logs
    ports:
      - "${SERVER_PORT_ADMIN_PRO}:8090"
    depends_on:
      - apollo-configservice-pro
    environment:    
      - EUREKA_INSTANCE_HOME_PAGE_URL=http://apollo-adminservice-pro:8090
      - EUREKA_INSTANCE_IP_ADDRESS=apollo-configservice-pro
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_CONFIG_DBNAME_PRO}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}
      - SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}
    networks:
      - ${NETWORK}
    restart: ${RESTART}

  # ================================ 管理界面 ================================    
  apollo-portal:
    image: apolloconfig/apollo-portal:2.2.0
    container_name: apollo-portal
    volumes:
      - ./logs/apollo-portal:/opt/logs
    ports:
      - "${SERVER_PORT_PORTAL}:8070"
    depends_on:
      - apollo-adminservice-dev
    environment:
      #- SERVER_PORT=8070
      #- EUREKA_INSTANCE_IP_ADDRESS=http://apollo-portal:8080/eureka/
      - SPRING_DATASOURCE_URL=jdbc:mysql://${SPRING_DATASOURCE_HOST_PORT}/${SPRING_DATASOURCE_PORTAL_DBNAME}?characterEncoding=utf8&useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=root
      - APOLLO_PORTAL_ENVS=dev,fat,uat,pro
      - DEV_META=${MY_HOST}:${SERVER_PORT_CONFIG_DEV}
      - FAT_META=${MY_HOST}:${SERVER_PORT_CONFIG_FAT}
      - UAT_META=${MY_HOST}:${SERVER_PORT_CONFIG_UAT}
      - PRO_META=${MY_HOST}:${SERVER_PORT_CONFIG_PRO}
    networks:
      - ${NETWORK}      
    restart: ${RESTART}
    
# 配置使用本地的 mysql 所在网络    
networks:
  mysql_default:
    external: true

默认账户密码:

apollo
admin

修改下 portalDB 配置:
如果创建一个项目后未自动加载出四个环境，可以修改下 portalDB 配置，这两项不为空时会优先使用系统配置里的值，否则使用 docker-compose 启动时定义的值

# apollo.portal.envs
dev,fat,uat,pro

# apollo.portal.meta.servers
{"dev": "http://apollo-configservice-dev:8080","fat": "http://apollo-configservice-fat:8080","uat": "http://apollo-configservice-uat:8080","pro": "http://apollo-configservice-pro:8080"}
image.png

image.png
  • go 客户端 sdk ：
    可以考虑使用 shima-park/agollo，适配了 viper ，能够方便的把配置映射到golang 结构体，使用体验比较好
package main

import (
    "fmt"
    "github.com/shima-park/agollo/viper-remote"
    "github.com/spf13/viper"
    "time"
)

func main() {
    NewClient()
}

func NewClient() {
    remote.SetAppID("6xdh8k9kuy") // apollo 配置中心里创建的应用id
    v := viper.New()
    v.SetConfigType("prop") // 根据 namespace 实际格式设置对应 type
    err := v.AddRemoteProvider("apollo", "localhost:8080", "application")
    if err != nil {
        panic(fmt.Sprintf("2e8ukhn7sq AddRemoteProvider from apollo error: %+v \n", err))
    }
    err = v.ReadRemoteConfig()
    if err != nil {
        panic(fmt.Sprintf("hp2wuvemae ReadRemoteConfig from apollo error: %+v \n", err))
    }

    // 直接反序列化到结构体中
    var conf kmgMysqlV2.Config
    err = v.Unmarshal(&conf)
    if err != nil {
        panic(fmt.Sprintf("xsjefu3cyg Unmarshal from apollo to kmgMysqlV2.Config error, conf: %+v err:  %+v \n", conf, err))
    }

    // 各种基础类型配置项读取
    // fmt.Println("Host:", v.GetString("db.host"))
    // fmt.Println("Port:", v.GetInt("db.port"))
    // fmt.Println("Timeout:", v.GetDuration("db.timeout"))
    // 获取所有key，所有配置
    // fmt.Println("AllKeys", v.AllKeys(), "AllSettings", v.AllSettings())

    // 启动一个goroutine来同步配置更改
    _ = v.WatchRemoteConfigOnChannel()
    for {
        time.Sleep(60 * time.Second)
        fmt.Println("jvmba3hxtb WatchRemoteConfigOnChannel AllSettings:", v.AllSettings())
    }
}

// 一个简易 mysql 配置
type Config struct {
    Database    string `mapstructure:"database"`
    Host        string `mapstructure:"host"`
    Port        int    `mapstructure:"port"`
    User        string `mapstructure:"user"`
    Password    string `mapstructure:"password"`
    Retry       int    `mapstructure:"retry"`
    MaxOpen     int    `mapstructure:"maxopen"`
    MaxIdle     int    `mapstructure:"maxidle"`
    Lifetime    int    `mapstructure:"lifetime"`
    Timeout     int    `mapstructure:"timeout"`
}
?著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 214,128评论 6赞 493
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 91,316评论 3赞 388
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事?！?“怎么了？”我有些...
    开封第一讲书人阅读 159,737评论 0赞 349
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 57,283评论 1赞 287
  • ?港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 66,384评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 50,458评论 1赞 292
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,467评论 3赞 412
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,251评论 0赞 269
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,688评论 1赞 306
  • ?护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,980评论 2赞 328
  • ?白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,155评论 1赞 342
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,818评论 4赞 337
  • ?日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,492评论 3赞 322
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,142评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,382评论 1赞 267
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,020评论 2赞 365
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,044评论 2赞 352

推荐阅读更多精彩内容