Apollo框架的使用和简单介绍
Apollo(阿波罗)是携程框架部门研发的分布式配置中心,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性,适用于微服务配置管理场景
github地址:
https://github.com/ctripcorp/apollo
本地快速部署Quick Start,只适合效果预演,无法根据项目需求更改配置,详细了解分布式配置
Apollo配置中心介绍
部署安装请搜索关键字: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. 踩坑细节:
core和client要打包成jar放到项目中
先开configservice,然后adminservice,最后portal
configservice和adminservice打包上传服务器时,一个环境对应一份
修改configserver表里的eureka,把注册中心定向到内网中的eureka
UPDATE apolloconfigdb.ServerConfig SET ServerConfig.Value
='http://localhost:9100/eureka/' WHERE Key
='eureka.service.url';
- 在yml配置文件中写上app.id=xxxxxx,此处为字符串,要和apollo配置中心对应项目的appID相同
然后写上apoll.meta=http://localhost:8080 定向到Configserver服务
- 整合项目时
6.1. 将core和client的依赖引入pom,在程序启动类上加上注解@EnableApolloConfig,创建一个配置类加上注解@component,在给静态变量赋值的set方法上加上
@value("${xxx}),将变量申明为pubilc,之后可使用 配置类.静态变量直接访问,详细看例子
<?xml version="1.0" encoding="UTF-8"?>
<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>
<!--Apollo相关-->
<dependency>
<groupId>com.ctrip.framework.apollo</groupId>
<artifactId>apollo-client</artifactId>
<version>1.5.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.ctrip.framework.apollo</groupId>
<artifactId>apollo-core</artifactId>
<version>1.5.0-SNAPSHOT</version>
</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.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka- server</artifactId>
</dependency>
eureka:
client:
serviceUrl:
defaultZone: http://localhost:8080/Eureka
register-with-eureka: false
fetch-registry: false
部署到服务器上,修改各自解压包下的config/application-github.properties,配置数据库
执行各自解压包下的scripts/startup.sh运行服务,对应的shutdown.sh为关闭服务
现在部署情况是虚拟机部署服务,链接服务器的数据库,开放端口给本机上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
- 上传到服务器时,注意配置信息(数据库配置,端口号配置,日志文件位置配置),端口号写死在startup.sh脚本里,注意修改portal里的dev.meta的环境为你的configservice的ip:端口号
参考文档: