Eureka 服务注册中心的搭建

1. 搭建 Eureka Server

    1. Eureka介绍

        Eureka 是由 Java 语言开发的,在Spring Cloud中使用 spring Boot 技术对 Eureka 进行了封装。所以项目引入Eureka 对应的 starter 包(spring-cloud-starter-netflix-eureka-server),就使得项目具有了注册中心的功能。

    2. 添加依赖

        1. 添加项目的 parent 依赖

       

            org.springframework.boot

            spring-boot-starter-parent

            2.1.3.RELEASE

            

        

       2. 添加 Spring Cloud 的依赖信息:

             properties中定义了常用的变量,例如默认的JDK版本1.8,springCloud的版本Greenwich.SR1。

        

            1.8

            Greenwich.SR1

        

         dependencyManagement 设置项目使用的 spring Cloud 版本,此处使用Greenwich.SR1。

        

            

                

                    org.springframework.cloud

                    spring-cloud-dependencies

                    ${spring-cloud.version}

                    pom

                    import

                

            

        

    3. 添加 Eureka 依赖包

        添加 Eureka server 依赖包,在pom中添加 jar包依赖:

       

            org.springframework.cloud

            spring-cloud-starter-netflix-eureka-server

        

     注意

         如果 JDK 使用的是版本 9 以上,运行项目就会出现 java.lang.TypeNotPresentException: Type javax.xml.bind/JAXBContext not present 异常,这是因为 JAXB-API是 Java EE 的一部分,在 JDK 9版本以上,没有在默认的类路径中,需要手动引入 JAXB 依赖包。

    

        javax.xml.bind

        jaxb-api

        2.3.0

    

    

        com.sun.xml.bin

        jaxb-impl

        2.3.0

    

    

        org.glassfish.jaxb

        jaxb-runtime

        2.3.0

    

    

        javax.activation

        activation

        1.1.1

    

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地址、状态等。

Eureka 服务注册中心的搭建_第1张图片

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 模块中可以看到三个注册中心都以实例的形式注册到了注册中心。

Eureka 服务注册中心的搭建_第2张图片

         在 General Info 模块中,可以看到 registered-replicas(已经注册到的副本)和 available-replicas(有效副本)都可以看到其他两个注册中心的信息。

Eureka 服务注册中心的搭建_第3张图片

此时 证明 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中,导致这种情况的原因有很多:

Eureka 服务注册中心的搭建_第4张图片

    1. eureka.client.serverUrl.defaultZone 配置地址错误。

    2. 没有开启互相注册:

        eureka.client.register-with-eureka=true

        eureka.client.fetch-registry=true

    3. 没有配置host信息

注:摘抄自 纯洁的微笑、江南一点雨的springCloud微服务开发实践一书

你可能感兴趣的:(Eureka 服务注册中心的搭建)