1. 搭建 Eureka Server
1. Eureka介绍
Eureka 是由 Java 语言开发的,在Spring Cloud中使用 spring Boot 技术对 Eureka 进行了封装。所以项目引入Eureka 对应的 starter 包(spring-cloud-starter-netflix-eureka-server),就使得项目具有了注册中心的功能。
2. 添加依赖
1. 添加项目的 parent 依赖
2. 添加 Spring Cloud 的依赖信息:
properties中定义了常用的变量,例如默认的JDK版本1.8,springCloud的版本Greenwich.SR1。
dependencyManagement 设置项目使用的 spring Cloud 版本,此处使用Greenwich.SR1。
3. 添加 Eureka 依赖包
添加 Eureka server 依赖包,在pom中添加 jar包依赖:
注意
如果 JDK 使用的是版本 9 以上,运行项目就会出现 java.lang.TypeNotPresentException: Type javax.xml.bind/JAXBContext not present 异常,这是因为 JAXB-API是 Java EE 的一部分,在 JDK 9版本以上,没有在默认的类路径中,需要手动引入 JAXB 依赖包。
3. 启动类
在启动类中添加注解,开启 Eureka Server 功能:添加 @EnableEurekaServer 注解,开启注册中心服务发现功能。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;
@SpringBootApplication
@EnableEurekaServer //开启注册中心服务发现的功能
public class EurekaCenterApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaCenterApplication.class, args);
System.out.println("----- Eureka server register center start success! -----http://localhost:8081/");
}
}
4. 配置文件
添加 Eureka 的基础配置文件,如下:
#注册中心服务端口号(项目启动的端口)
server.port=8091
#项目名称
spring.application.name=eureka-server
#配置注册中心
eureka.instance.hostname=eureka-a
#表示是否将自己注册到 Eureka server,默认为true,注册中心项目改为false
eureka.client.register-with-eureka=false
#表示是否从 Eureka server 获取注册信息,默认为true,注册中心项目改为false
eureka.client.fetch-registry=false #标志此服务是否要去注册中心,获取服务列表信息,false(注册中心是提供服务列表的)
eureka.client.service-url.defaultZone= http://localhost:8091/eureka
5. 测试
此时 Eureka 服务已经搭建好了,在启动类上 run 启动项目。等待启动完成后,在浏览器上访问:http://localhost:8091/,就可以看到Eureka注册中心的可视化界面。
此时,可以发现后台页面被分为了五块:
1. System Status:主要展示系统状态,比如启动时间等。
2. DS Replicas:该服务从哪里同步数据。
3. Instance currently registered with Eureka:注册在Eureka的实例里列表。
4. General Info:系统运行环境,比如内存、CPU等。
5. Instance Info:本服务的基础信息,比如IP地址、状态等。
6. 搭建 Eureka 集群
开启 Eureka 集群配置后,服务启动时 Eureka Server 会将注册信息 向其他 Eureka Server 进行同步,因此搭建高可用架构只需要将 Eureka Server 配置指向其他可用的 serviceUrl 即可。
在上面的 Eureka 单个实例的基础上,复制三份来分别命名为:eureka-a、eureka-b、eureka-c三个示例项目,可以使用这三个示例项目,使用这三个示例项目搭建 Eureka Server 集群。
接下来分别修改 eureka-a、eureka-b、eureka-c 的配置信息。
1. eureka-a 的配置信息如下:
server.port:8091
spring.application.name=eureka-server
# 配置信息,相当于给服务起个别名注册到注册中心
eureka.instance.hostname=eureka-a
# 指向其他两个注册中心
eureka.client.serviceUrl.defaultZone=http://eureka-b:8092/eureka/,http://eureka-c:8093/eureka/
# 配置为true,表示将自己注册到注册中心,并且从注册中心获取注册信息。
eureka.client.register-with-eureka=true
eureka.client.fetch-registry=true
2. eureka-b 的配置信息如下:
server.port:8092
spring.application.name=eureka-server
eureka.instance.hostname=eureka-b
eureka.client.serviceUrl.defaultZone=http://eureka-a:8091/eureka/,http://eureka-c:8093/eureka/
eureka.client.register-with-eureka=true
eureka.client.fetch-registry=true
3. eureka-c 的配置信息如下:
server.port:8093
spring.application.name=eureka-server
eureka.instance.hostname=eureka-c
eureka.client.serviceUrl.defaultZone=http://eureka-a:8091/eureka/,http://eureka-b:8092/eureka/
eureka.client.register-with-eureka=true
eureka.client.fetch-registry=true
4. 测试
本机直接访问 eureka-a/b/c 网络是不通的,需要配置 host 信息。在 Windows 的 C:\Windows\System32\drivers\hosts 或者 Linux 的 /etc/hoosts 文件末添加以下信息:
127.0.0.1 eureka-a eureka-b eureka-c
添加完之后,依次启动 eureka-a、 eureka-b、 eureka-c服务,等全部启动完成之后,浏览器访问地址:http://localhost:8091/,就可以看到页面的集群相关信息。
此时在 DS Replicas 模块中可以看到另外两台注册中心的别名(eureka-b 和 eureka-c);在 Instance currently registered with Eureka 模块中可以看到三个注册中心都以实例的形式注册到了注册中心。
在 General Info 模块中,可以看到 registered-replicas(已经注册到的副本)和 available-replicas(有效副本)都可以看到其他两个注册中心的信息。
此时 证明 Eureka Server 高可用集群搭建成功。
7. 常见问题
1. Eureka 的 UNKNOWN 问题
注册中心(Eureka Server)中的服务状态,常见的有 UP、DOWN,但有时会出现另外一种 UNKNOWN 状态,或者 UNKNOWN 服务名。
1. UNKNOWN 服务名
UNKNOWN 服务名是因为在项目中没有配置应用实例名称导致的,其配置参数为 spring.application.name 或者 eureka.instance.application,如果这两个参数都不配置,就会出现UNKNOWN 服务名。
2. UNKNOWN 状态
UNKNOWN 状态出现的几率很小,这是 eureka server没有获取到客户端的心跳导致的,如果将 eureka.client.healthcheck.enabled = true 配置到 bootstrap.yml也会导致此问题,此参数应该配置到 application.yml 文件中。
2. 注册中心的副本不可用(unavailable-replicas)
在搭建 eureka 集群时可能会出现,注册中心服务不可用的情况,其他eureka server 的地址进入了 unavailable-replicas中,导致这种情况的原因有很多:
1. eureka.client.serverUrl.defaultZone 配置地址错误。
2. 没有开启互相注册:
eureka.client.register-with-eureka=true
eureka.client.fetch-registry=true
3. 没有配置host信息