如需转载,请根据 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 许可,附上本文作者及链接。
本文作者: 执笔成念
作者昵称: zbcn
本文链接: https://1363653611.github.io/zbcn.github.io/2021/01/02/springcloud-02eureka/
springcloud eureka 服务注册与发现
Spring Cloud Eureka是Spring Cloud Netflix 子项目的核心组件之一,主要用于微服务架构中的服务治理。 本文将对搭建Eureka注册中心,搭建Eureka客户端,搭建Eureka集群及给Eureka注册中心添加登录认证进行介绍。
Eureka 简介
在微服务架构中往往会有一个注册中心,每个微服务都会向注册中心去注册自己的地址及端口信息,注册中心维护着服务名称与服务实例的对应关系。每个微服务都会定时从注册中心获取服务列表,同时汇报自己的运行情况,这样当有的服务需要调用其他服务时,就可以从自己获取到的服务列表中获取实例地址进行调用,Eureka实现了这套服务注册与发现机制。
搭建 Eureka 注册中心
使用 idea 来创建springcloud 应用
- 创建一个eureka-server模块,并使用Spring Initializer初始化一个SpringBoot项目
填写应用信息
选择你需要的springcloud组件进行创建
- 创建完成后会发现pom.xml文件中已经有了eureka-server的依赖
1 | <dependency> |
2 | <groupId>org.springframework.cloud</groupId> |
3 | <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId> |
4 | </dependency> |
- 在启动类上添加@EnableEurekaServer注解来启用Euerka注册中心功能
1 |
|
2 |
|
3 | public class EurekaServerApplication { |
4 | |
5 | public static void main(String[] args) { |
6 | SpringApplication.run(EurekaServerApplication.class, args); |
7 | } |
8 | |
9 | } |
- 在配置文件application.yml中添加Eureka注册中心的配置
1 | server: |
2 | port: 8001 #指定运行端口 |
3 | spring: |
4 | application: |
5 | name: eureka-server #指定服务名称 |
6 | eureka: |
7 | instance: |
8 | hostname: localhost #指定主机地址 |
9 | client: |
10 | fetch-registry: false #指定是否要从注册中心获取服务(注册中心不需要开启) |
11 | register-with-eureka: false #指定是否要注册到注册中心(注册中心不需要开启) |
12 | server: |
13 | enable-self-preservation: false #关闭保护模式 |
然后可以启动服务
http://localhost:8000/
搭建Eureka 客户端
- 新建一个eureka-client模块,并在pom.xml中添加如下依赖
1 | <dependency> |
2 | <groupId>org.springframework.cloud</groupId> |
3 | <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> |
4 | </dependency> |
5 | |
6 | <dependency> |
7 | <groupId>org.springframework.boot</groupId> |
8 | <artifactId>spring-boot-starter-web</artifactId> |
9 | </dependency> |
- 在启动类上添加@EnableDiscoveryClient注解表明是一个Eureka客户端
1 | server: |
2 | port: 8101 #运行端口号 |
3 | spring: |
4 | application: |
5 | name: eureka-client #服务名称 |
6 | eureka: |
7 | client: |
8 | register-with-eureka: true #注册到Eureka的注册中心 |
9 | fetch-registry: true #获取注册实例列表 |
10 | service-url: |
11 | defaultZone: http://localhost:8001/eureka/ #配置注册中心地址 |
- 运行客户端
- 在 eureka 的服务端页面,可以看到注册的 客户端
搭建Eureka注册中心集群
搭建两个注册中心
由于所有服务都会注册到注册中心去,服务之间的调用都是通过从注册中心获取的服务列表来调用,注册中心一旦宕机,所有服务调用都会出现问题。所以我们需要多个注册中心组成集群来提供服务,下面将搭建一个双节点的注册中心集群。
- 给eureka-sever添加配置文件application-replica1.yml配置第一个注册中心
1 | server: |
2 | port: 8002 |
3 | spring: |
4 | application: |
5 | name: eureka-server |
6 | eureka: |
7 | instance: |
8 | hostname: replica1 |
9 | client: |
10 | serviceUrl: |
11 | defaultZone: http://replica2:8003/eureka/ #注册到另一个Eureka注册中心 |
12 | fetch-registry: true |
13 | register-with-eureka: true |
- 给eureka-sever添加配置文件application-replica2.yml配置第二个注册中心
1 | server: |
2 | port: 8003 |
3 | spring: |
4 | application: |
5 | name: eureka-server |
6 | eureka: |
7 | instance: |
8 | hostname: replica2 |
9 | client: |
10 | serviceUrl: |
11 | defaultZone: http://replica1:8002/eureka/ #注册到另一个Eureka注册中心 |
12 | fetch-registry: true |
13 | register-with-eureka: true |
这里我们通过两个注册中心互相注册,搭建了注册中心的双节点集群,由于defaultZone使用了域名,所以还需在本机的host文件中配置一下。
- 修改本地host文件
1 | 127.0.0.1 replica1 |
2 | 127.0.0.1 replica2 |
运行eureka 注册中心集群
在IDEA中我们可以通过使用不同的配置文件来启动同一个SpringBoot应用。
- 添加两个配置,分别以application-replica1.yml和application-replica2.yml来启动eureka-server
从原启动配置中复制一个出来
配置启动的配置文件
- 启动两个eureka-server,访问其中一个注册中心http://replica1:8002/发现另一个已经成为其备份
- 修改Eureka-client,让其连接到集群
添加eureka-client的配置文件application-replica.yml,让其同时注册到两个注册中心。
1 | server: |
2 | port: 8102 |
3 | spring: |
4 | application: |
5 | name: eureka-client |
6 | eureka: |
7 | client: |
8 | register-with-eureka: true |
9 | fetch-registry: true |
10 | service-url: |
11 | defaultZone: http://replica1:8002/eureka/,http://replica2:8003/eureka/ #同时注册到两个注册中心 |
- 以该配置文件启动后访问任意一个注册中心节点都可以看到eureka-client
给eureka 注册中心添加认证
创建一个 eureka-security-server 模块,在pom.xml 文件中添加以下依赖
- 需要添加SpringSecurity模块。
1 | <dependency> |
2 | <groupId>org.springframework.cloud</groupId> |
3 | <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId> |
4 | </dependency> |
5 | |
6 | <dependency> |
7 | <groupId>org.springframework.boot</groupId> |
8 | <artifactId>spring-boot-starter-security</artifactId> |
9 | </dependency> |
添加 application.yml 配置文件
主要是配置了登录注册中心的用户名和密码。
1 | server: |
2 | port: 8004 |
3 | spring: |
4 | application: |
5 | name: eureka-security-server |
6 | security: #配置SpringSecurity登录用户名和密码 |
7 | user: |
8 | name: zbcn |
9 | password: 123456 |
10 | eureka: |
11 | instance: |
12 | hostname: localhost |
13 | client: |
14 | fetch-registry: false |
15 | register-with-eureka: false |
添加Java 配置WebSecurityConfig
默认情况下添加SpringSecurity依赖的应用每个请求都需要添加CSRF token才能访问,Eureka客户端注册时并不会添加,所以需要配置/eureka/**路径不需要CSRF token。
1 |
|
2 | public class WebSecurityConfig extends WebSecurityConfigurerAdapter { |
3 | |
4 | |
5 | protected void configure(HttpSecurity http) throws Exception { |
6 | http.csrf().ignoringAntMatchers("/eureka/**"); |
7 | super.configure(http); |
8 | } |
9 | } |
运行Eureka-Security-Server ,访问 http://localhost:8084 发现需要登录
eureka-client注册到有登录认证的注册中心
- 配置文件中需要修改注册中心地址格式
1 | http://${username}:${password}@${hostname}:${port}/eureka/ |
- 添加application-security.yml配置文件,按格式修改用户名和密码
1 | server: |
2 | port: 8103 |
3 | spring: |
4 | application: |
5 | name: eureka-client |
6 | eureka: |
7 | client: |
8 | register-with-eureka: true |
9 | fetch-registry: true |
10 | service-url: |
11 | defaultZone: http://zbcn:123456@localhost:8004/eureka/ |
- 以application-security.yml配置运行eureka-client,可以在注册中心界面看到eureka-client已经成功注册
eureka 常用配置
1 | eureka: |
2 | client: #eureka客户端配置 |
3 | register-with-eureka: true #是否将自己注册到eureka服务端上去 |
4 | fetch-registry: true #是否获取eureka服务端上注册的服务列表 |
5 | service-url: |
6 | defaultZone: http://localhost:8001/eureka/ # 指定注册中心地址 |
7 | enabled: true # 启用eureka客户端 |
8 | registry-fetch-interval-seconds: 30 #定义去eureka服务端获取服务列表的时间间隔 |
9 | instance: #eureka客户端实例配置 |
10 | lease-renewal-interval-in-seconds: 30 #定义服务多久去注册中心续约 |
11 | lease-expiration-duration-in-seconds: 90 #定义服务多久不去续约认为服务失效 |
12 | metadata-map: |
13 | zone: jiangsu #所在区域 |
14 | hostname: localhost #服务主机名称 |
15 | prefer-ip-address: false #是否优先使用ip来作为主机名 |
16 | server: #eureka服务端配置 |
17 | enable-self-preservation: false #关闭eureka服务端的保护机制 |
使用到的模块
1 | ZBCN-SERVER |
2 | ├── zbcn-register/eureka-server -- eureka注册中心 |
3 | ├── zbcn-register/eureka-security-server -- 带登录认证的eureka注册中心 |
4 | └── zbcn-business/zbcn-demo-server -- eureka客户端 |