【SpringCloud 系列】Eureka 注册中心初体验

【SpringCloud 系列】Eureka 注册中心初体验

在 SpringCloud 微服务体系中，有几个比较重要的组件，如注册中心，配置中心，网关，安全、负载均衡、监控等等，接下来我们将来看一下这些常用的组件有什么用，在微服务架构下的该怎么用。

本文为为第一篇，注册中心 Eureka 的使用说明

I. 基本介绍

1. 注册中心

注册中心，主要的核心点是服务的注册与发现。

简单来讲，就是我们的所有服务都会在注册中心上标识自己，注册中心统一管理所有的服务名与具体的应用之间的映射关系，这样微服务之间的访问，就可以直接通过服务名来相互通信，相比较于直接通过 ip 端口的访问，这样的好处是当某个服务下线、新增或者换了机器，对调用者而言，只要维持一份注册中心的最新映射表即可，不需要其他任何改动逻辑。

我们通常可用的注册中心有 Eureka, Consul, Zookeeper, nacos等，在我们后续的教程中会逐一进行介绍

Eureka2.x 闭源，1.x 虽然可用，但新项目的话不建议再使用它，比如Consul, nacos 都是不错的选择

如果出于学习的目的，或者由于历史原因（比如我），学习了解一下 Eureka 知识点也没什么坏处

2. Eureka

Eureka 是 Netflix 开源的服务发现组件，本身是一个基于 REST 的服务，通常包含 Server 和 Client 端

原理如下图

server: 提供服务注册，并在服务注册表中存储所有可用服务节点的信息
client: 简化与 Server 之间的交互，比如封装了发送心跳，获取注册信息表等基本操作

II. 实例演示

1. 版本说明

后续的演示项目中，我们的环境与版本信息如下

开发环境: IDEA + maven
SpringBoot: 2.2.1.RELEASE
SpringCloud: Hoxton.M2

2. Eureka Server 端

Eureka 区分了 Server 和 Client 两端，即我们有一个独立的注册中心服务，其他的微服务则作为 Client 端

Server 端核心依赖如下

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>


<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>

然后在配置文件中，添加一些基本信息

server:
  port: 8081 #服务注册中心端口号
eureka:
  instance:
    hostname: 127.0.0.1 #服务注册中心IP地址
  client:
    registerWithEureka: false #是否向服务注册中心注册自己
    fetchRegistry: false #是否检索服务
    serviceUrl: #服务注册中心的配置内容，指定服务注册中心的位置
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

请注意，上面的registerWithEureka这个配置，设置为 false，不像自己注册服务（后续会介绍多个 Eureka 实例时，可以如何配置）

然后再启动类上，添加注解@EnableEurekaServer来申明 Eureka 服务

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

到此，一个 Eureka 服务端已经完成，此时我们可以直接访问http://localhost:8081，会看到一个自带的控制台，会提供一些基本信息

3. Eureka 客户端

我们这里设计两个客户端，一个提供服务，另外一个调用，演示一下 Eureka 的基本功能

a. 客户端 eureka-service-provider

客户端需要在 pom 文件中，添加下面的关键依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

接下来需要在配置文件中，指定注册中心的地址，以及服务名（请注意，这个服务名是重要线索，后面会用到！！！）

server:
  port: 8082 #服务端口号
eureka:
  client:
    serviceUrl: #注册中心的注册地址
      defaultZone: http://127.0.0.1:8081/eureka/
spring:
  application:
    name: eureka-service-provider #服务名称--调用的时候根据名称来调用该服务的方法

同样的需要在启动类上，通过@EnableEurekaClient来标注客户端

@EnableEurekaClient
@SpringBootApplication
public class Application {

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

我们在这个项目中，写一个基本 REST 接口，供后面的服务进行调用

@RestController
@RequestMapping(path = "userService")
public class UserService {
    @Override
    @RequestMapping(path = "/getUserById")
    public UserDTO getUserById(@RequestParam long userId) {
        UserDTO userDTO = new UserDTO();
        userDTO.setUserId(userId);
        userDTO.setNickname("一灰灰blog");
        userDTO.setUserName("yihuihuiblog");
        userDTO.setPhone(88888888L);
        return userDTO;
    }
}

再看一下上面的实现，你会发现和平时写的 Controller 没有任何的区别

到这里第一个 Eureka 客户端已经完成，并提供了一个 REST 接口，接下来我们开始写第二个 Eureka 客户端，用来访问上面的 REST 服务

b. 客户端 eureka-service-consumer

基本的流程和上面没有任何区别，只是将配置文件稍微改一下

server:
  port: 8083  #服务端口号
eureka:
  client:
    serviceUrl: #注册中心的注册地址
      defaultZone: http://127.0.0.1:8081/eureka/
spring:
  application:
    name: eureka-service-consumer #服务名称--调用的时候根据名称来调用该服务的方法

那么在这个服务中，如何访问 eureka-service-provider 提供的服务呢？

通过RestTemplate来实现

请注意，这个 RestTemplate 和我们普通的new RestTemplate()创建的不一样哦，我们是通过如下方式获取实例

@Bean
@LoadBalanced
public RestTemplate rest() {
    return new RestTemplate();
}

重点关注方法上的@LoadBalanced注解，这个会在后续的 Ribbon 的章节中深入介绍，在这里只需要知道通过它生成的RestTemplate，在发起访问时，会借助 Eureka 的注册信息表，将服务名翻译为对应的ip+端口号

接下来就是我们的访问环节，写法如下

@Autowired
private RestTemplate restTemplate;

@GetMapping(path = "uid")
public String getUser(int userId) {
    UserDTO dto = restTemplate
            .getForObject("http://eureka-service-provider/userService/getUserById?userId=" + userId, UserDTO.class);

    return userId + "'s info: " + dto;
}