Spring-Cloud Euraka是Spring Cloud汇合中一个组件,它是对Euraka的集成,用于服务注册和发现。Eureka是Netflix中的一个开源框架。它和 zookeeper、Consul一样,都是用于服务注册治理的,同样,Spring-Cloud 还集成了Zookeeper和Consul。

搭建eureka服务注册核心

引入以下依赖

<dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter</artifactId>        </dependency>        <!-- 最新版的 eureka 服务端包 -->        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>        </dependency>    </dependencies>    <!-- SpringCloud依赖,起到治理版本的作用 -->    <dependencyManagement>        <dependencies>            <dependency>                <groupId>org.springframework.cloud</groupId>                <artifactId>spring-cloud-dependencies</artifactId>                <version>Hoxton.SR9</version>                <type>pom</type>                <scope>import</scope>            </dependency>        </dependencies>    </dependencyManagement>

Spring Cloud 和 Spring Boot 之间版本对应关系

Release TrainBoot Version
2020.0.x aka Ilford2.4.x
Hoxton2.2.x, 2.3.x (Starting with SR5)
Greenwich2.1.x
Finchley2.0.x
Edgware1.5.x
Dalston1.5.x

在启动类上增加@EnableEurekaServer注解,表明这是一个Eureka服务端

@SpringBootApplication@EnableEurekaServerpublic class SpringCloudEurekaApplication {    public static void main(String[] args) {        SpringApplication.run(SpringCloudEurekaApplication.class, args);    }}

在application.properties中增加一些配置

server.port=8080spring.application.name=Eureka-Server# 指定了Eureka服务端的IPeureka.instance.hostname=localhosteureka.instance.statusPageUrl=http://${eureka.instance.hostname}:${server.port}/infoeureka.instance.healthCheckUrl=http://${eureka.instance.hostname}:${server.port}/healtheureka.instance.homePageUrl=http://${eureka.instance.hostname}/# 示意是否将服务注册到Eureka服务端,因为本身就是Eureka服务端,所以设置为false# eureka.client.register-with-eureka=false# 示意是否从Eureka服务端获取服务信息,因为这里只搭建了一个Eureka服务端,并不需要从别的Eureka服务端同步服务信息,所以这里设置为false# eureka.client.fetch-registry=false# 指定Eureka服务端的地址,默认值为http://localhost:8761/eureka 指定Eureka服务端的地址为另外一个Eureka服务端的地址8081eureka.client.serviceUrl.defaultZone=http://${eureka.instance.hostname}:${server.port}/eureka/# 用于定义服务续约工作的调用间隔时间,默认30秒eureka.client.serviceUrl.registry-fetch-interval-seconds=5

配置结束后启动服务,拜访http://localhost:8080/

因为还没有Eureka客户端将服务注册进来,所以Instances currently registered with Eureka列表是空的

搭建provider服务提供者

引入以下依赖

<dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</artifactId>        </dependency>        <!-- 监控治理 -->        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-actuator</artifactId>        </dependency>    </dependencies>    <!-- SpringCloud依赖,起到治理版本的作用 -->    <dependencyManagement>        <dependencies>            <dependency>                <groupId>org.springframework.cloud</groupId>                <artifactId>spring-cloud-dependencies</artifactId>                <version>Hoxton.SR9</version>                <type>pom</type>                <scope>import</scope>            </dependency>        </dependencies>    </dependencyManagement>

在启动类上加@EnableDiscoveryClient注解,表明这是一个Eureka客户端

@SpringBootApplication@EnableDiscoveryClientpublic class SpringCloudProviderApplication {    public static void main(String[] args) {        SpringApplication.run(SpringCloudProviderApplication.class, args);    }}

接着编写一个TestController,对外提供一些REST服务

@RestControllerpublic class TestController {    @GetMapping("/hello")    public String hello() {        return "hello world";    }}

在application.properties中增加一些配置

# 指定了服务的端口为8081server.port=8082# 指定服务名称为Server-Provider,后续服务消费者要获取下面TestController中接口的时候会用到这个服务名spring.application.name=Server-Provider# 尽管这两个配置的默认值就是true,但这里还是显式配置下,使Eureka客户端的性能更为直观(即向服务端注册服务并定时从服务端获取服务缓存到本地)eureka.client.register-with-eureka=trueeureka.client.fetch-registry=true# 指定Eureka服务端的地址,这里为下面定义的Eureka服务端地址eureka.client.serviceUrl.defaultZone=http://localhost:8080/eureka/,http://localhost:8081/eureka/# 拜访门路能够显示IP地址eureka.instance.prefer-ip-address=true

配置好后,启动Eureka-Client,能够从控制台中看到注册胜利的音讯

Registered Applications size is zero : trueApplication version is -1: trueGetting all instance registry info from the eureka serverThe response status is 200Starting heartbeat executor: renew interval is: 30InstanceInfoReplicator onDemand update allowed rate per min is 4Discovery Client initialized at timestamp 1611244216061 with initial instances count: 0Registering application SERVER-PROVIDER with eureka with status UPSaw local status change event StatusChangeEvent [timestamp=1611244216076, current=UP, previous=STARTING]DiscoveryClient_SERVER-PROVIDER/DESKTOP-7LUOFJF.lan:Server-Provider:8081: registering service...Tomcat started on port(s): 8081 (http) with context path ''Updating port to 8081DiscoveryClient_SERVER-PROVIDER/DESKTOP-7LUOFJF.lan:Server-Provider:8081 - registration status: 204

再次拜访http://localhost:8082/,可看到服务列表里曾经呈现了名字为Server-providerde服务了

UP示意在线的意思(如果Eureka客户端失常敞开,那么这里的状态将变为DOWN),点击前面的链接http://192.168.68.233:8081/actuator/info将拜访该服务的/info接口:

{"app":{"name":"Server-Provider"}}

这时候敞开Eureka客户端,再次刷新http://localhost:8080/

可看到尽管Eureka客户端曾经敞开了,然而Eureka服务端页面的服务服务列表中仍然还有该服务,并且页面红色文字提醒

EMERGENCY! EUREKA MAY BE INCORRECTLY CLAIMING INSTANCES ARE UP WHEN THEY’RE NOT. RENEWALS ARE LESSER THAN THRESHOLD AND HENCE THE INSTANCES ARE NOT BEING EXPIRED JUST TO BE SAFE.

大抵意思是Eureka曾经进入了保护模式。微服务在部署之后可能因为网络问题造成Eureka客户端无奈胜利的发送心跳给Eureka服务端,这时候Eureka服务端认定Eureka客户端曾经挂掉了,尽管实际上Eureka客户端还在失常的运行着。而保护模式就是为了解决这个问题,即当Eureka服务端在短时间内同时失落了过多的Eureka客户端时,Eureka服务端会进入保护模式,不去剔除这些客户端。因为咱们这里只部署了一个Eureka客户端服务,所以敞开客户端后满足“短时间内失落过多Eureka客户端”的条件。

在开发中能够先将保护模式给关了,咱们在Eureka服务端加上一条配置

eureka.server.enable-self-preservation= false

开启服务监控actuator

引入以下依赖

<dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-web</artifactId></dependency><dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-actuator</artifactId></dependency>

在application.properties中增加一些配置

# 启用监控# 凋谢所有端点health,info,metrics,通过actuator/+端点名就能够获取相应的信息。默认关上health和info,metrics默认不凋谢management.endpoints.web.exposure.include=*#未开启actuator/health时,咱们获取到的信息是{"status":"UP"},status的值还有可能是 DOWN。开启后打印详细信息management.endpoint.health.show-details=alwaysinfo.app.name=Server-Provider

拜访门路

localhost依据本人部署的服务器IP、主机名拜访。 info、health为默认凋谢,metrics默认不凋谢

  • 心跳查看 http://localhost:8081/actuator/info
  • 健康检查 http://localhost:8081/actuator/health
  • 指标 http://localhost:8081/actuator/metrics

Eureka集群

ureka服务端充当了重要的角色,所有Eureka客户端都将本人提供的服务注册到Eureka服务端,而后供所有服务消费者应用。如果单节点的Eureka服务端宕机了,那么所有服务都无奈失常的拜访,这必将是灾难性的。为了进步Eureka服务端的可用性,咱们个别会对其集群部署,即同时部署多个Eureka服务端,并且能够相互间同步服务。

在搭建Eureka服务端的时候咱们曾把上面两个配置给敞开了

eureka.client.register-with-eureka=falseeureka.client.fetch-registry=false

实际上在Eureka集群模式中,开启这两个参数能够让以后Eureka服务端将本人也作为服务注册到别的Eureka服务端,并且从别的Eureka服务端获取服务进行同步。所以这里咱们将这两个参数置为true(默认就是true),上面开始搭建Eureka服务端集群,为了简略起见这里只搭建两个节点的Eureka服务端集群。

两个applications.properties配置如下

  • 8080端口的Eureka服务端
server.port=8080spring.application.name=Eureka-Server# 指定了Eureka服务端的IPeureka.instance.hostname=localhosteureka.instance.statusPageUrl=http://${eureka.instance.hostname}:${server.port}/infoeureka.instance.healthCheckUrl=http://${eureka.instance.hostname}:${server.port}/healtheureka.instance.homePageUrl=http://${eureka.instance.hostname}/# 示意是否将服务注册到Eureka服务端,因为本身就是Eureka服务端,所以设置为false# eureka.client.register-with-eureka=false# 示意是否从Eureka服务端获取服务信息,因为这里只搭建了一个Eureka服务端,并不需要从别的Eureka服务端同步服务信息,所以这里设置为false# eureka.client.fetch-registry=false# 指定Eureka服务端的地址,默认值为http://localhost:8761/eureka 指定Eureka服务端的地址为另外一个Eureka服务端的地址8081eureka.client.serviceUrl.defaultZone=http://${eureka.instance.hostname}:8081/eureka/# 用于定义服务续约工作的调用间隔时间,默认30秒eureka.client.serviceUrl.registry-fetch-interval-seconds=5# 敞开保护模式eureka.server.enable-self-preservation=false
  • 8081端口的Eureka服务端
server.port=8081spring.application.name=Eureka-Server# 指定了Eureka服务端的IPeureka.instance.hostname=localhosteureka.instance.statusPageUrl=http://${eureka.instance.hostname}:${server.port}/infoeureka.instance.healthCheckUrl=http://${eureka.instance.hostname}:${server.port}/healtheureka.instance.homePageUrl=http://${eureka.instance.hostname}/# 示意是否将服务注册到Eureka服务端,因为本身就是Eureka服务端,所以设置为false# eureka.client.register-with-eureka=false# 示意是否从Eureka服务端获取服务信息,因为这里只搭建了一个Eureka服务端,并不需要从别的Eureka服务端同步服务信息,所以这里设置为false# eureka.client.fetch-registry=false# 指定Eureka服务端的地址,默认值为http://localhost:8761/eureka 指定Eureka服务端的地址为另外一个Eureka服务端的地址8080eureka.client.serviceUrl.defaultZone=http://${eureka.instance.hostname}:8080/eureka/# 用于定义服务续约工作的调用间隔时间,默认30秒eureka.client.serviceUrl.registry-fetch-interval-seconds=5# 敞开保护模式eureka.server.enable-self-preservation=false

搭建consumer服务消费者

Eureka客户端即是服务提供者,也是服务消费者,即本身的接口可能被别的服务拜访,同时也可能调用别的服务接口

引入一下依赖

<dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</artifactId>        </dependency>    </dependencies>    <!-- SpringCloud依赖,起到治理版本的作用 -->    <dependencyManagement>        <dependencies>            <dependency>                <groupId>org.springframework.cloud</groupId>                <artifactId>spring-cloud-dependencies</artifactId>                <version>Hoxton.SR9</version>                <type>pom</type>                <scope>import</scope>            </dependency>        </dependencies>    </dependencyManagement>

在入口类中退出@EnableDiscoveryClient注解用于发现服务和注册服务,并配置一个RestTemplate Bean,而后加上@LoadBalanced注解来开启负载平衡

@SpringBootApplication@EnableDiscoveryClientpublic class SpringCloudConsumerApplication {    @Bean    @LoadBalanced    RestTemplate restTemplate() {        return new RestTemplate();    }    public static void main(String[] args) {        SpringApplication.run(SpringCloudConsumerApplication.class, args);    }}

编写一个TestController,用于生产服务

@RestControllerpublic class TestController {    @Autowired    private RestTemplate restTemplate;    /**     * 注入了RestTemplate,getInfo中应用RestTemplate对象平衡的去获取服务并生产。     * 能够看到咱们应用服务名称(Server-Provider)去获取服务的,而不是应用传统的IP加端口的模式。     * 这就体现了应用Eureka去获取服务的益处,咱们只有保障这个服务名称不变即可,IP和端口不再是咱们关怀的点     *     * @return     */    @GetMapping("/info")    public String getInfo() {        return this.restTemplate.getForEntity("http://Server-Provider/hello", String.class).getBody();    }}

在application.properties中增加一些配置

# 指定了服务的端口为8083server.port=8083# 指定服务名称为Server-Consumer,后续服务消费者要获取下面TestController中接口的时候会用到这个服务名spring.application.name=Server-Consumer# 尽管这两个配置的默认值就是true,但这里还是显式配置下,使Eureka客户端的性能更为直观(即向服务端注册服务并定时从服务端获取服务缓存到本地)eureka.client.register-with-eureka=trueeureka.client.fetch-registry=true# 指定Eureka服务端的地址,这里为下面定义的Eureka服务端地址eureka.client.serviceUrl.defaultZone=http://localhost:8080/eureka/,http://localhost:8081/eureka/# 拜访门路能够显示IP地址eureka.instance.prefer-ip-address=true

启动该我的项目,拜访http://localhost:8083/info

Eureka增加认证

出于平安的思考,咱们可能会对Eureka服务端增加用户认证的性能。咱们在Eureka-Server引入Spring-Security依赖

<dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-security</artifactId></dependency>

而后在application.yml中配置用户名和明码

spring.security.user.name=adminspring.security.user.password=123456

Eureka服务端配置了明码之后,所有eureka.client.serviceUrl.defaultZone的配置也必须配置上用户名和明码,格局为:eureka.client.serviceUrl.defaultZone=http://${userName}:${password}@${hosetname}:${port}/eureka/,如:

eureka.client.serviceUrl.defaultZone=http://admin:123456@${eureka.instance.hostname}:8080/eureka/

从新打包并部署后,拜访http://localhost:8080/,页面将弹出验证窗口,输出用户名和明码后即可拜访

Eureka配置

Eureka中罕用的配置选项及代表的含意

配置含意默认值
eureka.client.enabled是否启用Eureka Clienttrue
eureka.client.register-with-eureka示意是否将本人注册到Eureka Servertrue
eureka.client.fetch-registry示意是否从Eureka Server获取注册的服务信息true
eureka.client.serviceUrl.defaultZone配置Eureka Server地址,用于注册服务和获取服务http://localhost:8761/eureka
eureka.client.registry-fetch-interval-seconds默认值为30秒,即每30秒去Eureka Server上获取服务并缓存30
eureka.instance.lease-renewal-interval-in-seconds向Eureka Server发送心跳的间隔时间,单位为秒,用于服务续约30
eureka.instance.lease-expiration-duration-in-seconds定义服务生效工夫,即Eureka Server检测到Eureka Client木有心跳后(客户端意外下线)多少秒将其剔除90
eureka.server.enable-self-preservation用于开启Eureka Server自我爱护性能true
eureka.client.instance-info-replication-interval-seconds更新实例信息的变动到Eureka服务端的间隔时间,单位为秒30
eureka.client.eureka-service-url-poll-interval-seconds轮询Eureka服务端地址更改的间隔时间,单位为秒。300
eureka.instance.prefer-ip-address示意应用IP进行配置为不是域名false
eureka.client.healthcheck.enabled默认Erueka Server是通过心跳来检测Eureka Client的健康状况的,通过置为true扭转Eeureka Server对客户端衰弱检测的形式,改用Actuator的/health端点来检测。false

Eureka还有许多别的配置,具体能够参考EurekaClientConfigBeanEurekaServerConfigBeanEurekaInstanceConfigBean配置类的源码。

References

[1] Spring Cloud Netflix: https://cloud.spring.io/spring-cloud-netflix/reference/html/#service-discovery-eureka-clients