目录
SpringCloud 集成 Apollo 步骤
参考一些文档,我在window环境搭建了一个Apollo分布式配置中心平台,详细步骤记录一下。
1.Apollo Server 配置
1.1.搭建 Server 环境
1)下载Apollo源码:地址:https://github.com/ctripcorp/apollo
2)初始化数据库
源代码项目如下,我们需要在本地mysql数据库中 运行项目源码中\scripts\db\migration\configdb和\scripts\db\migration\portaldb下的sql脚本,会生成两个数据库:ApolloConfigDB和ApolloPortalDB,用于存储一些配置信息。
本地生成的数据库:ApolloConfigDB和ApolloPortalDB
注意:我们查看源码可知,adminservice项目占用了8090端口号,configservice占用了8080端口号,portal占用了8070端口号,所以8070、8080、8090这三个端口号不要被本地占用,启动Apollo项目时会占用这三个端口号,当然可以修改Apollo默认的端口号。
3)源码项目中有很多模块,我们只需要 apollo-adminservice,appllo-configservice, apollo-portal 这三个模块的jar包, 有两种方式可以获取:
方式一:直接在源码项目中修改apollo-configservice,apollo-adminservice,apollo-portal项目中的数据库连接地址(修改成本地的数据库地址,apollo-configservice 和 apollo-adminservice 对应的数据库是 apolloconfigdb,apollo-portal对应的数据库是 apolloportaldb),然后使用其提供的脚本打包。
方式二:我们也可以直接下载打包好的文件,下载地址:https://github.com/ctripcorp/apollo/releases
我使用的是第二种方式,比较简单。下载完之后,解压,分别修改每个目录文件夹中config文件夹下的application-github.properties的数据库连接地址(修改成本地数据库地址):
4)修改环境配置,在Apollo中,支持LOCAL, DEV, FWS, FAT, UAT, LPT, PRO, TOOLS多环境,默认使用的DEV环境,所以,我们将 \apollo-portal\config 下的 apollo-env.properties 文件的 local.meta 和 dev.meta 都修改为本地eureka环境,从数据库可以看出默认eureka端口号8080。
修改成本地eureka地址:
注意!注意!
1)数据库的地址是 http://localhost:8080/eureka,配置文件中一定不能加上 /eureka,要不然登录控制台的时候会找不到对应的dev环境的eureka地址
2)其余环境的配置,根据自己的需求配置
从数据库可以看出本地eureka默认端口号8080。
我们可以查看数据库,默认的环境文件应该是这个:
5)启动configservice、adminservice 和 portal 项目,执行对应script下的startup.sh脚本即可。
如何在window环境下启动shell脚本:首先需要在本地安装git,然后在startup.sh目录中,右键打开 Git Bash Here,然后在命令行输入 sh startup.sh 命令,则可以运行shell脚本,启动portal项目。一一启动 configservice、adminservice 和 portal 三个项目。
当然,需要在不同文件夹下执行三个shell脚本,我觉得比较麻烦,那就在一个shell脚本里执行这三个shell脚本。我创建一个新的startup.sh 脚本,只需要执行这一个脚本就可以执行刚才的三个脚本了。
#!/bin/bash
sh apollo-portal-1.5.1-github/scripts/startup.sh
sh apollo-configservice-1.5.1-github/scripts/startup.sh
sh apollo-adminservice-1.5.1-github/scripts/startup.sh
执行 sh start.sh 命令,启动了三个项目:
我们还需要创建一个shutdown.sh脚本,关闭三个项目;
#!/bin/bash
sh apollo-portal-1.5.1-github/scripts/shutdown.sh
sh apollo-configservice-1.5.1-github/scripts/shutdown.sh
sh apollo-adminservice-1.5.1-github/scripts/shutdown.sh
需要注意的:
1.本地mysql必须启动,否则启动Apollo会报错,因为Apollo会从本地数据库读取一些配置信息。
2.关掉黑窗口,不一定关闭了项目,需要执行 shutdown.sh 脚本才可以关闭项目。
6)Apollo使用Eureka注册服务,启动成功后,会自动注册到eureka中。
我们可以查看Eureka服务状况,访问eureka地址:http://localhost:8080,如果需要修改,可在数据库中自行修改.
1.2.在 Apollo 创建应用项目
1)浏览器输入:http://localhost:8070 ,Apollo的管理页面,使用用户apollo,密码admin登录
数据库有默认的super账号和密码:账号 apollo,密码 admin(数据库加密了)
2)登录:
3)查看默认dev环境信息:
注:如果之前配置文件中加了 /eureka,那么此处无法显示正常的信息,会报错说无法找到对应的eureka。
4)在这个地方可以更改默认的环境配置信息:
5)创建一个项目
6)项目创建成功
7)查看项目信息:
注:项目默认的 namespace 是 application
8)新增一个配置项:
9)发布配置项:
10)发布成功:
2.Apollo Client 配置
需求:我们需要搭建一个客户端,调用apollo服务端的信息
1)创建项目 cloud-apollo-config-client
2)pom文件
<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.itmayiedu</groupId> <artifactId>cloud-apollo-config-client</artifactId> <version>1.0-SNAPSHOT</version> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.0.1.RELEASE</version> </parent> <!-- 管理依赖 --> <dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-dependencies</artifactId> <version>Finchley.M7</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <!-- apollo 分布式配置中心客户端--> <dependency> <groupId>com.ctrip.framework.apollo</groupId> <artifactId>apollo-client</artifactId> <version>1.0.0</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> <!-- 注意: 这里必须要添加, 否者各种依赖有问题 --> <repositories> <repository> <id>spring-milestones</id> <name>Spring Milestones</name> <url>https://repo.spring.io/libs-milestone</url> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> </project>
3)application.yml文件
# 服务名称
spring:
application:
name: cloud-apollo-config-client
# 服务端口号
server:
port: 8888
### apollo 服务的eureka地址
apollo:
meta: http://localhost:8080/eureka/
#注入默认命名空(namespace) application的配置
bootstrap:
enabled: true
### apollo 服务的应用id(app.id是用来标识应用身份的唯一id)
app:
id: 123456
4)Controller
package com.itamyeidu.controller;
import com.ctrip.framework.apollo.spring.annotation.EnableApolloConfig;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@EnableApolloConfig
public class ConfigController {
@Value("${test_info}")
private String test_info;
@RequestMapping("getConfig")
public String getConfig(){
return test_info;
}
}
@EnableApolloConfig:开启Apollo的注解
5)启动类
package com.itamyeidu;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
6)启动项目,访问浏览器
7)客户端项目并没有注册到eureka中
我们可以把客户端项目注册到eureka中:
第一步:添加pom依赖
<!-- SpringBoot整合eureka客户端 --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> </dependency>
第二步:修改application.yml文件
###服务注册中心地址 eureka: client: serviceUrl: defaultZone: http://localhost:8080/eureka/
第三步:启动类添加注解 @EnableEurekaClient
第四步:重启项目,访问eureka浏览器
后文:服务端项目,和客户端项目,都保存到百度云盘中
链接:https://pan.baidu.com/s/13dejTVtdsSd7eYxxoYhkyQ 提取码:08pq
参考文档: