Apollo 初探

Apollo 初探

一、环境准备
运行环境 Java1.8 、Apollo服务端：1.8+、Apollo客户端：1.7+、MySQL：5.6.5+

1、java环境检查

java -version

样例输出：

java version "1.8.0_74"
Java(TM) SE Runtime Environment (build 1.8.0_74-b02)
Java HotSpot(TM) 64-Bit Server VM (build 25.74-b02, mixed mode)
1.2 MySQL

2、mysql版本检查

连接上MySQL后，可以通过如下命令检查：

SHOW VARIABLES WHERE Variable_name = 'version';

Variable_name	Value
version	5.7.11

3、Apollo Quick Start安装包
访问 https://github.com/nobodyiam/apollo-build-scripts 下载到本地，就可以直接使用，免去了编译、打包过程。

内含一个可以自启动的jar包，里面包含了所有依赖jar包以及一个内置的tomcat容器

二、安装步骤
2.1 创建数据库
Apollo服务端共需要两个数据库：
ApolloPortalDB(https://github.com/nobodyiam/apollo-build-scripts/blob/master/sql/apolloportaldb.sql)
和
ApolloConfigDB（https://github.com/nobodyiam/apollo-build-scripts/blob/master/sql/apolloconfigdb.sql）
，将sql文件，只需要导入数据库即可。

2.2 配置数据库连接信息
Apollo服务端需要知道如何连接到你前面创建的数据库，所以需要编辑demo.sh，修改ApolloPortalDB和ApolloConfigDB相关的数据库连接串信息。

注意：填入的用户需要具备对ApolloPortalDB和ApolloConfigDB数据的读写权限。


#apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8
apollo_config_db_username=用户名
apollo_config_db_password=密码（如果没有密码，留空即可）

apollo portal db info

apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8
apollo_portal_db_username=用户名
apollo_portal_db_password=密码（如果没有密码，留空即可）
注意：不要修改demo.sh的其它部分

三、启动Apollo配置中心
3.1 确保端口未被占用
Quick Start脚本会在本地启动3个服务，分别使用8070, 8080, 8090端口，请确保这3个端口当前没有被使用。

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

lsof -i:8080
3.2 执行启动脚本
./demo.sh start
当看到如下输出后，就说明启动成功了！

==== 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!
3.3 异常排查
如果启动遇到了异常，可以分别查看service和portal目录下的log文件排查问题。

注：在启动apollo-configservice的过程中会在日志中输出eureka注册失败的信息，如com.sun.jersey.api.client.ClientHandlerException: java.net.ConnectException: Connection refused。需要注意的是，这个是预期的情况，因为apollo-configservice需要向Meta Server（它自己）注册服务，但是因为在启动过程中，自己还没起来，所以会报这个错。后面会进行重试的动作，所以等自己服务起来后就会注册正常了。

3.4 注意
Quick Start只是用来帮助大家快速体验Apollo项目，具体实际使用时请参考：分布式部署指南。

另外需要注意的是Quick Start不支持增加环境，只有通过分布式部署才可以新增环境，同样请参考：分布式部署指南

四、使用Apollo配置中心
4.1 使用样例项目
4.1.1 查看样例配置
打开http://localhost:8070
Quick Start集成了Spring Security简单认证，更多信息可以参考Portal 实现用户登录功能

登录
输入用户名apollo，密码admin后登录
首页

点击SampleApp进入配置界面，可以看到当前有一个配置timeout=100 配置界面
如果提示系统出错，请重试或联系系统负责人，请稍后几秒钟重试一下，因为通过Eureka注册的服务有一个刷新的延时。

4.1.2 运行客户端程序
我们准备了一个简单的Demo客户端来演示从Apollo配置中心获取配置。

程序很简单，就是用户输入一个key的名字，程序会输出这个key对应的值。

如果没找到这个key，则输出undefined。

同时，客户端还会监听配置变化事件，一旦有变化就会输出变化的配置信息。

运行./demo.sh client启动Demo客户端，忽略前面的调试信息，可以看到如下提示：

Apollo Config Demo. Please input key to get the value. Input quit to exit.

输入timeout，会看到如下信息：

timeout
[SimpleApolloConfigDemo] Loading key : timeout with value: 100
如果运行客户端遇到问题，可以通过修改client/log4j2.xml中的level为DEBUG来查看更详细日志信息

4.1.3 修改配置并发布 在配置界面点击timeout这一项的编辑按钮 编辑配置

在弹出框中把值改成200并提交 配置修改

点击发布按钮，并填写发布信息 发布

发布信息

4.1.4 客户端查看修改后的值
如果客户端一直在运行的话，在配置发布后就会监听到配置变化，并输出修改的配置信息：

[SimpleApolloConfigDemo] Changes for namespace application
[SimpleApolloConfigDemo] Change - key: timeout, oldValue: 100, newValue: 200, changeType: MODIFIED
再次输入timeout查看对应的值，会看到如下信息：

timeout
[SimpleApolloConfigDemo] Loading key : timeout with value: 200
4.2 使用新的项目
4.2.1 应用接入Apollo
这部分可以参考Java应用接入指南

4.2.2 运行客户端程序
由于使用了新的项目，所以客户端需要修改appId信息。

编辑client/META-INF/app.properties，修改app.id为你新创建的app id。

app.id=你的appId
运行./demo.sh client启动Demo客户端即可。

五、自定义java!

值得注意的是在启动类StewardApolloApplication 加上@EnableApolloConfig使apollo生效

六、启动完成
8070端口

8080端口

8090端口

七、使用



详情参考： https://github.com/ctripcorp/apollo/wiki/Quick-Start