在搭建使用過程中也是遇到各種問題,特寫下此文章記錄一下,也希望給予看到這篇文章的小伙伴一絲幫助。
1. 搭建
1.1 環(huán)境要求
mysql: 5.6.5+
java: 1.8+
1.2 兩種搭建方式
1.2.1 Quick Start
apollo服務(wù)端共需兩個(gè)數(shù)據(jù)庫:ApolloPortalDB和ApolloConfigDB
-
執(zhí)行 .../代碼目錄/sql/兩個(gè)sql文件
apolloportaldb.sql和apolloconfigdb.sql
![]() |
![]() |
|---|
-
配置數(shù)據(jù)庫連接信息
編輯demo.sh文件
#!/bin/bash
# apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3307/ApolloConfigDB?characterEncoding=utf8
apollo_config_db_username=root
apollo_config_db_password= //(如果沒有密碼,留空即可)
# apollo portal db info
apollo_portal_db_url=jdbc:mysql://localhost:3307/ApolloPortalDB?characterEncoding=utf8
apollo_portal_db_username=root
apollo_portal_db_password=
...
-
執(zhí)行啟動(dòng)腳本
啟動(dòng)會(huì)占用8070, 8080, 8090端口,請確保這3個(gè)端口當(dāng)前沒有被使用。
執(zhí)行./demo.sh start注://windows用戶可以右鍵空白處git bash here運(yùn)行sh ./demo.sh命令運(yùn)行
當(dāng)看到如下日志就說明成功了
==== starting service ====
Service logging file is ./service/apollo-service.log
Started [10768]
Waiting for config service startup.......
Config service started. You may visit http://localhost:8080 for service status now!
Waiting for admin service startup....
Admin service started
==== starting portal ====
Portal logging file is ./portal/apollo-portal.log
Started [10846]
Waiting for portal startup......
Portal started. You can visit http://localhost:8070 now!
如果啟動(dòng)遇到了異常,可以分別查看service和portal目錄下的log文件排查問題。
(1.2.1 Quick Start 方式搭建好像是不能修改端口的,修改后不能正常啟動(dòng) o(╥﹏╥)o )
- 訪問 http://localhost:8070 賬號:
apollo密碼:admin
1.2.2 使用源碼構(gòu)建
-
GitHub下載: https://github.com/ctripcorp/apollo/releases
創(chuàng)建數(shù)據(jù)庫同上
若apollo不滿足你的需求,需修改apollo源碼,請執(zhí)行如下步驟
a) GitHub下載: https://github.com/ctripcorp/apollo ;
b) 根據(jù)你的需求修改源碼;
c) 運(yùn)行scripts/build.sh文件,windows運(yùn)行build.bat文件。運(yùn)行完成之后每個(gè)模塊下target目錄會(huì)生成xxx-版本號-github.zip的文件;
d) 取出apollo-adminservice-xxx-github.zip、apollo-configservice-xxx-github.zip、apollo-portal-xxx-github.zip,即上面下載的zip。修改配置
解壓下載的或者build的三個(gè)zip文件,得到adminservice、configservice、portal文件夾
a) adminservice
i) 修改端口號:adminservice/scripts/startup.shSERVER_PORT=7030
#!/bin/bash
SERVICE_NAME=apollo-adminservice
## Adjust log dir if necessary
LOG_DIR=/opt/logs/100003172
## Adjust server port if necessary
SERVER_PORT=7030
## Create log directory if not existed because JDK 8+ won't do that
ii) 修改數(shù)據(jù)庫連接: adminservice/config/application-github.properties
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =
b) configservice
i) 修改端口號:configservice/scripts/startup.sh SERVER_PORT=7020
#!/bin/bash
SERVICE_NAME=apollo-configservice
## Adjust log dir if necessary
LOG_DIR=/opt/logs/100003172
## Adjust server port if necessary
SERVER_PORT=7020
## Create log directory if not existed because JDK 8+ won't do that
ii) 修改數(shù)據(jù)庫連接: configservice/config/application-github.properties
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =
c) portal
i) 修改端口號: portal/scripts/startup.sh SERVER_PORT=7010
#!/bin/bash
SERVICE_NAME=apollo-portal
## Adjust log dir if necessary
LOG_DIR=/opt/logs/100003173
## Adjust server port if necessary
SERVER_PORT=7010
## Create log directory if not existed because JDK 8+ won't do that
ii) 修改數(shù)據(jù)庫連接: portal/config/application-github.properties
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3307/ApolloPortalDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =
iii) 配置環(huán)境列表端口 portal/config/apollo-env.properties
local.meta=http://localhost:8080
dev.meta=http://localhost:7020
#fat.meta=http://localhost:7020
#uat.meta=http://localhost:7020
#lpt.meta=${lpt_meta}
#pro.meta=http://localhost:7020
2. 部署
- 運(yùn)行剛修改的三個(gè)
startup.sh腳本,順序無所謂; - 訪問 http://localhost:7010 即可進(jìn)入apollo portal登錄頁;
- 每次啟動(dòng)停止都要運(yùn)行三個(gè)腳本,著實(shí)麻煩,可以寫個(gè)簡單的腳本,一次性啟動(dòng)停止所有服務(wù);
啟動(dòng)
#!/bin/sh
echo "==== 啟動(dòng)開發(fā)環(huán)境apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/dev/configservice/scripts/startup.sh
/home/zhanhao/service/apollo1.4/dev/adminservice/scripts/startup.sh
echo "==== 啟動(dòng)sit環(huán)境apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/sit/configservice/scripts/startup.sh
/home/zhanhao/service/apollo1.4/sit/adminservice/scripts/startup.sh
echo "==== 啟動(dòng)uat環(huán)境apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/uat/configservice/scripts/startup.sh
/home/zhanhao/service/apollo1.4/uat/adminservice/scripts/startup.sh
echo "==== 啟動(dòng)portal apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/portal/scripts/startup.sh
停止
#!/bin/sh
echo "==== Stopping Apollo Service ===="
/home/zhanhao/service/apollo1.4/portal/scripts/shutdown.sh
/home/zhanhao/service/apollo1.4/dev/adminservice/scripts/shutdown.sh
/home/zhanhao/service/apollo1.4/dev/configservice/scripts/shutdown.sh
/home/zhanhao/service/apollo1.4/sit/adminservice/scripts/shutdown.sh
/home/zhanhao/service/apollo1.4/sit/configservice/scripts/shutdown.sh
/home/zhanhao/service/apollo1.4/uat/adminservice/scripts/shutdown.sh
/home/zhanhao/service/apollo1.4/uat/configservice/scripts/shutdown.sh
echo "==== All apollo Service Stoped ===="
3. 自定義添加環(huán)境
-
效果如下:
多個(gè)環(huán)境
3.1 創(chuàng)建數(shù)據(jù)庫
- 導(dǎo)入三份
apolloconfigdb.sql并命名為ApolloConfigDB,ApolloConfigDB_SIT,ApolloConfigDB_UAT - 修改
ServiceConfig表,eureka.service.url指向自己的Eureka地址



- 修改
ApolloPortalDBServiceConfigapollo.portal.envs配置dev,uat,sit
portal
3.2 修改每個(gè)環(huán)境端口號及數(shù)據(jù)庫連接
3.2.1 DEV
a) adminservice
i) 修改端口號:adminservice/scripts/startup.sh SERVER_PORT=7030
#!/bin/bash
SERVICE_NAME=apollo-adminservice
## Adjust log dir if necessary
LOG_DIR=/opt/logs/100003172
## Adjust server port if necessary
SERVER_PORT=7030
## Create log directory if not existed because JDK 8+ won't do that
ii) 修改數(shù)據(jù)庫連接: adminservice/config/application-github.properties
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =
b) configservice
i) 修改端口號:configservice/scripts/startup.sh SERVER_PORT=7020
#!/bin/bash
SERVICE_NAME=apollo-configservice
## Adjust log dir if necessary
LOG_DIR=/opt/logs/100003172
## Adjust server port if necessary
SERVER_PORT=7020
## Create log directory if not existed because JDK 8+ won't do that
ii) 修改數(shù)據(jù)庫連接: configservice/config/application-github.properties
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password =
adminservice SERVER_PORT=7030
adminservice spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB? characterEncoding=utf8
configservice SERVER_PORT=7020
configservice spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB? characterEncoding=utf8
3.2.2 SIT
adminservice SERVER_PORT=7031
adminservice spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB_SIT? characterEncoding=utf8
configservice SERVER_PORT=7021
configservice spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB_SIT? characterEncoding=utf8
3.2.3 UAT
adminservice SERVER_PORT=7032
adminservice spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB_UAT? characterEncoding=utf8
configservice SERVER_PORT=7022
configservice spring.datasource.url = jdbc:mysql://localhost:3307/ApolloConfigDB_UAT? characterEncoding=utf8
3.3 修改配置文件及代碼
無論多少個(gè)環(huán)境都只需要一個(gè) portal 服務(wù),每個(gè)環(huán)境都需要自己的adminservice、configservice和數(shù)據(jù)庫
例如:SIT環(huán)境都要額外再部署adminservice、configservice服務(wù),并設(shè)置自己端口號;還需自己的ApolloConfigDB_SIT數(shù)據(jù)庫
3.3.2 修改配置文件
-
build.bat修改連接數(shù)據(jù)庫及各環(huán)境IP、端口號;
build.bat apollo-env.properties添加sit
local.meta=http://localhost:8080
dev.meta=${dev_meta}
fat.meta=${fat_meta}
uat.meta=${uat_meta}
lpt.meta=${lpt_meta}
pro.meta=${pro_meta}
sit.meta=${sit_meta}
3.3.2 修改代碼
-
Envcom.ctrip.framework.apollo.core.enums添加sit
public enum Env{
LOCAL, DEV, FWS, FAT, UAT, LPT, PRO, TOOLS, UNKNOWN, SIT;
public static Env fromString(String env) {
Env environment = EnvUtils.transformEnv(env);
Preconditions.checkArgument(environment != UNKNOWN, String.format("Env %s is invalid", env));
return environment;
}
}
-
EnvUtilscom.ctrip.framework.apollo.core.enums添加sit
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 "SIT":
return Env.SIT;
default:
return Env.UNKNOWN;
}
}
}
-
LegacyMetaServerProvidercom.ctrip.framework.apollo.core.internals添加sit
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, "sit_meta", "sit.meta"));
}
3.4 執(zhí)行腳本啟動(dòng)服務(wù)
#!/bin/sh
echo "==== 啟動(dòng)開發(fā)環(huán)境apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/dev/configservice/scripts/startup.sh
/home/zhanhao/service/apollo1.4/dev/adminservice/scripts/startup.sh
echo "==== 啟動(dòng)sit環(huán)境apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/sit/configservice/scripts/startup.sh
/home/zhanhao/service/apollo1.4/sit/adminservice/scripts/startup.sh
echo "==== 啟動(dòng)uat環(huán)境apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/uat/configservice/scripts/startup.sh
/home/zhanhao/service/apollo1.4/uat/adminservice/scripts/startup.sh
echo "==== 啟動(dòng)portal apollo服務(wù) ===="
/home/zhanhao/service/apollo1.4/portal/scripts/startup.sh





