SpringCloud组件：Eureka服务注册中心内置的REST节点列表

最新推荐文章于 2022-11-02 11:11:55 发布
最新推荐文章于 2022-11-02 11:11:55 发布
阅读量297 收藏 2
点赞数
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_42033269/article/details/101477983
版权

你有没有考虑过Eureka Client与Eureka Server是通过什么方式进行通讯的？
为什么Client启动成功后Server就会被注册到Server的服务列表内？
为什么我们在正常关闭Client后Server会有所感知？

既然这么多问题，带着这些问题来进行本章的学习吧。

本章目标

熟悉Eureka Server内部提供的REST服务维护请求节点。

构建项目

我们本章知识点不需要涉及到代码的编写，所以我们只需要运行之前章节SpringCloud组件：搭建Eureka服务注册中心的源码即可。

REST节点一览

Eureka Server内部通过JAX-RS(Java API for RESTful Web Services)规范提供了一系列的管理服务节点的请求节点，这样也保证了在非JVM环境运行的程序可以通过HTTP REST方式进行管理维护指定服务节点，所以只要遵循Eureka协议的服务节点都可以进行注册到Eureka Server。

Eureka提供的REST请求可以支持XML以及JSON形式通信，默认采用XML方式，REST列表如表所示：

请求名称请求方式HTTP地址请求描述
注册新服务POST/eureka/apps/{appID} 传递JSON或者XML格式参数内容，HTTP code为204时表示成功
取消注册服务DELETE/eureka/apps/{appID}/{instanceID} HTTP code为200时表示成功
发送服务心跳PUT/eureka/apps/{appID}/{instanceID} HTTP code为200时表示成功
查询所有服务GET/eureka/appsHTTP code为200时表示成功，返回XML/JSON数据内容
查询指定appID的服务列表GET/eureka/apps/{appID} HTTP code为200时表示成功，返回XML/JSON数据内容
查询指定appID&instanceIDGET/eureka/apps/{appID}/{instanceID} 获取指定appID以及InstanceId的服务信息，HTTP code为200时表示成功，返回XML/JSON数据内容
查询指定instanceID服务列表GET/eureka/apps/instances/{instanceID} 获取指定instanceID的服务列表，HTTP code为200时表示成功，返回XML/JSON数据内容
变更服务状态PUT/eureka/apps/{appID}/{instanceID}/status?value=DOWN服务上线、服务下线等状态变动，HTTP code为200时表示成功
变更元数据PUT/eureka/apps/{appID}/{instanceID}/metadata?key=valueHTTP code为200时表示成功
查询指定IP下的服务列表GET/eureka/vips/{vipAddress} HTTP code为200时表示成功
查询指定安全IP下的服务列表GET/eureka/svips/{svipAddress} HTTP code为200时表示成功

在上面列表中参数解释

  • {appID}：服务名称，对应spring.application.name参数值
  • {instanceID}：实例名称，如果已经自定义instanceId则对应eureka.instance.instance-id参数值
服务注册

在Eureka Client启动成功后会发送POST方式的请求到/eureka/apps/{appID}，发送注册请求时的主体内容在官网也有介绍，如果我们根据指定的主体内容发送请求到Eureka Server时也是可以将服务注册成功的，主体内容要以XML/JSON格式的XSD传递：

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <xsd:element name="instance">
        <xsd:complexType>
            <xsd:all>
                <!-- hostName in ec2 should be the public dns name, within ec2 public dns name will
                     always resolve to its private IP -->
                <xsd:element name="hostName" type="xsd:string" />
                <xsd:element name="app" type="xsd:string" />
                <xsd:element name="ipAddr" type="xsd:string" />
                <xsd:element name="vipAddress" type="xsd:string" />
                <xsd:element name="secureVipAddress" type="xsd:string" />
                <xsd:element name="status" type="statusType" />
                <xsd:element name="port" type="xsd:positiveInteger" minOccurs="0" />
                <xsd:element name="securePort" type="xsd:positiveInteger" />
                <xsd:element name="homePageUrl" type="xsd:string" />
                <xsd:element name="statusPageUrl" type="xsd:string" />
                <xsd:element name="healthCheckUrl" type="xsd:string" />
               <xsd:element ref="dataCenterInfo" minOccurs="1" maxOccurs="1" />
                <!-- optional -->
                <xsd:element ref="leaseInfo" minOccurs="0"/>
                <!-- optional app specific metadata -->
                <xsd:element name="metadata" type="appMetadataType" minOccurs="0" />
            </xsd:all>
        </xsd:complexType>
    </xsd:element>

    <xsd:element name="dataCenterInfo">
        <xsd:complexType>
             <xsd:all>
                 <xsd:element name="name" type="dcNameType" />
                 <!-- metadata is only required if name is Amazon -->
                 <xsd:element name="metadata" type="amazonMetdataType" minOccurs="0"/>
             </xsd:all>
        </xsd:complexType>
    </xsd:element>

    <xsd:element name="leaseInfo">
        <xsd:complexType>
            <xsd:all>
                <!-- (optional) if you want to change the length of lease - default if 90 secs -->
                <xsd:element name="evictionDurationInSecs" minOccurs="0"  type="xsd:positiveInteger"/>
            </xsd:all>
        </xsd:complexType>
    </xsd:element>

    <xsd:simpleType name="dcNameType">
        <!-- Restricting the values to a set of value using 'enumeration' -->
        <xsd:restriction base = "xsd:string">
            <xsd:enumeration value = "MyOwn"/>
            <xsd:enumeration value = "Amazon"/>
        </xsd:restriction>
    </xsd:simpleType>

    <xsd:simpleType name="statusType">
        <!-- Restricting the values to a set of value using 'enumeration' -->
        <xsd:restriction base = "xsd:string">
            <xsd:enumeration value = "UP"/>
            <xsd:enumeration value = "DOWN"/>
            <xsd:enumeration value = "STARTING"/>
            <xsd:enumeration value = "OUT_OF_SERVICE"/>
            <xsd:enumeration value = "UNKNOWN"/>
        </xsd:restriction>
    </xsd:simpleType>

    <xsd:complexType name="amazonMetdataType">
        <!-- From <a class="jive-link-external-small" href="http://docs.amazonwebservices.com/AWSEC2/latest/DeveloperGuide/index.html?AESDG-chapter-instancedata.html" target="_blank">http://docs.amazonwebservices.com/AWSEC2/latest/DeveloperGuide/index.html?AESDG-chapter-instancedata.html</a> -->
        <xsd:all>
            <xsd:element name="ami-launch-index" type="xsd:string" />
            <xsd:element name="local-hostname" type="xsd:string" />
            <xsd:element name="availability-zone" type="xsd:string" />
            <xsd:element name="instance-id" type="xsd:string" />
            <xsd:element name="public-ipv4" type="xsd:string" />
            <xsd:element name="public-hostname" type="xsd:string" />
            <xsd:element name="ami-manifest-path" type="xsd:string" />
            <xsd:element name="local-ipv4" type="xsd:string" />
            <xsd:element name="hostname" type="xsd:string"/>       
            <xsd:element name="ami-id" type="xsd:string" />
            <xsd:element name="instance-type" type="xsd:string" />
        </xsd:all>
    </xsd:complexType>

    <xsd:complexType name="appMetadataType">
        <xsd:sequence>
            <!-- this is optional application specific name, value metadata -->
            <xsd:any minOccurs="0" maxOccurs="unbounded" processContents="skip"/>
        </xsd:sequence>
    </xsd:complexType>
</xsd:schema>

我们本章先来使用之前章节SpringCloud组件：将微服务提供者注册到Eureka服务中心源码进行自动注册服务，在之后的章节内我们再来细讲具体怎么通过符合以上XSD主体内容的XML/JSON手动注册。

在下面我们来看下通过REST来维护服务实例，在这之前我们需要通过以下步骤进行启动服务，为后续REST请求维护服务实例提供环境：

  1. 启动Eureka Server，源码查看SpringCloud组件：搭建Eureka服务注册中心
  2. 启动Eureka Client，源码查看SpringCloud组件：将微服务提供者注册到Eureka服务中心
服务状态变更

我们可以直接修改服务实例的运行状态，比如服务关闭，会从UP转换为DOWN，我们通过curl命令来测试服务的状态变更，如下所示：

curl -v -X PUT http://localhost:10000/eureka/apps/HENGBOY-SPRING-CLOUD-EUREKA-PROVIDER/hengboy-spring-cloud-eureka-provider:20000:v1.0/status\?value\=DOWN

其中参数HENGBOY-SPRING-CLOUD-EUREKA-PROVIDER为appID，hengboy-spring-cloud-eureka-provider:20000:v1.0为instanceID。
执行完成后可以打开Eureka Server管理平台查看服务实例列表查看服务状态，如下图所示：

4461954-4bbe36df0cc19528.png
服务状态变更

服务的状态已经由原本的UP改为了DOWN。

服务基本信息获取

Eureka提供获取指定appID以及instanceID的详细信息，可以详细的返回服务实例的配置内容，获取信息的命令如下：

curl http://localhost:10000/eureka/apps/HENGBOY-SPRING-CLOUD-EUREKA-PROVIDER/hengboy-spring-cloud-eureka-provider:20000:v1.0

执行命令返回值的格式化如下所示：

<instance>
  <instanceId>hengboy-spring-cloud-eureka-provider:20000:v1.0</instanceId>
  <hostName>192.168.1.75</hostName>
  <app>HENGBOY-SPRING-CLOUD-EUREKA-PROVIDER</app>
  <ipAddr>192.168.1.75</ipAddr>
  <status>UP</status>
  <overriddenstatus>UNKNOWN</overriddenstatus>
  <port enabled="true">20000</port>
  <securePort enabled="false">443</securePort>
  <countryId>1</countryId>
  <dataCenterInfo class="com.netflix.appinfo.InstanceInfo$DefaultDataCenterInfo">
    <name>MyOwn</name>
  </dataCenterInfo>
  <leaseInfo>
    <renewalIntervalInSecs>30</renewalIntervalInSecs>
    <durationInSecs>90</durationInSecs>
    <registrationTimestamp>1539223540390</registrationTimestamp>
    <lastRenewalTimestamp>1539229835439</lastRenewalTimestamp>
    <evictionTimestamp>0</evictionTimestamp>
    <serviceUpTimestamp>1539223539774</serviceUpTimestamp>
  </leaseInfo>
  <metadata>
    <management.port>20000</management.port>
    <jmx.port>54581</jmx.port>
  </metadata>
  <homePageUrl>http://192.168.1.75:20000/</homePageUrl>
  <statusPageUrl>http://192.168.1.75:20000/actuator/info</statusPageUrl>
  <healthCheckUrl>http://192.168.1.75:20000/actuator/health</healthCheckUrl>
  <vipAddress>hengboy-spring-cloud-eureka-provider</vipAddress>
  <secureVipAddress>hengboy-spring-cloud-eureka-provider</secureVipAddress>
  <isCoordinatingDiscoveryServer>false</isCoordinatingDiscoveryServer>
  <lastUpdatedTimestamp>1539223540390</lastUpdatedTimestamp>
  <lastDirtyTimestamp>1539223539732</lastDirtyTimestamp>
  <actionType>ADDED</actionType>
</instance>

返回值的比较详细，如需选择使用。

服务剔除

当然我们同样可以主动将服务从Eureka剔除，剔除后会直接从服务实例列表中删除，可执行如下命令：

curl -v -X DELETE localhost:10000/eureka/apps/HENGBOY-SPRING-CLOUD-EUREKA-PROVIDER/hengboy-spring-cloud-eureka-provider:20000:v1.0

注意：由于Eureka Client一直在运行，删除后也会自动通过注册服务的REST注册实例。

总结

本章讲解了怎么通过主动以及自动同步的方式将Eureka Client注册到服务注册中心集群环境中，为了保证完整性，还是建议手动进行配置，自动同步也有不成功的情况存在。

源码位置

有问题要问？

如果你有技术相关的问题想要咨询恒宇少年，请去博客首页左侧导航栏，点击知识星球微信扫码加入我的星球。

与恒宇少年面对面

如果你喜欢恒宇少年的相关文章，那么就去微信公众号（恒宇少年）关注我吧！！！
当然你也可以去 SpringCloud码云源码 项目底部扫描微信公众号二维码关注我，感谢阅读！！！

学习目录推荐

开源信息

这段时间一直在编写开源的相关框架，致力于公司使用的框架升级以及开源计划，将公司使用到的工具以及插件进行升级重构并且开源。

恒宇少年
关注
Eureka（06-入门）Server Rest API汇总
老瓜农
06-27 435
Eureka Server Rest API 汇总 接口名称 接口URI 备注 查询所有服务 GET /eureka/apps 成功返回200，支持json、xml格式 查询指定服务 GET /eureka/apps/{appID} 成功返回200，支持json、xml格式 查询指定appID和instanceID的实例 GET /eureka/apps/{appID}/instanceID} ..
SpringCloud核心组件之一 Eureka快速入门
H445584704的博客
07-05 742
Eureka是Netflix开发的服务发现框架，本身是一个基于REST的服务，主要用于定位运行在AWS域中的中间层服务，以达到负载均衡和中间层服务故障转移的目的。 SpringCloud将它集成在其子项目spring-cloud-netflix中，以实现SpringCloud的服务发现功能。Eureka包含两个组件：Eureka Server和Eureka Client。Eureka Server提供服务注册服务，各个节点启动后，会在Eureka Server中进行注册，这样EurekaSer
eureka双节点实例
06-10
该压缩包内含有eureka注册中心，生产者和消费者demo，解压后请先查看根目录下的README.md，有助于使用。
Eureka Server的REST端点
实践求真知
06-12 2157
Eureka Server提供了一些REST端点。非JVM的微服务可使用这些REST端点操作Eureka，从而实现注册和发现。事实上，Eureka Client就是一个使用Java编写的、操作这些REST端点的类库。也可分析这些REST端点，编写其他语言的Eureka Client。Eureka提供的REST端点，可以使用XML或者JSON与这些端点通信，默认是XML。一 Eureka的REST端...
SpringCloud注册中心Eureka详解（核心概念、工作流程、自我保护机制）
tc979907461的博客
08-05 1270
Eureka 工作原理 上节内容为大家介绍了，注册中心 Eureka 产品的使用，以及如何利用 Eureka 搭建单台和集群的注册中心。这节课我们来继续学习 Eureka，了解它的相关概念、工作流程机制等。 Eureka 作为 Spring Cl...
SpringCloud基础篇-03-服务注册中心-Eureka
Alan0517
01-20 500
Eureka是Netflix开发的服务发现框架，本身是一个基于REST的服务，主要用于定位运行在AWS域中的中间层服务，以达到负载均衡和中间层服务故障转移的目的。SpringCloud将它集成在其子项目spring-cloud-netflix中，以实现SpringCloud的服务发现功能。
springcloud注册中心Eureka集群示例代码.zip
03-14
服务提供者（如 springcloud-member 和 springcloud-order）向 Eureka 注册自己的服务，而服务消费者则可以通过 Eureka 获取到可用的服务实例列表进行调用。 1. **Eureka 集群搭建**： 在这个示例中，我们有 `...
springCloud项目-内含eureka注册中心和一个服务
12-11
在Spring Cloud中，Eureka是核心组件之一，它扮演着服务注册与发现的角色。Eureka Server作为一个服务注册中心，各服务启动后会在Eureka Server上进行注册，这样其他服务就可以通过Eureka找到所有的服务。 项目包含...
SpringCloud Netflix---Eureka服务注册
I_am_fine_的博客
04-19 501
Eureka原理以及简单使用
SpringCloud学习：Eureka、Feign（含示例代码）
Nero__A的博客
03-24 1万+
一、Spring Cloud Netflix简介 SpringCloud是一个基于SpringBoot实现的云应用开发工具，它为基于JVM的云应用开发中的配置故那里、服务发现、断路器、智能路由、微代理、控制总线、全局锁、决策竞选、分布式会话和集群状态管理等操作提供了简单的开发方式。 SpringCloud下包含了多个工程，其中的Spring Cloud Netflix提供了一系列搭建微
eureka使用总结
许诗宇的博客
05-25 3269
目录 Eureka常用配置 Eureka 单节点搭建 eureka多节点 服务注册的配置选项 Eureka单独使用 Rest服务调用 /eureka/status 服务状态 注册到eureka的服务信息查看 注册到eureka的具体的服务查看 服务续约 更改服务状态 删除状态更新 删除服务 元数据 EurekaClient 多网卡选择 Eureka 健康检查 安全配置 Eureka常用配置 服务端配置 eureka: instance: hostn...
SpringCloud(一)：Eureka服务注册与发现
最新发布
SuperDingpang的博客
11-02 567
Eureka快速开始及常用配置
springcloud获取注册中心服务列表
cherrish_1991的专栏
03-19 1910
@Autowired private DiscoveryClient discoveryClient; List<String> services = discoveryClient.getServices(); log.info("Services: {}", services); if(CollectionUtils.isNotEmpty(services)){ for(String service : services){ List<ServiceInsta
一、Eureka
Jack方
01-12 1938
Eureka
Spring Cloud Eureka 全解 （1） - 总览篇
热门推荐
hashcon
11-15 4万+
本文基于SpringCloud-Dalston.SR5 Eureka作为服务注册中心对整个微服务架构起着最核心的整合作用，因此对Eureka还是有很大的必要进行深入研究。 Eureka 1.x版本是纯基于servlet的应用。为了与spring cloud结合使用，除了本身eureka代码，还有个粘合模块spring-cloud-netflix-eureka-server。在我们启动Eurek
SpringBoot引用Eureka导致返回结果由json变为xml解决方案
一天一小步，梦想一大步
10-30 3213
  在学习SpringCloud的时候，项目集成了Eureka时，无论使用@RestController还是@Controller + @ResponseBody返回的数据都是xml形式的数据，不是我们想要的json格式的数据，如下图: 原因 在我的SpringBoot项目中集成了EurekaServer，又需要jackson-dataformat-xml这个依赖   它可以将实体...
Eureka源码-3-服务发现（查询服务列表）
weixin_41300437的博客
12-11 1473
码-3-服务如何查询
细说Spring cloud ——eureka 的几种主动下线服务的方式
sinat_25596967的博客
05-07 3万+
本文会介绍几种eureka 注册中心服务下线的方式1. 直接停掉服务。默认情况下，如果Eureka Server在90秒没有收到Eureka客户的续约，它会将实例从其注册表中删除。但这种做法的不好之处在于， 客户端已经停止了运行，但仍然在注册中心的列表中。 虽然通过一定的负载均衡策略或使用熔断器可以让服务正常进行，但有没有方法让注册中心马上知道服务已经下线呢？ 2.为了让注册中心马上知道服务要下线...
Eureka注册服务列表显示ip+端口
Lovnx
05-01 2万+
Eureka服务注册列表默认是显示主机名+端口，要想更方便地知道是哪台主机就需要查看ip+端口。client端配置：eureka: instance: preferIpAddress: true instance-id: ${spring.cloud.client.ipAddress}:${server.port}效果：
SpringCloud实战：Eureka服务注册与发现详解
"本文将详细介绍如何使用Spring Cloud Eureka构建服务注册中心，以及Eureka在Spring Cloud生态中的重要地位和作用。" Spring Cloud Eureka是Netflix公司开源的一个服务注册与发现的组件，它在Spring Cloud框架中...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值