apollo搭建、自定義環(huán)境

在搭建使用過程中也是遇到各種問題,特寫下此文章記錄一下,也希望給予看到這篇文章的小伙伴一絲幫助。

1. 搭建

1.1 環(huán)境要求

mysql: 5.6.5+
java: 1.8+

1.2 兩種搭建方式

1.2.1 Quick Start

apollo服務(wù)端共需兩個(gè)數(shù)據(jù)庫:ApolloPortalDBApolloConfigDB

  • 執(zhí)行 .../代碼目錄/sql/兩個(gè)sql文件 apolloportaldb.sqlapolloconfigdb.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 )

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.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 = 

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 并命名為 ApolloConfigDBApolloConfigDB_SIT, ApolloConfigDB_UAT
  • 修改ServiceConfig 表,eureka.service.url 指向自己的Eureka地址
dev
sit

uat
  • 修改ApolloPortalDB ServiceConfig apollo.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 修改代碼

  • Env com.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;
  }
}
  • EnvUtils com.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;
    }
  }
}
  • LegacyMetaServerProvider com.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
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

友情鏈接更多精彩內(nèi)容