Spring Cloud 学习笔记八：搭建微服务工程之Apollo 本地部署

目录

Apollo 本地部署

环境准备

下载快速启动安装包

初始化数据库

修改数据库连接信息

启动 Apollo 配置中心

---

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（它自己）注册服务，但是因为在启动过程中，自己还没起来，所以会报这个错。后面会进行重试的动作，所以等自己服务起来后就会注册正常了。