史上最简单的 SpringCloud 教程 | 第一篇：服务的注册与发现Eureka(Finchley版本)

比眉伴天荒 2022-04-05 11:52 177阅读 0赞

所属专栏： [史上最简单的 Spring Cloud 教程][Spring Cloud]

> 转载请标明出处：  
> 原文首发于：[https://www.fangzhipeng.com/springcloud/2018/08/30/sc-f1-eureka/][https_www.fangzhipeng.com_springcloud_2018_08_30_sc-f1-eureka]  
> 本文出自[方志朋的博客][Link 1]

### 一、spring cloud简介 ###

鉴于《史上最简单的Spring Cloud教程》很受读者欢迎，再次我特意升级了一下版本，目前支持的版本为Spring Boot版本2.0.3.RELEASE,Spring Cloud版本为Finchley.RELEASE。

Finchley版本的官方文档如下：  
[http://cloud.spring.io/spring-cloud-static/Finchley.RELEASE/single/spring-cloud.html][http_cloud.spring.io_spring-cloud-static_Finchley.RELEASE_single_spring-cloud.html]

spring cloud 为开发人员提供了快速构建分布式系统的一些工具，包括配置管理、服务发现、断路器、路由、微代理、事件总线、全局锁、决策竞选、分布式会话等等。它运行环境简单，可以在开发人员的电脑上跑。另外说明spring cloud是基于springboot的，所以需要开发中对springboot有一定的了解，如果不了解的话可以看这篇文章：[2小时学会springboot][2_springboot]。另外对于“微服务架构” 不了解的话，可以通过搜索引擎搜索“微服务架构”了解下。

### 二、创建服务注册中心 ###

在这里，我还是采用Eureka作为服务注册与发现的组件，至于Consul 之后会出文章详细介绍。

**2.1 首先创建一个maven主工程。**

首先创建一个主Maven工程，在其pom文件引入依赖，spring Boot版本为2.0.3.RELEASE，Spring Cloud版本为Finchley.RELEASE。这个pom文件作为父pom文件，起到依赖版本控制的作用，其他module工程继承该pom。这一系列文章全部采用这种模式，其他文章的pom跟这个pom一样。再次说明一下，以后不再重复引入。代码如下：

<?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">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>com.forezp</groupId>
        <artifactId>sc-f-chapter1</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <packaging>pom</packaging>
    
        <name>sc-f-chapter1</name>
        <description>Demo project for Spring Boot</description>
    
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.0.3.RELEASE</version>
            <relativePath/>
        </parent>
    
        <modules>
            <module>eureka-server</module>
            <module>service-hi</module>
        </modules>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
            <java.version>1.8</java.version>
            <spring-cloud.version>Finchley.RELEASE</spring-cloud.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
        </dependencies>
    
        <dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.cloud</groupId>
                    <artifactId>spring-cloud-dependencies</artifactId>
                    <version>${spring-cloud.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    
    </project>

\*\*2.2 然后创建2个model工程:\*\*一个model工程作为服务注册中心，即Eureka Server,另一个作为Eureka Client。

下面以创建server为例子，详细说明创建过程：

右键工程->创建model-> 选择spring initialir 如下图：

![Paste\_Image.png][Paste_Image.png]

下一步->选择cloud discovery->eureka server ,然后一直下一步就行了。

![Paste\_Image.png][Paste_Image.png 1]

创建完后的工程，其pom.xml继承了父pom文件，并引入spring-cloud-starter-netflix-eureka-server的依赖，代码如下：

**2.3 启动一个服务注册中心**，只需要一个注解@EnableEurekaServer，这个注解需要在springboot工程的启动application类上加：

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

\*\*2.4 \*\*eureka是一个高可用的组件，它没有后端缓存，每一个实例注册之后需要向注册中心发送心跳（因此可以在内存中完成），在默认情况下erureka server也是一个eureka client ,必须要指定一个 server。eureka server的配置文件appication.yml：

server:
      port: 8761
    
    eureka:
      instance:
        hostname: localhost
      client:
        register-with-eureka: false
        fetch-registry: false
        service-url:
          defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
      server:
        enable-self-preservation: false
    
    spring:
      application:
        name: eureka-server

通过eureka.client.register-with-eureka：false和fetch-registry：false来表明自己是一个eureka server.

**2.5** eureka server 是有界面的，启动工程,打开浏览器访问：  
[http://localhost:8761][http_localhost_8761] ,界面如下：

![Paste\_Image.png][Paste_Image.png 2]

> No application available 没有服务被发现 ……\_  
> 因为没有注册服务当然不可能有服务被发现了。

### 三、创建一个服务提供者 (eureka client) ###

当client向server注册时，它会提供一些元数据，例如主机和端口，URL，主页等。Eureka server 从每个client实例接收心跳消息。 如果心跳超时，则通常将该实例从注册server中删除。

创建过程同server类似,创建完pom.xml如下：

通过注解@EnableEurekaClient 表明自己是一个eurekaclient.

@SpringBootApplication
    @EnableEurekaClient
    @RestController
    public class ServiceHiApplication {
    
        public static void main(String[] args) {
            SpringApplication.run( ServiceHiApplication.class, args );
        }
    
        @Value("${server.port}")
        String port;
    
        @RequestMapping("/hi")
        public String home(@RequestParam(value = "name", defaultValue = "forezp") String name) {
            return "hi " + name + " ,i am from port:" + port;
        }
    
    }

仅仅@EnableEurekaClient是不够的，还需要在配置文件中注明自己的服务注册中心的地址，application.yml配置文件如下：

server:
      port: 8762
    
    spring:
      application:
        name: service-hi
    
    eureka:
      client:
        serviceUrl:
          defaultZone: http://localhost:8761/eureka/

[需要指明spring.application.name][spring.application.name],这个很重要，这在以后的服务与服务之间相互调用一般都是根据这个name 。  
启动工程，打开http://localhost:8761 ，即eureka server 的网址：

![Paste\_Image.png][Paste_Image.png 3]

你会发现一个服务已经注册在服务中了，服务名为SERVICE-HI ,端口为8762

这时打开 [http://localhost:8762/hi?name=forezp][http_localhost_8762_hi_name_forezp] ，你会在浏览器上看到 :

> hi forezp,i am from port:8762

[https://github.com/forezp/SpringCloudLearning/tree/master/sc-f-chapter1][https_github.com_forezp_SpringCloudLearning_tree_master_sc-f-chapter1]

[Spring Cloud]: https://blog.csdn.net/column/details/15197.html
[https_www.fangzhipeng.com_springcloud_2018_08_30_sc-f1-eureka]: https://www.fangzhipeng.com/springcloud/2018/08/30/sc-f1-eureka/
[Link 1]: https://www.fangzhipeng.com
[http_cloud.spring.io_spring-cloud-static_Finchley.RELEASE_single_spring-cloud.html]: http://cloud.spring.io/spring-cloud-static/Finchley.RELEASE/single/spring-cloud.html
[2_springboot]: http://blog.csdn.net/forezp/article/details/61472783
[Paste_Image.png]: /images/20220405/a89d6cb87e02401e904ac7f4b1a9684f.png
[Paste_Image.png 1]: /images/20220405/02caff82e8394e2fa4892efc9f268351.png
[http_localhost_8761]: http://localhost:8761
[Paste_Image.png 2]: /images/20220405/a7745b1f355d455cae172ff7066fc610.png
[spring.application.name]: http://xn--spring-ve8l53rst3geh2a.application.name
[Paste_Image.png 3]: /images/20220405/f3bd5e4f44954d8cbf45c3a995aa60fe.png
[http_localhost_8762_hi_name_forezp]: http://localhost:8762/hi?name=forezp
[https_github.com_forezp_SpringCloudLearning_tree_master_sc-f-chapter1]: https://github.com/forezp/SpringCloudLearning/tree/master/sc-f-chapter1