Spring Cloud 学习教程——第一篇：服务注册与发现（Eureka）

一、 服务注册中心

使用 Spring Cloud Netflix Eureka 作为服务注册与发现模块。

1.1 创建一个 Maven 主工程（父工程）

首先创建一个主 Maven 工程，在其 pom.xml 文件引入依赖，Spring boot版本为2.0.3.RELEASE，Spring Cloud 版本为 Finchley.RELEASE。这个 pom.xml 文件作为父 pom.xml 文件，起到依赖版本控制的作用，减少新建项目时依赖不一致导致一些莫名其妙的错误，其他工程继承该父工程即可（类似与 JAVA 中的继承关系，子类继承父类后就拥有了父类所有的属性，这里叫做 Maven 父子项目，不了解的可以搜索学习一下）。接下来所有的 工程 全部采用这种模式，以后新建的 工程就不需要导入 Spring boot 与 Spring Cloud 本版了。步骤如下：

• IDEA首页面点击 create new project，弹出如下界面：

image

• 点击 next，如下图，GroupId（一般填反转后公司域名）和 ArtifactId（项目名）还有 Version，这三个属性目的是标识你的项目的唯一性：

image

• 点击 next，以下配置按需修改：

image

• 修改 pom.xml 文件，注意修改打包方式，或直接 copy 下面配置文件：

    4.0.0

    com.mengma-edu
    mengma-sc-demo
    1.0-SNAPSHOT
    
    pom

    mengma-sc-demo
    Spring Cloud 实例

    
        org.springframework.boot
        spring-boot-starter-parent
        2.0.3.RELEASE
        
    

    
        UTF-8
        UTF-8
        1.8
        Finchley.RELEASE
    

    
        
            org.springframework.boot
            spring-boot-starter-test
            test
        
    

    
        
            
                org.springframework.cloud
                spring-cloud-dependencies
                ${spring-cloud.version}
                pom
                import
            
        
    

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

• 删除 src 目录

  image

• 把包 父工程到 本地依赖中，以便接下来子模块可以依赖，IDEA中选中 右侧 Maven Projects如下：

image

1.2 创建 model 工程（子工程）：作为服务注册中心（Eureka server）

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

image

image

• image
• image

• 修改新建项目 pom.xml 文件让其与 父项目产生联系 （修改继承关系，删除多余依赖）

  

    4.0.0

    com.mengma-edu
    eureka_server
    0.0.1-SNAPSHOT
    jar

    eureka_server
    Spring Cloud eureka server 注册中心

    
    
        
        com.mengma-edu
        
        mengma-sc-demo
        
        1.0-SNAPSHOT
    

    
        
        
            org.springframework.cloud
            spring-cloud-starter-netflix-eureka-server
        

        
    

    

• 在父工程 pom.xml 中 添加子模块标识

 pom

    
    
        
        eureka_server
    

    mengma-sc-demo
     Spring Cloud 实例

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

@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {

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

1.4 Eureka是一个高可用的组件，它没有后端缓存，每一个实例注册之后需要向注册中心发送心跳，在默认情况下Eureka server也是一个Eureka client ,必须要指定一个Eureka server。Eureka server的配置文件appication.yml 如下：

# 本身是注册中心，但是也需要注册，这里可以向自己注册
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/
    # 不在页面上显示当前 服务
    register-with-eureka: false
    # 为true时，可以启动，但报异常：Cannot execute request on any known server
    fetch-registry: false
# 当应用上线率过低时，eureka会启动保护机制，默认确定当前服务是开启的，开发 环境中尽量关闭（设置为false）
  server:
    enable-self-preservation: false
# 服务名 ，很重要 ，后期 config 配置中心会以 服务名为标识找对应的 服务
spring:
  application:
    name: eureka
# 设置当前项目端口号
server:
  port: 8761

启动工程后，访问：http://localhost:8761/，可以看到下面的页面，其中还没有发现任何服务

二、服务提供者（Eureka client ）

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

• 创建 eureka client ，总体步骤一致，唯一不同在于选择依赖，如下：

image

image

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

@SpringBootApplication
@EnableEurekaClient
public class ServiceHiApplication {

    public static void main(String[] args) {
        SpringApplication.run( ServiceHiApplication.class, args );
    }
}

• 修改配置文件

# 注册到 eureka server 配置
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/
server:
  port: 8762
spring:
  application:
    name: eurekaclient

• 启动 eureka server , eureka client ，访问 eureka client 如下

image

• 关于 Spring Cloud Finchley.RELEASE 版本 Spring Cloud Eureka Client 重大改变说明，主启动类在此版本中，可以不用加 @EnableEurekaClient ，默认只要引入了 Eureka client 依赖，项目启动就会自动注册到注册中心，如下：

@SpringBootApplication
//@EnableEurekaClient  此版本中注释掉也是可以的 
public class EurekaClientApplication {

    public static void main(String[] args) {
        SpringApplication.run(EurekaClientApplication.class, args);
    }
}

2.1 后面所有项目均为 eureka client ，所以必须都要引入 eureka client 依赖，后期文档不再做特殊说明，请记得引入。