Spring Boot(2.1.2.RELEASE) + Spring Cloud (Finchley.RELEASE)搭建服务注册和发现组件Eureka

前言:由于版本原因,部分关于Spring Cloud的书中使用的是Spring Boot 1.x 版本,很多配置或名称在新版本中已经发生了改变。此篇文章记录的是使用较新的Spring Boot 2.x和Spring Cloud Finchley.RELEASE搭建服务注册和发现组件Eureka的步骤(部分代码以截图形式展现)。

一、搭建Eureka

1. 编写 Eureka Server

使用IDEA创建一个新的项目。

搭建Eureka服务注册和发现组件1.png

选择maven->Next(无需选择maven模板)。

搭建Eureka服务注册和发现组件2.png

填写项目的GroupId(公司域名倒写)和ArtifactId(项目名)

搭建Eureka服务注册和发现组件3.png

检查无误后点击Finish即可。

搭建Eureka服务注册和发现组件4.png

删除自动创建的src目录。

编写pom.xml文件,添加Spring Boot(2.1.2.RELEASE)父项目和Spring Cloud(Finchley.RELEASE)的依赖。

注意:在添加Spring Cloud依赖时,必须指定type属性为pom,否则maven会报错。默认情况下,type属性为jar,但当依赖的jar包特别多时,会导致pom.xml文件过大,这时我们可以将所有的jar包打成一个pom,然后去依赖这一个pom,就可以依赖所有的jar包。

搭建Eureka服务注册和发现组件5.png

创建一个maven子模块。鼠标移到项目名上点击鼠标右键->New->Module。

搭建Eureka服务注册和发现组件6.png

仍然不用做任何选择直接Next。

搭建Eureka服务注册和发现组件7.png

填写子模块的ArtifactId为eureka-server,点击Next。

搭建Eureka服务注册和发现组件8.png

填写Module name检查无误后点击Finish即可。

搭建Eureka服务注册和发现组件9.png
搭建Eureka服务注册和发现组件10.png

编写子项目eureka-server的pom.xml文件,添加spring-cloud-starter-netflix-eureka-server的依赖,当前Spring Cloud版本为Finchley.RELEASE,其它版本如有不同可去mvnrepository查找对应ArtifactId。

搭建Eureka服务注册和发现组件11.png

在子模块中创建Spring Boot启动类EurekaServerApplication.java和配置文件application.yml(properties文件也可)。

注意:启动类应放置在源码包下。

搭建Eureka服务注册和发现组件12.png

编写启动类。添加@SpringBootApplication和@EnableEurekaServer注解。声明这是一个Spring Boot启动类同时也是一个Eureka Server。

编写main方法。

搭建Eureka服务注册和发现组件13.png

编写配置文件application.yml。

搭建Eureka服务注册和发现组件14.png

至此,一个Eureka Server就编写完成。

如果遇到了一些“意料之外”的错误,可点击IDEA右侧的maven工具,查看项目依赖是否有误。可尝试刷新或重新打开项目。

搭建Eureka服务注册和发现组件15.png

运行启动类的main方法,在浏览器中输入application.yml中配置的地址(http://localhost:8761)即可查看此Eureka Server的相关信息。

搭建Eureka服务注册和发现组件16.png

可以看得该Instance currently registered with Eureka这一项还没有任何内容,因为还没有Eureka Client向该注册中心注册服务。下面就来编写一个Eureka Client。

2. 编写 Eureka Client

与创建eureka-server模块步骤相同。

创建一个maven子模块。鼠标移到项目名上点击鼠标右键->New->Module。仍然不用做任何选择直接Next。填写子模块的ArtifactId为eureka-client,点击Next。填写Module name检查无误后点击Finish即可。

编写子项目eureka-client的pom.xml文件。

添加spring-cloud-starter-netflix-eureka-client的依赖,当前Spring Cloud版本为Finchley.RELEASE,其它版本如有不同可去mvnrepository查找对应ArtifactId。

添加spring-boot-starter-web的依赖,client必须添加该依赖,无需指定版本。

<?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">
    <parent>
        <artifactId>eureka</artifactId>
        <groupId>cn.org.lilu</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>eureka-client</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
            <version>2.1.2.RELEASE</version>
        </dependency>
    </dependencies>
</project>

创建Spring Boot启动类EurekaClientApplication.java和配置文件application.yml(properties文件也可)。

注意:启动类应放置在源码包下。

编写配置文件application.yml。应用服务名为eureka-client,端口号1234,服务注册地址为http://localhost:8761/eureka/

server:
  port: 1234
spring:
  application:
    name: eureka-client
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/

编写启动类。添加@EnableEurekaClient注解声明这是一个Eureka Client。

package cn.org.lilu;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

/**
 * @Auther: lilu
 * @Date: 2019/6/28
 * @Description:
 */
@SpringBootApplication
@EnableEurekaClient
public class EurekaClientApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaClientApplication.class,args);
    }
}

至此,一个Eureka Client就编写完成。运行EurekaClientApplication类的main方法。成功后控制台会打印:

INFO 70912 --- [nfoReplicator-0] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_EUREKA-CLIENT/localhost:eureka-client:1234 - registration status: 204

而Eureka Server端的控制台会打印:

INFO 73316 --- [nio-8761-exec-5] c.n.e.registry.AbstractInstanceRegistry  : Registered instance EUREKA-CLIENT/localhost:eureka-client:1234 with status UP (replication=false)

此时Eureka Client已向Eureka Server注册了,访问http://localhost:8761,可看到Instance currently registered with Eureka这项下已有一个实例注册。

搭建Eureka服务注册和发现组件17

二、搭建高可用Eureka Server集群

1. 编写双节点Eureka Server集群

实际线上生产环境中,前文编写的单节点Eureka Server可靠性不足。

Eureka Client会定时连接Eureka Server,获取服务注册表中的信息并缓存到本地。微服务在消费远程API时总是使用本地缓存中的数据,因此一般情况下,即使单节点的Eureka Server发生宕机,也不会影响到各微服务之间的调用,但如果当Eureka Server发生宕机时,某些微服务恰好也出现了不可用的情况,此时Eureka Client中的缓存并未进行更新,仍然认为服务可用,就会影响到微服务之间的调用,甚至影响整个应用系统的高可用性。因此,生产环境中需要部署一个高可用Eureka Server集群。

Eureka Server可通过运行多个实例并相互注册的方式实现高可用。集群中的多个实例会彼此增量的同步数据,保证所有节点数据一致性。节点之间相互注册是Eureka Server的默认行为,无需做任何配置。

下面构建一个双节点Eureka Server集群。

创建一个maven子模块。鼠标移到项目名上点击鼠标右键->New->Module。不做任何选择直接Next。填写子模块的ArtifactId为eureka-server-cluster,点击Next。填写Module name检查无误后点击Finish即可。

编写子模块eureka-server-cluster的pom.xml文件。

添加spring-cloud-starter-netflix-eureka-server的依赖,当前Spring Cloud版本为Finchley.RELEASE,其它版本如有不同可去mvnrepository查找对应ArtifactId。

<?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">
    <parent>
        <artifactId>eureka</artifactId>
        <groupId>cn.org.lilu</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>eureka-server-cluster</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
            <version>2.1.2.RELEASE</version>
        </dependency>
    </dependencies>
</project>

创建Spring Boot启动类EurekaServerClusterApplication.java和配置文件application.yml(properties文件也可)。

注意:启动类应放置在源码包下。

我们要在本地搭建Eureka Server集群环境,需要运行多个Eureka Server实例,可采用多配置文件格式,在启动时指定具体的配置文件。也可利用开发工具IDEA,在启动一个实例后,修改配置文件再启动另一个实例。这样可以很方便地在本地环境进行测试。

下面介绍利用开发工具IDEA启动多个实例的方法。

首先需要修改设置Run/Debug Configurations,点击Edit Configurations...,找到EurekaServerClusterApplication启动配置,勾选Allow parallel run选项。我的IDEA版本为2018.3.3。网上看到很多人写的是去掉Single instance only选项,应该是版本原因。

搭建Eureka服务注册和发现组件18
搭建Eureka服务注册和发现组件19

为了在本地模拟2个Server服务节点,需要修改本地host文件,Windows系统在C:\Windows\System32\drivers\etc\hosts中修改,其它系统自行百度文件位置。使用Notpad++或其它记事本软件以管理员身份打开该文件,在文件末尾添加如下内容后保存(注意文件属性是否设置了只读,否则无法保存)。

127.0.0.1 peer1
127.0.0.1 peer2

编写启动类。添加@EnableEurekaServer注解声明这是一个Eureka Server。

package cn.org.lilu;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

/**
 * @Auther: lilu
 * @Date: 2019/6/27
 * @Description:
 */
@SpringBootApplication
@EnableEurekaServer
public class EurekaServerClusterApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaServerClusterApplication.class,args);
    }
}

编写配置文件application.yml。由于在一台电脑上部署,Server节点的端口不能相同。为了让两个节点进行相互注册,在节点配置1中设置另一个Eureka Server的地址,同样在节点配置2中也设置另一个Eureka Server的地址,这样就实现了相互注册。

spring:
  application:
    name: peer-cluster

# 节点配置1
#server:
#  port: 8761
#eureka:
#  instance:
#    hostname: peer1
#  client:
#    # 设置Eureka Server地址
#    service-url:
#      defaultZone: http://peer2:8762/eureka/


# 节点配置2
server:
  port: 8762
eureka:
  instance:
    hostname: peer2
  client:
    # 设置Eureka Server地址
    service-url:
      defaultZone: http://peer1:8761/eureka/

打开节点配置1的注释,将节点配置2注释起来,运行启动类中的main方法,此时控制台会出现报错信息,原因是另一个Server节点还未启动。修改配置文件application.yml,将节点配置1注释起来,打开节点配置2的注释,再次运行启动类中的main方法,运行成功后,可以看得之前出现报错信息的控制台中打印了如下内容。

INFO 38848 --- [nio-8762-exec-2] c.n.e.registry.AbstractInstanceRegistry  : Registered instance PEER-CLUSTER/localhost:peer-cluster:8761 with status UP (replication=false)

此时两个Server节点之间已经完成了相互注册。访问http://peer1:8761http://peer2:8762可查看相关信息。

搭建Eureka服务注册和发现组件20.png
搭建Eureka服务注册和发现组件21.png

至此,一个双节点的Eureka Server就搭建完成。

下面介绍使用多配置文件的方式启动多个Eureka Server实例的方法(部分书中使用了该方法)。

仍然需要修改本地host文件,上文中已说明相关步骤。另外创建两个配置文件application-peer1.yml和application-peer2.yml。与application.yml在同一目录。将刚才的节点配置1的内容复制到application-peer1.yml中,将节点配置2的内容复制到application-peer2.yml中,修改application.yml中的配置。三个配置文件代码如下。

application.yml

spring:
  profiles:
    active: native
  application:
    name: peer-cluster

application-peer1.yml

server:
  port: 8761
eureka:
  instance:
    hostname: peer1
  client:
    # 设置Eureka Server地址
    service-url:
      defaultZone: http://peer2:8762/eureka/

application-peer2.yml

server:
  port: 8762
eureka:
  instance:
    hostname: peer2
  client:
    # 设置Eureka Server地址
    service-url:
      defaultZone: http://peer1:8761/eureka/

由于需要打成jar包运行,在pom.xml文件中添加maven插件。完整的pom.xml内容如下。

<?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">
    <parent>
        <artifactId>eureka</artifactId>
        <groupId>cn.org.lilu</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>eureka-server-cluster</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
            <version>2.1.2.RELEASE</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

可直接使用IDEA提供的maven工具打包。点击IDEA右侧的maven工具,找到eureka-server-cluster项目下的Lifecycle,点击package即可打包。

搭建Eureka服务注册和发现组件22.png

生成的jar包在target目录下。

搭建Eureka服务注册和发现组件23.png

右击target目录,点击Open in Terminal进入命令行。

搭建Eureka服务注册和发现组件24.png

输入下面的命令指定配置文件为application-peer1.yml按回车键。

java -jar eureka-server-cluster-1.0-SNAPSHOT.jar --spring.profiles.active=peer1

运行后控制台会输出报错信息,不用管。再次右击target目录,点击Open in Terminal进入第二个命令行,输入下面的命令指定配置文件为application-peer2.yml按回车键。

java -jar eureka-server-cluster-1.0-SNAPSHOT.jar --spring.profiles.active=peer2

启动完成后,两个Server就完成了相互注册,仍可访问http://peer1:8761http://peer2:8762查看相关信息。

以上就是使用多配置文件格式搭建双节点Eureka Server集群。

2. 将应用注册到Eureka Server集群上

修改模块eureka-client的配置文件application.yml,配置多个Eureka Server地址,使用英文逗号分隔。

server:
  port: 1234
spring:
  application:
    name: eureka-client
eureka:
  client:
    service-url:
      defaultZone: http://peer1:8761/eureka/,http://peer2:8762/eureka/

启动eureka-client模块,访问http://peer1:8761http://peer2:8762可看到应用已经注册到Eureka Server集群上了。

搭建Eureka服务注册和发现组件25.png

当然,微服务即使只配置Eureka Server集群中的某个节点,也能正常注册到Eureka Server集群,因为多个Eureka Server之间的数据会相互同步。不过为了适应某些极端场景,建议在客户端配置多个Eureka Server节点。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容