为了让大家更快的上手了解Apollo配置中心，我们这里准备了一个Quick Start，能够在几分钟内在本地环境部署、启动Apollo配置中心。
不过这里需要注意的是，Quick Start只针对本地测试使用，如果要部署到生产环境，还请另行参考分布式部署指南。
- Apollo服务端：1.8+
- Apollo客户端：1.7+
由于Quick Start会在本地同时启动服务端和客户端，所以需要在本地安装Java 1.8+。
在配置好后，可以通过如下命令检查：
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)
- 版本要求：5.6.5+
Apollo的表结构使用了多个on update语句，所以需要5.6.5以上版本。
连接上MySQL后，可以通过如下命令检查：
SHOW VARIABLES WHERE Variable_name = 'version';
| Variable_name | Value |
|---|---|
| version | 5.7.11 |
我们准备好了一个Quick Start安装包，大家只需要下载到本地，就可以直接使用，免去了编译、打包过程。
安装包共64M，如果访问github网速不给力的话，可以从百度网盘下载。
- 从Github下载
- checkout或下载apollo-build-scripts项目
- 从百度网盘下载
- 通过网盘链接下载
- 下载到本地后，在本地解压apollo-build-scripts.zip
- 为啥安装包要64M这么大？
- 因为这是一个可以自启动的jar包，里面包含了所有依赖jar包以及一个内置的tomcat容器
Apollo服务端共需要两个数据库：ApolloPortalDB和ApolloConfigDB，我们把数据库、表的创建和样例数据都分别准备了sql文件，只需要导入数据库即可。
注意：如果你本地已经创建过Apollo数据库，请注意备份数据。我们准备的sql文件会清空Apollo相关的表。
通过各种MySQL客户端导入sql/apolloportaldb.sql即可。
下面以MySQL原生客户端为例：
source /your_local_path/sql/apolloportaldb.sql
导入成功后，可以通过执行以下sql语句来验证：
select Id, AppId, Name from ApolloPortalDB.App;
| Id | AppId | Name |
|---|---|---|
| 1 | SampleApp | Sample App |
通过各种MySQL客户端导入sql/apolloconfigdb.sql即可。
下面以MySQL原生客户端为例：
source /your_local_path/sql/apolloconfigdb.sql
导入成功后，可以通过执行以下sql语句来验证：
select `NamespaceId`, `Key`, `Value`, `Comment` from ApolloConfigDB.Item;
| NamespaceId | Key | Value | Comment |
|---|---|---|---|
| 1 | timeout | 100 | sample timeout配置 |
Apollo服务端需要知道如何连接到你前面创建的数据库，所以需要编辑build.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=密码（如果没有密码，留空即可）
注意：不要修改build.sh的其它部分
Quick Start脚本会在本地启动3个服务，分别使用8070, 8080, 8090端口，请确保这3个端口当前没有被使用。
例如，在Linux/Mac下，可以通过如下命令检查：
lsof -i:8080
./build.sh start
当看到如下输出后，就说明启动成功了！
==== starting service ====
Started [14309]
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 ====
Started [14370]
Waiting for portal startup.......
Portal started. You can visit http://localhost:8070 now!
如果启动遇到了异常，可以分别查看service和portal目录下的log文件排查问题。
-
点击SampleApp进入配置界面，可以看到当前有一个配置timeout=100
我们准备了一个简单的Demo客户端来演示从Apollo配置中心获取配置。
程序很简单，就是用户输入一个key的名字，程序会输出这个key对应的值。
如果没找到这个key，则输出undefined。
同时，客户端还会监听配置变化事件，一旦有变化就会输出变化的配置信息。
运行./build.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
-
在配置界面点击timeout这一项的编辑按钮
-
在弹出框中把值改成200并提交
-
点击发布按钮，并填写发布信息
如果客户端一直在运行的话，在配置发布后就会监听到配置变化，并输出修改的配置信息：
[SimpleApolloConfigDemo] Changes for namespace application
[SimpleApolloConfigDemo] Change - key: timeout, oldValue: 100, newValue: 200, changeType: MODIFIED
再次输入timeout查看对应的值，会看到如下信息：
> timeout
> [SimpleApolloConfigDemo] Loading key : timeout with value: 200
这部分可以参考普通应用接入指南
由于使用了新的项目，所以客户端需要修改appId信息。
编辑client/META-INF/app.properties，修改app.id为你新创建的app id。
app.id=你的appId
运行./build.sh client启动Demo客户端即可。
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent