目錄
- Apollo 配置中心是什么:
- Apollo的特性
- 客戶端架構(gòu)
- 架構(gòu)和模塊
- 一:Config Service提供配置的讀取、推送等功能,服務(wù)對象是Apollo客戶端
- 二:Admin Service提供配置的修改、發(fā)布等功能,服務(wù)對象是Apollo Portal(管理界面)
- 三: Meta Server 在Eureka之上我們架了一層Meta Server用于封裝Eureka的服務(wù)發(fā)現(xiàn)接口
- 四:Eureka java的一個(gè)服務(wù)發(fā)現(xiàn)的組件
- 五: Portal
- 六:Client 客戶端
- 部署
- 踩坑
- 學(xué)習(xí)鏈接
Apollo 配置中心是什么:
Apollo是攜程框架部門研發(fā)的開源配置管理中心,能夠集中化管理應(yīng)用不同環(huán)境、不同集群的配置,配置修改后能夠?qū)崟r(shí)推送到應(yīng)用端,并且具備規(guī)范的權(quán)限、流程治理等特性。
Apollo的特性
- 統(tǒng)一管理不同環(huán)境、不同集群的配置
Apollo提供了一個(gè)統(tǒng)一界面集中式管理不同環(huán)境(environment)、不同集群(cluster)、不同命名空間(namespace)的配置。
同一份代碼部署在不同的集群,可以有不同的配置,比如zookeeper的地址等
通過命名空間(namespace)可以很方便地支持多個(gè)不同應(yīng)用共享同一份配置,同時(shí)還允許應(yīng)用對共享的配置進(jìn)行覆蓋
- 配置修改實(shí)時(shí)生效(熱發(fā)布)
用戶在Apollo修改完配置并發(fā)布后,客戶端能實(shí)時(shí)(1秒)接收到最新的配置,并通知到應(yīng)用程序
所有的配置發(fā)布都有版本概念,從而可以方便地支持配置的回滾
支持配置的灰度發(fā)布,比如點(diǎn)了發(fā)布后,只對部分應(yīng)用實(shí)例生效,等觀察一段時(shí)間沒問題后再推給所有應(yīng)用實(shí)例
- 權(quán)限管理、發(fā)布審核、操作審計(jì)
應(yīng)用和配置的管理都有完善的權(quán)限管理機(jī)制,對配置的管理還分為了編輯和發(fā)布兩個(gè)環(huán)節(jié),從而減少人為的錯(cuò)誤。
所有的操作都有審計(jì)日志,可以方便地追蹤問題
可以在界面上方便地看到配置在被哪些實(shí)例使用
.Net的原生客戶端,方便應(yīng)用集成
同時(shí)提供了Http接口,非Java和.Net應(yīng)用也可以方便地使用
Apollo自身提供了比較完善的統(tǒng)一配置管理界面,支持多環(huán)境、多數(shù)據(jù)中心配置管理、權(quán)限、流程治理等特性。不過Apollo出于通用性考慮,不會(huì)對配置的修改做過多限制,只要符合基本的格式就能保存,不會(huì)針對不同的配置值進(jìn)行針對性的校驗(yàn),如數(shù)據(jù)庫用戶名、密碼,Redis服務(wù)地址等
對于這類應(yīng)用配置,Apollo支持應(yīng)用方通過開放平臺(tái)API在Apollo進(jìn)行配置的修改和發(fā)布,并且具備完善的授權(quán)和權(quán)限控制
配置中心作為基礎(chǔ)服務(wù),可用性要求非常高,這就要求Apollo對外部依賴盡可能地少
目前唯一的外部依賴是MySQL,所以部署非常簡單,只要安裝好Java和MySQL就可以讓Apollo跑起來
Apollo還提供了打包腳本,一鍵就可以生成所有需要的安裝包,并且支持自定義運(yùn)行時(shí)參數(shù)
客戶端架構(gòu)
![](/d/20211016/57fd14465b6732c78877129507112fee.gif)
架構(gòu)和模塊
![](/d/20211016/b196f6a99514c0989d96cb91c3663658.gif)
一:Config Service提供配置的讀取、推送等功能,服務(wù)對象是Apollo客戶端
- 提供配置獲取接口
- 提供配置更新推送接口(基于Http long polling)
服務(wù)端使用Spring DeferredResult實(shí)現(xiàn)異步化,從而大大增加長連接數(shù)量
目前使用的tomcat embed默認(rèn)配置是最多10000個(gè)連接(可以調(diào)整),使用了4C8G的虛擬機(jī)實(shí)測可以支撐10000個(gè)連接,所以滿足需求(一個(gè)應(yīng)用實(shí)例只會(huì)發(fā)起一個(gè)長連接)。
二:Admin Service提供配置的修改、發(fā)布等功能,服務(wù)對象是Apollo Portal(管理界面)
- 提供配置管理接口
- 提供配置修改、發(fā)布等接口
- 接口服務(wù)對象為Portal
三: Meta Server 在Eureka之上我們架了一層Meta Server用于封裝Eureka的服務(wù)發(fā)現(xiàn)接口
- Portal通過域名訪問Meta Server獲取Admin Service服務(wù)列表(IP+Port)
- Client通過域名訪問Meta Server獲取Config Service服務(wù)列表(IP+Port)
- Meta Server從Eureka獲取Config Service和Admin Service的服務(wù)信息,相當(dāng)于是一個(gè)Eureka Client
- 增設(shè)一個(gè)Meta Server的角色主要是為了封裝服務(wù)發(fā)現(xiàn)的細(xì)節(jié),對Portal和Client而言,永遠(yuǎn)通過一個(gè)Http接口獲取Admin Service和Config Service的服務(wù)信息,而不需要關(guān)心背后實(shí)際的服務(wù)注冊和發(fā)現(xiàn)組件
- Meta Server只是一個(gè)邏輯角色,在部署時(shí)和Config Service是在一個(gè)JVM進(jìn)程中的,所以IP、端口和Config Service一致
四:Eureka java的一個(gè)服務(wù)發(fā)現(xiàn)的組件
- 基于Eureka和Spring Cloud Netflix提供服務(wù)注冊和發(fā)現(xiàn)
- Config Service和Admin Service會(huì)向Eureka注冊服務(wù),并保持心跳
- 為了簡單起見,目前Eureka在部署時(shí)和Config Service是在一個(gè)JVM進(jìn)程中的(通過Spring Cloud Netflix)
五: Portal
- 提供Web界面供用戶管理配置
- 通過Meta Server獲取Admin Service服務(wù)列表(IP+Port),通過IP+Port訪問服務(wù)
- 在Portal側(cè)做load balance、錯(cuò)誤重試
六:Client 客戶端
- Apollo提供的客戶端程序,為應(yīng)用提供配置獲取、實(shí)時(shí)更新等功能
- 通過Meta Server獲取Config Service服務(wù)列表(IP+Port),通過IP+Port訪問服務(wù)
- 在Client側(cè)做load balance、錯(cuò)誤重試
部署
- 目前我們開發(fā)有多個(gè)開發(fā)的環(huán)境:dev ,devmt,uat ,等環(huán)境,阿波羅可以多環(huán)境部署,需要明確環(huán)境來部署
- apollo 多環(huán)境部署,Config Service,Admin Service 需要根據(jù)環(huán)境各自部署一份,Portal 可以只部署一份,管理所有的環(huán)境
- GitHub下載: https://github.com/ctripcorp/apollo 源碼
- 自定義環(huán)境變量 源碼修改 ,建議查看源碼的 github 文檔 文件中有代碼的具體路徑
Env
com.ctrip.framework.apollo.core.enums
添加 DEVMT
public enum Env{
LOCAL, DEV, FWS, FAT, UAT, LPT, PRO, TOOLS, UNKNOWN, DEVMT;
public static Env fromString(String env) {
Env environment = EnvUtils.transformEnv(env);
Preconditions.checkArgument(environment != UNKNOWN, String.format("Env %s is invalid", env));
return environment;
}
}
EnvUtils
com.ctrip.framework.apollo.core.enums
添加 DEVMT
public final class EnvUtils {
public static Env transformEnv(String envName) {
if (StringUtils.isBlank(envName)) {
return Env.UNKNOWN;
}
switch (envName.trim().toUpperCase()) {
case "LPT":
return Env.LPT;
case "FAT":
case "FWS":
return Env.FAT;
case "UAT":
return Env.UAT;
case "PRO":
case "PROD": //just in case
return Env.PRO;
case "DEV":
return Env.DEV;
case "LOCAL":
return Env.LOCAL;
case "TOOLS":
return Env.TOOLS;
case "DEVMT":
return Env.DEVMT;
default:
return Env.UNKNOWN;
}
}
}
LegacyMetaServerProvider
com.ctrip.framework.apollo.core.internals
添加 DEVMT
private void initialize() {
Properties prop = new Properties();
prop = ResourceUtils.readConfigFile("apollo-env.properties", prop);
domains.put(Env.LOCAL, getMetaServerAddress(prop, "local_meta", "local.meta"));
domains.put(Env.DEV, getMetaServerAddress(prop, "dev_meta", "dev.meta"));
domains.put(Env.FAT, getMetaServerAddress(prop, "fat_meta", "fat.meta"));
domains.put(Env.UAT, getMetaServerAddress(prop, "uat_meta", "uat.meta"));
domains.put(Env.LPT, getMetaServerAddress(prop, "lpt_meta", "lpt.meta"));
domains.put(Env.PRO, getMetaServerAddress(prop, "pro_meta", "pro.meta"));
domains.put(Env.SIT, getMetaServerAddress(prop, "devmt_meta", "devmt.meta"));
}
檢查 ,安裝 JAVA JDK 和 Maven ,進(jìn)入源碼文件夾 Scripts 下 執(zhí)行 Build 文件,編譯打包apollo
復(fù)制 apollo-configservice/target ,apollo-adminservice/target ,apollo-portal/target ,文件下面的zip 文件和Dockerfile 到指定的文件夾,如下圖
![](/d/20211016/e4977acfc284dcf16a565a0fe7f344fb.gif)
修改 configservice,adminservice,portal ,Dockerfile 文件中的版本號(hào)和zip文件的版本號(hào)一致
在源碼的Scripts 文件夾下面找到sql的部署腳本,在Mysql中執(zhí)行,
修改 apolloconfigdb,eureka.service.url 的地址為,Configservice 部署的地址例如 ,http://192.168.xx.xxx:8081/eureka/,
修改portal 的 apollo.portal.envs 為:多環(huán)境部署的環(huán)境變量,例如 dev,devmt
修改portal 的apollo.portal.meta.servers 為 :部署的Configservice 部署的地址,例如
{
"DEV":"http://192.168.xx.xxx:8081",
"DEVMT":"http://192.168.xx.xxx:8082"
}
編寫docker-compose.yml
version: "3"
services:
apollo-configservice:
container_name: apollo-configservice
build: apollo-configservice/
image: apollo-configservice
ports:
- 8081:8080
volumes:
- /root/apollo/apollocompose/logs:/opt/logs
environment:
- SPRING_DATASOURCE_URL= jdbc:mysql://192.168.xx.xxx:3306/apolloconfigdbdev?characterEncoding=utf8&serverTimezone=Asia/Shanghai
- SPRING_DATASOURCE_USERNAME= xxxxxx
- SPRING_DATASOURCE_PASSWORD= xxxxxx
apollo-adminservice:
container_name: apollo-adminservice
build: apollo-adminservice/
image: apollo-adminservice
ports:
- 8091:8090
volumes:
- /root/apollo/apollocompose/logs:/opt/logs
environment:
- SPRING_DATASOURCE_URL= jdbc:mysql://192.168.xx.xxx:3306/apolloconfigdbdev?characterEncoding=utf8&serverTimezone=Asia/Shanghai
- SPRING_DATASOURCE_USERNAME= xxxxxx
- SPRING_DATASOURCE_PASSWORD= xxxxxx
apollo-configservice-uat:
container_name: apollo-configservice-uat
build: apollo-configservice/
image: apollo-configservice
ports:
- 8082:8080
volumes:
- /root/apollo/apollocompose/logs:/opt/logs
environment:
- SPRING_DATASOURCE_URL= jdbc:mysql://192.168.xx.xxx:3306/apolloconfigdbuat?characterEncoding=utf8&serverTimezone=Asia/Shanghai
- SPRING_DATASOURCE_USERNAME= xxxxxx
- SPRING_DATASOURCE_PASSWORD= xxxxxx
apollo-adminservice-uat:
container_name: apollo-adminservice-uat
build: apollo-adminservice/
image: apollo-adminservice
ports:
- 8092:8090
volumes:
- /root/apollo/apollocompose/logs:/opt/logs
environment:
- SPRING_DATASOURCE_URL= jdbc:mysql://192.168.xx.xxx:3306/apolloconfigdbuat?characterEncoding=utf8&serverTimezone=Asia/Shanghai
- SPRING_DATASOURCE_USERNAME= xxxxxx
- SPRING_DATASOURCE_PASSWORD= xxxxxx
apollo-portal:
container_name: apollo-portal
build: apollo-portal/
image: apollo-portal
restart: always
depends_on:
- apollo-adminservice
environment:
- SPRING_DATASOURCE_URL= jdbc:mysql://192.168.xx.xxx:3306/apolloportaldb?characterEncoding=utf8&serverTimezone=Asia/Shanghai
- SPRING_DATASOURCE_USERNAME= xxxxxx
- SPRING_DATASOURCE_PASSWORD= xxxxxx
volumes:
- /root/apollo/apollocompose/logs:/opt/logs
- /root/apollo/apollocompose/apollo-env.properties:/apollo-portal/config/apollo-env.properties
ports:
- 8071:8070
修改 本地 apollo-env.properties 環(huán)境變量配置為:與 自定義配置或攜程定義的環(huán)境變量一致
dev.meta=http://localhost:8081
devmt.meta=http://localhost:8082
執(zhí)行 docker-compose ,啟動(dòng)有延遲,多等待一會(huì)兒
踩坑
自定義環(huán)境變量需要下載源碼,編譯,sql腳本和數(shù)據(jù)庫連接配置,一定要用官網(wǎng)最新的連接配置,不同版本,sql腳本可能不一致部署機(jī)器的運(yùn)行內(nèi)存要充足部署啟動(dòng)后,configservice,adminservice,portal ,Mata service ,Eureka 需要通訊,所以啟動(dòng)后,有延遲,等一段時(shí)間在看是否部署成功服務(wù)器端口,防火墻需要開啟對應(yīng)的端口,8080,8090,8071 和 自己指定的端口
學(xué)習(xí)鏈接
楊波老師架構(gòu)解析文章:https://blog.csdn.net/yang75108/article/details/86989524?spm=1001.2014.3001.5501
Apollo 設(shè)計(jì)文檔:https://www.apolloconfig.com/
Apollo 搭建自定義環(huán)境:https://www.jianshu.com/p/f84da093944f
以上就是docker-compose 部署 Apollo 自定義環(huán)境的詳細(xì)內(nèi)容,更多關(guān)于docker-compose 部署 Apollo環(huán)境的資料請關(guān)注腳本之家其它相關(guān)文章!