目录
Apollo 本地部署
为了让大家更快地上手了解 Apollo 配置中心,官方准备了一个快速启动的安装包,能够在几分钟内完成本地环境部署,启动 Apollo 配置中心。
本地部署只适用于开发环境,生产环境需要采用分布式部署,教程后面会为大家讲解怎么进行分布式部署。
环境准备
Apollo 采用 Java 语言开发,部署环境必须安装了 Java,版本要求:Java 1.8+。Apollo 的数据都存储的 Mysql 中,部署环境也需要安装 Mysql 数据库,版本要求:5.6.5+。
快速启动的脚本是 shell 编写的,要有 bash 环境,在 Linux/Mac 下无影响。如果用户是 Windows 环境,需要安装 Git Bash(https://gitforwindows.org/)。
下载快速启动安装包
快速启动安装包下载地址:https://github.com/nobodyiam/apollo-build-scripts。下载之后进行解压,目录结构如图所示:
初始化数据库
Apollo 服务端一共需要两个数据库:ApolloPortalDB 和 ApolloConfigDB。数据库、表的创建和样例数据的 sql 文件都在快速启动安装包的 sql 目录中,只需要导入数据库即可。
注意:如果你本地已经创建过Apollo数据库,请注意备份数据。sql文件会清空Apollo相关的表。
修改数据库连接信息
数据库连接信息在 demo.sh 中,我们需要把对应的数据库连接信息修改成我们自己安装的地址,这样 Apollo 才能正常启动。
注意:填入的用户需要具备对 ApolloPortalDB 和 ApolloConfigDB 数据的读写权限。
#apollo config db info
apollo_config_db_url="jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8&serverTimezone=Asia/Shanghai"
apollo_config_db_username=用户名
apollo_config_db_password=密码(如果没有密码,留空即可)
# apollo portal db info
apollo_portal_db_url="jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8&serverTimezone=Asia/Shanghai"
apollo_portal_db_username=用户名
apollo_portal_db_password=密码(如果没有密码,留空即可)
注意:不要修改 demo.sh 的其它部分。
启动 Apollo 配置中心
demo.sh 脚本会在本地启动 3 个服务,分别使用 8070、8080、8090 端口,请确保这 3 个端口当前没有被使用。
使用 Git Bash 执行启动脚本:
./demo.sh start
当看到如下输出后,就说明 Apollo 启动成功了。
==== 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!
如果启动遇到了异常,可以分别查看 service 和 portal 目录下的 log 文件排查问题。
在启动 apollo-configservice 的过程中会在日志中输出 eureka 注册失败的信息,如
com.sun.jersey.api.client.ClientHandlerException: java.net.ConnectException: Connection refused
。需要注意的是,这个是预期的情况,因为 apollo-configservice 需要向Meta Server(它自己)注册服务,但是因为在启动过程中,自己还没起来,所以会报这个错。后面会进行重试的动作,所以等自己服务起来后就会注册正常了。