一、准备工作

Apollo本地开发需要以下组件：

  1. Java: 1.8+
  2. MySQL: 5.6.5+
  3. IDE: 没有特殊要求

其中MySQL需要创建Apollo数据库并导入基础数据。 具体步骤请参考分布式部署指南中的以下部分：

  2. 2.1 创建数据库

1.2 Apollo总体设计

具体请参考Apollo配置中心设计

二、本地启动

2.1 Apollo Config Service和Apollo Admin Service

我们在本地开发时，一般会在IDE中同时启动和apollo-adminservice。

下面以Intellij Community 2016.2版本为例来说明如何在本地启动apollo-configservice和apollo-adminservice。

NewConfiguration-Application

2.1.2 Main class配置

com.ctrip.framework.apollo.assembly.ApolloApplication

2.1.3 VM options配置

注1：spring.datasource相关配置替换成你自己的数据库连接信息，注意数据库是ApolloConfigDB

注2：程序默认日志输出为/opt/logs/100003171/apollo-assembly.log，如果需要修改日志文件路径，可以增加logging.file.name参数，如下：

-Dlogging.file.name=/your-path/apollo-assembly.log

2.1.4 Program arguments配置

--configservice --adminservice

2.1.5 运行

对新建的运行配置点击Run或Debug皆可。

ConfigAdminApplication-Run

启动完后，打开可以看到apollo-configservice和apollo-adminservice都已经启动完成并注册到Eureka。

注：除了在Eureka确认服务状态外，还可以通过健康检查接口确认服务健康状况：

apollo-adminservice： http://localhost:8090/health apollo-configservice：

如果服务健康，返回内容中的status.code应当为UP：

  1. {
  2.   "status": {
  3.     ...
  4.   },
  5.   ...

下面以Intellij Community 2016.2版本为例来说明如何在本地启动apollo-portal。

PortalApplication-Overview

2.2.1 新建运行配置

2.2.3 VM options配置

PortalApplication-VM-Options

  1. -Dapollo_profile=github,auth
  2. -Ddev_meta=http://localhost:8080/
  3. -Dserver.port=8070
  4. -Dspring.datasource.url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8
  5. -Dspring.datasource.username=root
  6. -Dspring.datasource.password=

2.2.4 运行

对新建的运行配置点击Run或Debug皆可。

启动完后，打开就可以看到Apollo配置中心界面了。

PortalApplication-Home

注：如果启用了auth profile的话，默认的用户名是apollo，密码是admin

2.2.5 Demo应用接入

为了更好的开发和调试，一般我们都会自己创建一个demo项目给自己使用。

可以参考创建自己的demo项目。

2.3 Java样例客户端启动

项目中有一个样例客户端的项目：apollo-demo，下面以Intellij Community 2016.2版本为例来说明如何在本地启动。

2.3.1 配置项目AppId

在2.2.5 Demo应用接入中创建Demo项目时，系统会要求填入一个全局唯一的AppId，我们需要把这个AppId配置到apollo-demo项目的app.properties文件中：。

如我们自己的demo项目使用的AppId是100004458，那么文件内容就是：

注：AppId是应用的唯一身份标识，Apollo客户端使用这个标识来获取应用自己的私有Namespace配置。

对于公共Namespace的配置，没有AppId也可以获取到配置，但是就失去了应用覆盖公共Namespace配置的能力。

更多配置AppId的方式可以参考1.2.1 AppId

2.3.2 新建运行配置

NewConfiguration-Application

com.ctrip.framework.apollo.demo.api.SimpleApolloConfigDemo

2.3.4 VM options配置

  1. -Dapollo.meta=http://localhost:8080

2.3.5 概览

apollo-demo-overview

2.3.6 运行

对新建的运行配置点击Run或Debug皆可。

启动完后，忽略前面的调试信息，可以看到如下提示：

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

输入你之前在Portal上配置的值，如我们的Demo项目中配置了timeout，会看到如下信息：

客户端日志级别默认是DEBUG，如果需要调整，可以通过修改apollo-demo/src/main/resources/log4j2.xml中的level配置

  1. <logger name="com.ctrip.framework.apollo" additivity="false" level="trace">
  2.     <AppenderRef ref="Async" level="DEBUG"/>
  3. </logger>

2.4 .Net样例客户端启动

apollo.net项目中有一个样例客户端的项目：ApolloDemo，下面就以VS 2010为例来说明如何在本地启动。

2.4.1 配置项目AppId

在2.2.5 Demo应用接入中创建Demo项目时，系统会要求填入一个全局唯一的AppId，我们需要把这个AppId配置到ApolloDemo项目的APP.config文件中：apollo.net\ApolloDemo\App.config。

apollo-demo-app-config

如我们自己的demo项目使用的AppId是100004458，那么文件内容就是：

  1. <add key="AppID" value="100004458"/>

注：AppId是应用的唯一身份标识，Apollo客户端使用这个标识来获取应用自己的私有Namespace配置。

对于公共Namespace的配置，没有AppId也可以获取到配置，但是就失去了应用覆盖公共Namespace配置的能力。

2.4.2 配置服务地址

Apollo客户端针对不同的环境会从不同的服务器获取配置，所以我们需要在app.config或web.config配置服务器地址(Apollo.{ENV}.Meta)。假设DEV环境的配置服务(apollo-configservice)地址是11.22.33.44，那么我们就做如下配置：

运行ApolloConfigDemo.cs即可。

启动完后，忽略前面的调试信息，可以看到如下提示：

输入你之前在Portal上配置的值，如我们的Demo项目中配置了timeout，会看到如下信息：

  1. > timeout

三、开发

模块依赖图

3.1 Portal 实现用户登录功能

请参考

3.2 Portal 接入邮件服务

请参考

请参考Portal 共享 session