Eureka 常用配置解析

古城微笑少年丶 2023-09-29 11:19 9阅读 0赞

#### 目录 ####

*  一、配置项解析
 *   *  1. 通用配置
     *  2. eureka.server前缀的配置项
     *  3. eureka.instance前缀的配置项
     *  4. eureka.client前缀
 *  二、配置项说明
 *   *  1.1 spring.application.name和eureka.instance.appname
     *  1.2 eureka.instance.instance-id
     *  1.3 eureka.instance.prefer-ip-address、eureka.instance.hostname、eureka.instance.ip-address
 *  三、配置Bean源码

## 一、配置项解析 ##

### 1. 通用配置 ###

# 应用名称，将会显示在Eureka界面的应用名称列
    spring.application.name=config-service
    
    # 应用端口，Eureka服务端默认为：8761
    server.port=3333

### 2. eureka.server前缀的配置项 ###

# 是否允许开启自我保护模式，缺省：true
    # 当Eureka服务器在短时间内丢失过多客户端时，自我保护模式可使服务端不再删除失去连接的客户端
    eureka.server.enable-self-preservation = false
    
    # Peer节点更新间隔，单位：毫秒
    eureka.server.peer-eureka-nodes-update-interval-ms = 
    
    # Eureka服务器清理无效节点的时间间隔，单位：毫秒，缺省：60000，即60秒
    eureka.server.eviction-interval-timer-in-ms = 60000

### 3. eureka.instance前缀的配置项 ###

# 服务名，默认取 spring.application.name 配置值，如果没有则为 unknown
    eureka.instance.appname = eureka-client
    
    # 实例ID
    eureka.instance.instance-id = eureka-client-instance1
    
    # 应用实例主机名
    eureka.instance.hostname = localhost
    
    # 客户端在注册时使用自己的IP而不是主机名，缺省：false
    eureka.instance.prefer-ip-address = false
    
    # 应用实例IP
    eureka.instance.ip-address = 127.0.0.1
    
    # 服务失效时间，失效的服务将被剔除。单位：秒，默认：90
    eureka.instance.lease-expiration-duration-in-seconds = 90
    
    # 服务续约（心跳）频率，单位：秒，缺省30
    eureka.instance.lease-renewal-interval-in-seconds = 30
    
    # 状态页面的URL，相对路径，默认使用 HTTP 访问，如需使用 HTTPS则要使用绝对路径配置，缺省：/info
    eureka.instance.status-page-url-path = /info
    
    # 健康检查页面的URL，相对路径，默认使用 HTTP 访问，如需使用 HTTPS则要使用绝对路径配置，缺省：/health
    eureka.instance.health-check-url-path = /health

### 4. eureka.client前缀 ###

# Eureka服务器的地址，类型为HashMap，缺省的Key为 defaultZone；缺省的Value为 http://localhost:8761/eureka
    # 如果服务注册中心为高可用集群时，多个注册中心地址以逗号分隔。 
    eureka.client.service-url.defaultZone=http://${
        eureka.instance.hostname}:${
        server.port}/eureka
    
    # 是否向注册中心注册自己，缺省：true
    # 一般情况下，Eureka服务端是不需要再注册自己的
    eureka.client.register-with-eureka = true
    
    # 是否从Eureka获取注册信息，缺省：true
    # 一般情况下，Eureka服务端是不需要的
    eureka.client.fetch-registry = true
    
    # 客户端拉取服务注册信息间隔，单位：秒，缺省：30
    eureka.client.registry-fetch-interval-seconds = 30
    
    # 是否启用客户端健康检查
    eureka.client.health-check.enabled = true
    
    # 
    eureka.client.eureka-service-url-poll-interval-seconds = 60
    
    # 连接Eureka服务器的超时时间，单位：秒，缺省：5
    eureka.client.eureka-server-connect-timeout-seconds = 5
    
    # 从Eureka服务器读取信息的超时时间，单位：秒，缺省：8
    eureka.client.eureka-server-read-timeout-seconds = 8
    
    # 获取实例时是否只保留状态为 UP 的实例，缺省：true
    eureka.client.filter-only-up-instances = true
    
    # Eureka服务端连接空闲时的关闭时间，单位：秒，缺省：30
    eureka.client.eureka-connection-idle-timeout-seconds = 30
    
    # 从Eureka客户端到所有Eureka服务端的连接总数，缺省：200
    eureka.client.eureka-server-total-connections = 200
    
    # 从Eureka客户端到每个Eureka服务主机的连接总数，缺省：50
    eureka.client.eureka-server-total-connections-per-host = 50

## 二、配置项说明 ##

Eureka中有一些配置项，通过查看网上的资料可以大概知道其含义，然而如果没有一个直观的指导，并不能清晰地认识他们实际的作用效果。下面通过截图对部分配置项加以解释说明。

### 1.1 spring.application.name和eureka.instance.appname ###

同时配置时，`eureka.instance.appname`优先级更高。

如果没有配置`eureka.instance.appname`，则使用`spring.application.name`的值，如果连`spring.application.name`都没有配置，则取**unknown**。

该配置项对应Eureka界面下图红框的内容：  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16]

### 1.2 eureka.instance.instance-id ###

配置项`eureka.instance.instance-id`的值决定了下图右侧红框中的显示内容：  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 1]  
如果没有设置`eureka.instance.instance-id`，那么显示的值将是一个由Eureka自动判断生成的编号：  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 2]

### 1.3 eureka.instance.prefer-ip-address、eureka.instance.hostname、eureka.instance.ip-address ###

eureka.instance前缀的配置项中，这几个配置项绝对烧脑，在`eureka.instance.prefer-ip-address = true`时，实例优先使用`eureka.instance.ip-address`的值进行注册，如果没有配置`eureka.instance.ip-address`，则使用第一个非回环IP地址进行注册。

此时，我们打开Eureka的界面，在实例上右键，复制链接地址；或将鼠标放在下图右上方的链接上（不点击），就可以获取实例的地址，如下图左下角，可见此时实例注册的是IP：  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 3]  
而当`eureka.instance.prefer-ip-address = false`时，同样的方式可以查看实例注册地址采用了主机名`eureka.instance.hostname`的值：  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 4]

## 三、配置Bean源码 ##

最后，对应于本文出现的配置项，Eureka中定义的源码类如下。

**eureka.server前缀的配置项**

org.springframework.cloud.netflix.eureka.server.EurekaServerConfigBean

**eureka.instance前缀的配置项**

org.springframework.cloud.netflix.eureka.EurekaInstanceConfigBean

**eureka.client前缀的配置项**

org.springframework.cloud.netflix.eureka.EurekaClientConfigBean

[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/e407690ccb44414a98a2dca2d8eab857.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/967f4d91ff714cc79dd95a42c30b5d48.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 2]: https://img-blog.csdnimg.cn/bb1cb8a7a9be4cf28b92ad1bce1d0781.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 3]: https://img-blog.csdnimg.cn/f680b475f3bb49a6bfccb2e2e51dec9f.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_size_20_color_FFFFFF_t_70_g_se_x_16 4]: https://img-blog.csdnimg.cn/33d8e80a2fd447b39ccda91a3de19be8.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bC85Y-k5ouJ5pav54uX6JuL5YS_,size_20,color_FFFFFF,t_70,g_se,x_16