携程Apollo服务端部署与操作

Apollo简介

Apollo（阿波罗）是携程框架部门研发的分布式配置中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性，适用于微服务配置管理场景。

所谓分布式配置中心就是把应用内的配置文件通过技术手段放在云端，在云端配置过后可以在不发包的情况下立刻让配置生效从而节省大量打包、发包、重启服务的时间。

项目地址：https://github.com/ctripcorp/apollo
快速构建脚本：https://github.com/nobodyiam/apollo-build-scripts
Java客户端使用指南：https://github.com/ctripcorp/apollo/wiki/Java

Apollo服务端部署

下载源码或者安装包

快速构建脚本（推荐）

快速构建脚本：https://github.com/nobodyiam/apollo-build-scripts

可以手动打包Quick Start安装包，Quick Start只针对本地测试使用，所以一般用户不需要自己下载源码打包，只需要下载已经打好的包即可。不过也有部分用户希望在修改代码（如注册中心地址、端口等）后重新打包，那么可以参考如下步骤：

（1）修改apollo-configservice、apollo-adminservice和apollo-portal的pom.xml，注释掉spring-boot-maven-plugin和maven-assembly-plugin
（2）在根目录下执行mvn clean package -pl apollo-assembly -am -DskipTests=true
（3）复制apollo-assembly/target下的jar包，rename为apollo-all-in-one.jar

如需更改注册中心地址及端口，则需修改文件：

• apollo-admin端口：E:\Apollo配置中心\apollo\apollo-adminservice\src\main\resources\application.yml
• apollo-admin端口：E:\Apollo配置中心\apollo\apollo-adminservice\src\main\resources\adminservice.properties
• apollo-admin注册中心：E:\Apollo配置中心\apollo\apollo-adminservice\src\main\resources\bootstrap.yml
• apollo-config端口：E:\Apollo配置中心\apollo\apollo-configservice\src\main\resources\application.yml
• apollo-config端口：E:\Apollo配置中心\apollo\apollo-configservice\src\main\resources\configservice.properties
• apollo-config注册中心：E:\Apollo配置中心\apollo\apollo-configservice\src\main\resources\bootstrap.yml
• apollo-portal端口：E:\Apollo配置中心\apollo\apollo-portal\src\main\resources\application.yml
• apollo-portal配置：E:\Apollo配置中心\apollo\apollo-portal\src\main\resources\apollo-env.properties

官方releases包

从https://github.com/ctripcorp/apollo/releases页面下载最新版本的apollo-configservice-x.x.x-github.zip、apollo-adminservice-x.x.x-github.zip和apollo-portal-x.x.x-github.zip依赖包。

源码构建

从https://github.com/ctripcorp/apollo下载源码后在本地构建。构建步骤为:

（1）使用scripts文件夹下的build.bat或build.sh构建
（2）分别拷贝出apollo-adminservice、apollo-configservice和apollo-portal3个文件夹下target/apollo-xxx-x.x.x-github.zip文件

创建数据库

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

从https://github.com/nobodyiam/apollo-build-scripts/tree/master/sql下载apolloconfigdb.sql和apolloportaldb.sql数据库文件。

使用apolloportaldb.sql文件创建apolloportaldb数据库，此数据库是我们管理各种环境等的通用数据库。

source /your_local_path/sql/apolloportaldb.sql
select `Id`, `AppId`, `Name` from ApolloPortalDB.App;

使用apolloconfigdb.sql文件分别创建apolloconfigdb_dev和apolloconfigdb_fat数据库作为我们两个环境的数据存储。

source /your_local_path/sql/apolloconfigdb.sql
select `NamespaceId`, `Key`, `Value`, `Comment` from ApolloConfigDB.Item;

配置数据库连接信息

修改ApolloPortalDB和ApolloConfigDB相关的数据库连接串信息。

vim demo.sh

# apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8
apollo_config_db_username=apollo
apollo_config_db_password=jb6Pullq8rWZ3T5M

# apollo portal db info
apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8
apollo_portal_db_username=apollo
apollo_portal_db_password=jb6Pullq8rWZ3T5M

Apollo配置中心

确保端口未被占用

Quick Start脚本会在本地启动3个服务，分别使用8070(apollo-portal)、8080(apollo-configservice)、8090(apollo-adminservice)端口，确保这3个端口当前没有被使用。

在Linux/Mac下，可以通过如下命令检查：

lsof -i:8080

启动服务

修改注册中心地址及端口：

# vim demo.sh

# meta server url
config_server_url=http://localhost:8980
admin_server_url=http://localhost:8990
eureka_service_url=http://192.168.165.241:9999/eureka/
portal_url=http://localhost:8970

...

echo "==== starting portal ===="
echo "Portal logging file is $PORTAL_LOG"
export JAVA_OPTS="$PORTAL_JAVA_OPTS -Dlogging.file=./apollo-portal.log -Dserver.port=8970 -Dspring.datasource.url=$apollo_portal_db_url -Dspring.datasource.username=$apollo_portal_db_username -Dspring.datasource.password=$apollo_portal_db_password"

执行启动脚本：

# ./demo.sh start

当看到如下输出，说明启动成功！

$ ./demo.sh start
==== starting service ====
Service logging file is ./service/apollo-service.log
Started [62461]
Waiting for config service startup......
Config service started. You may visit http://localhost:8980 for service status now!
Waiting for admin service startup..
Admin service started
==== starting portal ====
Portal logging file is ./portal/apollo-portal.log
Started [62657]
Waiting for portal startup......
Portal started. You can visit http://localhost:8970 now!

访问Apollo配置中心：http://localhost:8070

• 用户名: apollo
• 密码: admin

常见问题

若遇到 admin 和 config 均已启动，但portal无法起来，而且portal下面也没日志文件，8070端口也没起来，解决办法：https://github.com/nobodyiam/apollo-build-scripts/issues/23

./demo.sh start 后 spring 日志打印在了控制台; 发现是因为 service/apollo-service.conf 文件格式是 dos (因为自己先 clone 到了 windows 机再放到 lunix 的)，将其转为 unix 格式后就可以了，portal 的类似问题查看 portal\apollo-portal.conf