Spring Cloud Eureka 服务注册中心怎么配置

「Spring Cloud Eureka 入门系列」
Spring Cloud Eureka 入门 (一)服务注册中心详解
Spring Cloud Eureka 入门 (二)服务提供者详解
Spring Cloud Eureka 入门 (三)服务消费者详解

本文提纲

  1. Eureka 服务治理
    1.1 什么是 Eureka
    1.2 Eureka 集群架构
  2. 运行 Eureka 工程 springcloud-eureka-server
  3. 详解 Eureka 工程 springcloud-eureka-server

一、Eureka 服务治理

1.1 什么是 Eureka

Eureka,这里是 Spring Cloud Eureka 的简称,是 Spring Cloud Netflix 组件之一。Spring Cloud Netflix 中核心的组件包括了服务治理(Eureka),服务容断(Hystrix),路由(Zuul)和客户端负载均衡(Ribbon)。在系列第三篇,服务消费者讲解会涉及到 Ribbon 的使用。

回到 Spring Cloud Eureka,是基于 Netflix Eureka (Netflix 是 Java 实现的开源软件)。服务治理(Eureka)包括服务注册、服务发现和服务检测监控等,自然本文介绍下 Eureka 作为服务注册中心。

1.2 Eureka 架构

Eureka 作为服务治理,必然满足下面几点:

  • 服务本身不存在单点故障,
  • 支持集群,即高可用性
  • 服务与服务之间通过服务注册中心找到彼此实例

作为服务端(即服务注册中心),包括

  • 管理服务实例
  • 提供服务注册或下线
  • 提供服务发现
  • 提供服务注册表至两类客户端(即服务提供者和消费者)

作为客户端(即服务提供者和消费者),包括

  • 连接服务注册中心
  • 向服务注册中心注册或者下线服务实例
  • 向服务注册中心或服务注册缓存列表查询服务

二、运行 Eureka 工程 springcloud-eureka-server

运行环境:JDK 7 或 8,Maven 3.0+
技术栈:Spring Cloud Dalston.SR1、 spring-cloud-netflix 1.3.1、Spring Boot 1.5.4

  1. git clone 下载工程 springcloud-learning-example
    项目地址见 GitHub - https://github.com/JeffLi1993/springcloud-learning-example
    git clone https://github.com/JeffLi1993/springcloud-learning-example.git

  2. Maven 编译安装这个工程:
    cd springcloud-learning-example
    mvn clean install

  3. 运行 springcloud-eureka-server Eureka 工程

右键 Main 函数 Run Eureka Server 启动类 EurekaServerApplication,启动服务注册中心工程。
EurekaServerApplication 类地址:/springcloud-learning-example/springcloud-eureka-sample/springcloud-eureka-server/src/main/java/org/spring/springboot/EurekaServerApplication.java

控制台 Console 看到这类信息,代表启动成功:

2017-06-30 10:32:47.549  INFO 2977 --- [      Thread-11] e.s.EurekaServerInitializerConfiguration : Started Eureka Server
2017-06-30 10:32:47.625  INFO 2977 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8888 (http)
2017-06-30 10:32:47.626  INFO 2977 --- [           main] .s.c.n.e.s.EurekaAutoServiceRegistration : Updating port to 8888
2017-06-30 10:32:47.632  INFO 2977 --- [           main] o.s.springboot.EurekaServerApplication   : Started EurekaServerApplication in 23.168 seconds
  1. 访问 Eureka 注册中心可视化界面
    打开浏览器,访问 http://localhost:8888/

可以看到主体信息包括:

  • 系统状态:环境、运行时间、更新时间等
  • 注册信息:服务名、服务地址、服务状态
  • 基本信息:环境、内存、副本信息
  • 实例信息:IP、端口

三、详解 Eureka 工程 springcloud-eureka-server

1.springcloud-eureka-server 工程目录结构

├── pom.xml
└── src
    └── main
        ├── java
        │   └── org
        │       └── spring
        │           └── springcloud
        │               ├── EurekaServerApplication.java
        └── resources
            └── application.yml

EurekaServerApplication.java Eureka Server 启动类
application.yml 配置文件

  1. pom.xml 配置
<?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>springcloud</groupId>
    <artifactId>springcloud-eureka-server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>springcloud-eureka-server :: Spring Cloud Eureka 服务注册中心</name>

    <!-- Spring Boot 启动父依赖 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.4.RELEASE</version>
    </parent>

    <dependencies>
        <!-- Spring Cloud Netflix Eureka Server 依赖 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka-server</artifactId>
        </dependency>

        <!-- Spring Boot Test 依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <!-- Spring Cloud Netflix 依赖 -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-netflix</artifactId>
                <version>1.3.1.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

使用的依赖是

  • spring-cloud-netflix 1.3.1 是 Spring Cloud Dalston.SR1 版本。
  • spring-cloud-starter-eureka-server Eureka Server 模块依赖

上面提到的客户端负载均衡 Ribbon ,可以依赖树中看出 spring-cloud-starter-eureka-server 依赖了 Ribbon 相关的库。因为一般 eureka 本身作为服务自注册实现高可用,也可以作为客户端调用其他服务。

  1. application.yml 配置
server:
  port: 8888 # 服务端口

eureka:
  instance:
    hostname: localhost # 设置主机名
  client:
    registerWithEureka: false # 是否向 Eureka 注册服务。该应用为服务注册中心,不需要自注册,设置为 false
    fetchRegistry: false      # 是否检索服务。该应用为服务注册中心,职责为注册和发现服务,无需检索服务,设置为 false
  server:
    waitTimeInMsWhenSyncEmpty: 0 # 设置同步为空时的等待时间。默认 5 * MINUTES
  • server.port 设置工程服务端口
  • eureka.instance.hostname Eureka 实例主机名
  • eureka.client.registerWithEureka 是否向 Eureka 注册服务。服务注册中心服务,没有作为集群,所以不需要自注册,设置为 false
  • eureka.client.fetchRegistry 是否检索服务。该应用为服务注册中心,职责为注册和发现服务,无需检索服务,设置为 false
  • eureka.server.waitTimeInMsWhenSyncEmpty 设置同步为空时的等待时间。默认 5 * MINUTES

4.注册中心应用启动类

/**
 * Spring Boot Eureka Server 应用启动类
 *
 * Created by bysocket on 21/06/17.
 */
@EnableEurekaServer     // Eureka Server 标识
@SpringBootApplication  // Spring Boot 应用标识
public class EurekaServerApplication {

    public static void main(String[] args) {
        // 程序启动入口
        // 启动嵌入式的 Tomcat 并初始化 Spring 环境及其各 Spring 组件
        SpringApplication.run(EurekaServerApplication.class,args);
    }
}

@EnableEurekaServer 标志该应用作为 Eureka Server ,并会自动化读取相关配置。

四、小结

此小章节介绍了如何 Eureka 作为服务注册中心 Server,下一小结讲下 服务提供者详解 具体是如何向服务注册中心注册自己的。系列目录如下:

本文由博客群发一文多发等运营工具平台 OpenWrite 发布