apollo携程框架搭建部署细节

Apollo框架的使用和简单介绍

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

github地址：

https://github.com/ctripcorp/apollo

本地快速部署Quick Start，只适合效果预演，无法根据项目需求更改配置，详细了解分布式配置

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

Apollo配置中心介绍

https://github.com/ctripcorp/apollo/wiki/Apollo%E9%85%8D%E7%BD%AE%E4%B8%AD%E5%BF%83%E4%BB%8B%E7%BB%8D

部署安装请搜索关键字：Apollo分布式配置中心部署以及使用

1. 使用：

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

比较重要的几个项目：

• apollo-configservice：提供配置获取接口，提供配置更新推送接口，接口服务对象为Apollo客户端

• apollo-adminservice：提供配置管理接口，提供配置修改、发布等接口，接口服务对象为Portal，以及Eureka

• apollo-portal：提供Web界面供用户管理配置

• apollo-client：Apollo提供的客户端程序，为应用提供配置获取、实时更新等功能

##2. 数据库初始化（!mysql要在5.6以上，定位问题在于TimeStamp在5.6以下唯一）

下面的sql为大写格式，注意数据库的大小写敏感设置

ApolloPortalDB：执行apollo\scripts\sql\apolloportaldb.sql

ApolloConfigDB：DEV FAT UAT PRO 环境执行apollo\scripts\sql\apolloconfigdb.sql

要在apollo-configservice，apollo-adminservice，apollo-portal中的application.yml中配置数据库信息：

# apollo-configservice，apollo-adminservice

spring:

datasource:

url: jdbc:mysql://localhost:3306/ApolloConfigDBcharacterEncoding=utf8

username:

password:

driver-class-name: com.mysql.jdbc.Driver

# apollo-portal

spring:

datasource:

url: jdbc:mysql://localhost:3306/ApolloPortalDBcharacterEncoding=utf8

username:

password:

driver-class-name: com.mysql.jdbc.Driver

3. 修改环境调用地址

# meta server url, different environments should have different meta server addresses

dev_meta=http://localhost:8080

fat_meta=http://192.168.35.208:9100

uat_meta=http://192.168.35.209:9100

pro_meta=http://192.168.35.210:9100

4. 修改数据库数据

在DEV FAT UAT PRO 对应的ApolloConfigDB数据库中,找到表ServerConfig中的eureka.service.url配置项：

UPDATE apolloconfigdb.ServerConfig SET ServerConfig.`Value`='http://localhost:9100/eureka/' WHERE `Key`='eureka.service.url';

现在已经可以运行项目了,若缺失jar可一一补齐

---

如需部署在服务器

可进入scripts/下运行build.bat或./build.sh

该脚本会依次打包apollo-configservice, apollo-adminservice, apollo-portal和apollo-client。

由于ApolloConfigDB在每个环境都有部署，所以对不同环境的config-service和admin-service需要使用不同的数据库连接信息打不同的包，portal和client只需要打一次包即可

将压缩包上传至服务器解压

修改scripts/startup.sh ：

LOG_DIR=/opt/logs/100003171 //日志路径

SERVER_PORT=9100 //服务端口

执行scripts/startup.sh即可

如需停止服务，执行scripts/shutdown.sh.

登录，默认用户名密码为：apollo/admin

5. 踩坑细节：

1. core和client要打包成jar放到项目中

2. 先开configservice，然后adminservice，最后portal

3. configservice和adminservice打包上传服务器时，一个环境对应一份

4. 修改configserver表里的eureka，把注册中心定向到内网中的eureka

UPDATE apolloconfigdb.ServerConfig SET ServerConfig.Value=‘http://localhost:9100/eureka/’ WHERE Key=‘eureka.service.url’;

5. 在yml配置文件中写上app.id=xxxxxx，此处为字符串，要和apollo配置中心对应项目的appID相同

然后写上apoll.meta=http://localhost:8080 定向到Configserver服务

---

6. 整合项目时

6.1. 将core和client的依赖引入pom，在程序启动类上加上注解@EnableApolloConfig，创建一个配置类加上注解@component，在给静态变量赋值的set方法上加上

@value("${xxx})，将变量申明为pubilc，之后可使用 配置类.静态变量直接访问,详细看例子

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">

    <dependencies>

    

        <dependency>

            <groupId>com.ctrip.framework.apollogroupId>

            <artifactId>apollo-clientartifactId>

            <version>1.5.0-SNAPSHOTversion>

        dependency>

        <dependency>

            <groupId>com.ctrip.framework.apollogroupId>

            <artifactId>apollo-coreartifactId>

            <version>1.5.0-SNAPSHOTversion>

        dependency>

    dependencies>

project>

// @Component注解表明一个类会作为组件类，并告知Spring要为这个类创建bean。

// @Bean注解告诉Spring这个方法将会返回一个对象，这个对象要注册为Spring应用上下文中的bean。通常方法体中包含了最终产生bean实例的逻辑。

@Component

public class Config {

    @Value("${server.port}")

    public void setPort(String port) {

        Config.port = port;

    }

    @Value("${spring.application.name:apollo}")

    public void setName(String name) {

        Config.name = name;

    }

    public static String port;

    public static String name;

}

public class a{

    //要使用Config配置类的属性可以采用

    System.out.println(Config.port+","+Config.name);

}

6.2 将程序注册到内网的服务中心，添加pom依赖，如下，在启动类上添加@EnableEurekaClient,yml添加eureka的配置

//Eureka相关

      <dependency>

            <groupId>org.springframework.cloudgroupId>

            <artifactId>spring-cloud-starter-netflix-eureka- serverartifactId>

      dependency>

eureka:

  client:

  serviceUrl:

defaultZone: http://localhost:8080/Eureka

    register-with-eureka: false

    fetch-registry: false

---

7. 部署到服务器上，修改各自解压包下的config/application-github.properties,配置数据库

8. 执行各自解压包下的scripts/startup.sh运行服务，对应的shutdown.sh为关闭服务

9. 现在部署情况是虚拟机部署服务，链接服务器的数据库，开放端口给本机上web

9.1 过程中防火墙需要开放端口，三个需要在同一网段，虚拟机使用桥接模式

9.2 vi etc/sysconfig/network-scripts/ifcfg-enp0s3 具体路径要仔细看

9.3 执行服务指令 ./config/scripts/startup.sh

./admin/scripts/startup.sh

./protal/scripts/startup.sh

10. 上传到服务器时，注意配置信息（数据库配置，端口号配置，日志文件位置配置），端口号写死在startup.sh脚本里，注意修改portal里的dev.meta的环境为你的configservice的ip:端口号

参考文档：

Apollo分布式配置中心部署以及使用

apollo配置中心部署到使用的心得总结