說明
本次部署采用的 apollo-config :2.2.0 版本趋箩，mysql8.0.31（2.2.0版本源碼的驅動應該是最高能支持到 mysql8.2.0），參考官方的 部署架構 單機颁褂，三個環(huán)境 架構般贼，在本地使用 docker-compose 完成 dev送粱、fat栓袖、uat 和 pro 四個環(huán)境的部署讲逛，僅用于測試亏吝。生產部署，可以參考官方的高可用部署盏混。
建議先看看官方的部署架構蔚鸥，比較重要的是，configservice 和 adminservice 是一一對應的许赃，每多一套環(huán)境止喷，至少需要部署一個 configservice 和 adminservice
其他一些參考的官方文檔：
apollo 配置中心 github repo
apollo 配置中心文檔
docker 部署文檔
使用docker-compose搭建高可用Apollo配置中心
客戶端sdk: shima-park/agollo
部署流程
- 創(chuàng)建數據庫
Apollo服務端共需要兩個數據庫：ApolloPortalDB 和 ApolloConfigDB，數據庫混聊、表的創(chuàng)建和樣例數據都分別準備了 sql 文件弹谁，只需要導入數據庫即可。
需要注意的是 ApolloPortalDB 只需要在生產環(huán)境部署一個即可句喜，而 ApolloConfigDB 需要在每個環(huán)境部署一套预愤，如 dev、fat咳胃、uat 和 pro 分別部署4套 ApolloConfigDB植康。
導入，以原生mysql客戶端為例：
source /your_local_path/scripts/sql/profiles/mysql-default/apolloportaldb.sql
source /your_local_path/scripts/sql/profiles/mysql-default/apolloconfigdb.sql
導入成功后執(zhí)行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 環(huán)境修改為 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 配置參考：
最終的目錄如下：
image.png
- .env 文件內容：
# local 環(huán)境 .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 環(huán)境 ================================
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提供配置的修改军浆、發(fā)布等功能，服務對象是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 環(huán)境 ================================
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提供配置的修改掰盘、發(fā)布等功能，服務對象是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 環(huán)境 ================================
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提供配置的修改、發(fā)布等功能申钩，服務對象是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 環(huán)境 ================================
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提供配置的修改撒遣、發(fā)布等功能邮偎，服務對象是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
- 登錄驗證
登錄地址：http://localhost:8070/
eureka 注冊信息：http://localhost:8080/
默認賬戶密碼:
apollo
admin
修改下 portalDB 配置:
如果創(chuàng)建一個項目后未自動加載出四個環(huán)境，可以修改下 portalDB 配置义黎，這兩項不為空時會優(yōu)先使用系統(tǒng)配置里的值禾进，否則使用 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 配置中心里創(chuàng)建的應用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"`
}
