Apollo部署及简单使用

分布式部署请参照开源文档：

    https://github.com/ctripcorp/apollo/wiki  

   https://github.com/ctripcorp/apollo/wiki/%E5%88%86%E5%B8%83%E5%BC%8F%E9%83%A8%E7%BD%B2%E6%8C%87%E5%8D%97

 

1、Apollo简介

Apollo（阿波罗）是携程框架部门研发的开源配置管理中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性。

Apollo支持4个维度管理Key-Value格式的配置：

1. application (应用)
2. environment (环境)
3. cluster (集群)
4. namespace (命名空间)

同时，Apollo基于开源模式开发，开源地址：https://github.com/ctripcorp/apollo

 

2、安装部署指南

Apollo 的官方文档写得非常友好全面，官方地址：https://github.com/ctripcorp/apollo/wiki

这里只是记录一下我在服务器上搭建的过程，我的服务器版本是：Linux version 2.6.32-573.el6.x86_64 ([email protected]) (gcc version 4.4.7 20120313 (Red Hat 4.4.7-16) (GCC) ) #1 SMP Thu Jul 23 15:44:03 UTC 2015。

下载源码到服务器上：

  安装git  (已安装可以忽略)

  yum install git   

  git clone https://github.com/ctripcorp/apollo.git   

注：初次编译会从Maven中央仓库下载不少依赖，如果网络情况不佳时很容易出错，建议使用国内的Maven仓库源，比如阿里云Maven镜像

1 环境要求

• Java： 1.8+
  • 检查：java -version
• MySql：5.6.5+
  • 检查：SHOW VARIABLES WHERE Variable_name = 'version'

2 部署步骤

通过各种MySQL客户端导入sql/apolloportaldb.sql即可。

官方提供的数据库脚本有两个，在scripts/sql下，apolloportaldb.sql和apolloconfigdb.sql

现在按照原始mysql导入

// 创建：ApolloPortalDB
source /your_local_path/sql/apolloportaldb.sql
// 创建：ApolloConfigDB
source /your_local_path/sql/apolloconfigdb.sql
// 检查是否导入成功：
select `Id`, `Key`, `Value`, `Comment` from `ApolloPortalDB`.`ServerConfig` limit 1;
select `Id`, `Key`, `Value`, `Comment` from `ApolloConfigDB`.`ServerConfig` limit 1;

3 Apollo自身的一些配置

配置ApolloPortalDB.ServerConfig

• • 1.apollo.portal.envs – 可支持的环境列表:

默认值是dev，多个以逗号分隔即可（大小写不敏感），如：

DEV,FAT,UAT,PRO

注意：只在数据库添加环境是不起作用的，需要配合修改scripts/build.sh，添加新增环境对应的meta server地址。

• organizations – 部门列表:

[{"orgId":"TEST1","orgName":"样例部门1"},{"orgId":"TEST2","orgName":"样例部门2"}]

• • wiki.address: portal上“帮助”链接的地址，默认是Apollo github的wiki首页。

####2.2.2 配置ApolloConfigDB.ServerConfig

• 1.eureka.service.url – Eureka服务Url，如有多个，用逗号分隔（注意不要忘了/eureka/后缀）：

http://1.1.1.1:8080/eureka/,http://2.2.2.2:8080/eureka/

4 配置数据库连接信息

• vim scripts/build.sh

#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=密码（如果没有密码，留空即可）

5 配置各环境meta service地址

• vim scripts/build.sh：修改各环境meta service服务地址。 如果某个环境不需要，也可以直接删除对应的配置项

dev_meta=http://localhost:8080
fat_meta=http://localhost:8080
uat_meta=http://localhost:8080
pro_meta=http://localhost:8080

6 执行编译打包

./build.sh

7 部署运行

7.1 部署apollo-configservice

将apollo-configservice/target/目录下的apollo-configservice-x.x.x-github.zip上传到服务器上，解压后执行scripts/startup.sh即可。如需停止服务，执行scripts/shutdown.sh.

cd apollo-configservice/target/
scp apollo-configservice-x.x.x-github.zip 209:/opt/apollo/config
ssh 209
cd /opt/apollo/config
unzip apollo-configservice-x.x.x-github.zip
运行：./scripts/startup.sh
停止：./scripts/shutdown.sh

注：如要调整服务的监听端口，可以修改startup.sh中的SERVER_PORT。另外apollo-configservice同时承担meta server职责，如果要修改端口，注意要同时修改scripts/build.sh中的meta server url信息以及ApolloConfigDB.ServerConfig表中的eureka.service.url配置项。

7.2 部署apollo-adminservice

同上：

将apollo-adminservice/target/目录下的apollo-adminservice-x.x.x-github.zip上传到服务器上，解压后执行scripts/startup.sh即可。如需停止服务，执行scripts/shutdown.sh.

注：如要调整服务的监听端口，可以修改startup.sh中的SERVER_PORT。

7.3 部署apollo-portal

同上：

将apollo-portal/target/目录下的apollo-portal-x.x.x-github.zip上传到服务器上，解压后执行scripts/startup.sh即可。如需停止服务，执行scripts/shutdown.sh.

apollo-portal的默认端口是8080，和apollo-configservice一致，所以如果需要在一台机器上同时启动apollo-portal和apollo-configservice的话，需要修改apollo-portal的端口。直接修改startup.sh中的SERVER_PORT即可，如SERVER_PORT=8070。

3、Java客户端使用

3.1 配置Appid

classpath:/META-INF/app.properties文件：

app.id=YOUR-APP-ID

3.2 配置Environment

• • 对于Mac/Linux，文件位置为/opt/settings/server.properties
  • 对于Windows，文件位置为C:\opt\settings\server.properties

保证settings目录文件权限：chmod 777 /opt/settings

文件内容形如：

env=DEV

3.3 配置本地缓存路径

本地缓存路径位于以下路径，所以请确保/opt/data或C:\opt\data\目录存在，且应用有读写权限。

• • Mac/Linux: /opt/data/{appId}/config-cache
  • Windows: C:\opt\data{appId}\config-cache

保证data目录文件权限：chmod 777 /opt/data

3.4 配置日志地址

保证logs目录文件权限：chmod 777 /opt/logs

3.5 Maven Dependency

        com.ctrip.framework.apollo
        apollo-client
        0.10.0
 

3.6 使用

@Configuration
@EnableApolloConfig
public class AppConfig {
  
}

@ApolloConfig
private Config config;

@Test
public void testApollo(){
	String name = config.getProperty("name", "hello");
    assertEquals(name,"Acheron");
}