Spring Cloud Eureka:服务注册与发现
Spring Cloud Eureka是Spring Cloud Netflix 子项目的核心组件之一,主要用于微服务架构中的服务治理。 本文将对搭建Eureka注册中心,搭建Eureka客户端,搭建Eureka集群及给Eureka注册中心添加登录认证进行介绍。
Eureka简介
在微服务架构中往往会有一个注册中心,每个微服务都会向注册中心去注册自己的地址及端口信息,注册中心维护着服务名称与服务实例的对应关系。每个微服务都会定时从注册中心获取服务列表,同时汇报自己的运行情况,这样当有的服务需要调用其他服务时,就可以从自己获取到的服务列表中获取实例地址进行调用,Eureka实现了这套服务注册与发现机制。
搭建Eureka注册中心
这里我们以创建并运行Eureka注册中心来看看在IDEA中创建并运行SpringCloud应用的正确姿势。
使用IDEA来创建SpringCloud应用
-创建一个eureka-server模块,并使用Spring Initializer初始化一个SpringBoot项目
- 填写应用信息
- 选择你需要的SpringCloud组件进行创建
- 创建完成后会发现pom.xml文件中已经有了eureka-server的依赖
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>
- 在启动类上添加@EnableEurekaServer注解来启用Euerka注册中心功能
@EnableEurekaServer
@SpringBootApplication
public class EurekaServerApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaServerApplication.class, args);
}
}
- 在配置文件application.yml中添加Eureka注册中心的配置
spring:
application:
name: eureka-server
server:
port: 8080
eureka:
instance:
hostname: localhost #指定主机地址
server:
enable-self-preservation: false #关闭保护模式
client:
# 默认情况下 eureka server 也是一个微服务,默认情况下会把自己注册到注册中心
# 这里设置为false 不需要注册,(集群情况会需要开启)
register-with-eureka: false
# 是否从eureka server 上获取注册信息 (集群需要开启)
fetch-registry: false
-
运行SpringCloud应用
-
运行完成后访问地址http://localhost:8001/可以看到Eureka注册中心的界面
搭建Eureka客户端
- 新建一个eureka-client模块,并在pom.xml中添加如下依赖
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
- 在启动类上添加@EnableDiscoveryClient注解表明是一个Eureka客户端
@EnableDiscoveryClient
@SpringBootApplication
public class EurekaClientApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaClientApplication.class, args);
}
}
- 在配置文件application.yml中添加Eureka客户端的配置
spring:
application:
name: eureka-client1 #应用名称
server:
port: 9001 #端口号
eureka:
client:
register-with-eureka: true #注册到注册中心
fetch-registry: true #从注册中心拉取注册表
service-url:
defaultZone: http://localhost:8080/eureka # 配置注册中心地址
- 再添加一个client 端口号位9002 方便对比
-分别启动Eureka-Client1 、Eureka-Client12
刷新页面 http://localhost:8080/ 可以看到client 已经注册成功了 端口号分别为9001 和9002
**** 以上是单注册中心双客户端
搭建Eureka注册中心集群
搭建两个注册中心
由于所有服务都会注册到注册中心去,服务之间的调用都是通过从注册中心获取的服务列表来调用,注册中心一旦宕机,所有服务调用都会出现问题。所以我们需要多个注册中心组成集群来提供服务,下面将搭建一个双节点的注册中心集群。
- 给eureka-sever添加配置文件application-a.yml配置第一个注册中心
spring:
application:
name: eureka-server
server:
port: 8001
eureka:
instance:
hostname: eureka-a # 域名实力名称
client:
# 默认情况下 eureka server 也是一个微服务,默认情况下会把自己注册到注册中心
# 这里设置为false 不需要注册,集群情况会需要开启
register-with-eureka: true
#是否从eureka server 上获取注册信息
fetch-registry: true
service-url:
defaultZone: http://eureka-b:8002/eureka #注册到副本2的URI
- 给eureka-sever添加配置文件application-b.yml配置第二个注册中心
spring:
application:
name: eureka-server
server:
port: 8002
eureka:
instance:
hostname: eureka-b # 域名实力名称
client:
# 默认情况下 eureka server 也是一个微服务,默认情况下会把自己注册到注册中心
# 这里设置为false 不需要注册,集群情况会需要开启
register-with-eureka: true
#是否从eureka server 上获取注册信息
fetch-registry: true
service-url:
defaultZone: http://eureka-a:8001/eureka #注册到副本1的URI
这里我们通过两个注册中心互相注册,搭建了注册中心的双节点集群,由于defaultZone使用了域名,所以还需在本机的host文件中配置一下。
- 修改本地host文件
127.0.0.1 eureka-a eureka-b
运行Eureka注册中心集群
在IDEA中我们可以通过使用不同的配置文件来启动同一个SpringBoot应用。
-
添加两个配置,分别以application-a.yml和application-b.yml来启动eureka-server
从原启动配置中复制两个出来
-
分别启动两个eureka-server
启动过程中可能会出现以下错误,可以忽略,问题是第二个副本还未启动成功,所以无法连接,不影响副本1的正常启动,当副本2启动正常会提示注册成功
也可以通过java -jar 命令启动集群
- Eureka-Server mven -package 打包成jar文件
定位到target目录
指定运行的配置文件为a
java -jar .\Eureka-Server-0.0.1-SNAPSHOT.jar --spring.profiles.active=a
ctrl+c 会关闭当前窗口服务停止,所以需要打开两个窗口启动两个副本,
- 访问其中一个注册中心http://replica1:8001/发现另一个已经成为其备份
- 访问其中一个注册中心http://replica1:8002/发现另一个已经成为其备份
修改Eureka-client1,Eureka-client2,让其连接到集群
添加eureka-client的配置文件application-replica.yml,让其同时注册到两个注册中心。
spring:
application:
name: eureka-client1 #应用名称
server:
port: 9001 #端口号
eureka:
client:
register-with-eureka: true #注册到注册中心
fetch-registry: true #从注册中心拉取注册表
service-url:
defaultZone: http://eureka-a:8001/eureka/,http://eureka-b:8002/eureka/ # 配置注册中心地址
- 分别以该配置文件启动 Eureka-client1,Eureka-client2,后访问任意一个注册中心节点都可以看到eureka-client
给Eureka注册中心添加认证
创建一个eureka-security-server模块,在pom.xml中添加以下依赖
需要添加SpringSecurity模块。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
添加application.yml配置文件
主要是配置了登录注册中心的用户名和密码。
server:
port: 8003
spring:
application:
name: eureka-security-server
security: #配置SpringSecurity登录用户名和密码
user:
name: admin
password: 123456
eureka:
instance:
hostname: localhost
client:
fetch-registry: false
register-with-eureka: false
添加Springboot 配置WebSecurityConfig
默认情况下添加SpringSecurity依赖的应用每个请求都需要添加CSRF token才能访问,Eureka客户端注册时并不会添加,所以需要配置/eureka/**路径不需要CSRF token。
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http.csrf().ignoringAntMatchers("/eureka/**");
super.configure(http);
}
}
eureka-client注册到有登录认证的注册中心
- 配置文件中需要修改注册中心地址格式
http:// u s e r n a m e : {username}: username:{password}@ h o s t n a m e : {hostname}: hostname:{port}/eureka/ - 添加application-security.yml配置文件,按格式修改用户名和密码
spring:
application:
name: eureka-client1 #应用名称
server:
port: 9001 #端口号
eureka:
client:
register-with-eureka: true #注册到注册中心
fetch-registry: true #从注册中心拉取注册表
service-url:
defaultZone: http://admin:123456@localhost:8003/eureka/ # 配置注册中心地址
- 以application-security.yml配置运行eureka-client1
- 运行eureka-security-server 访问 http://localhost:8003/ 可以在注册中心界面看到eureka-client已经成功注册
Eureka的常用配置
eureka:
client: #eureka客户端配置
register-with-eureka: true #是否将自己注册到eureka服务端上去
fetch-registry: true #是否获取eureka服务端上注册的服务列表
service-url:
defaultZone: http://localhost:8001/eureka/ # 指定注册中心地址
enabled: true # 启用eureka客户端
registry-fetch-interval-seconds: 30 #定义去eureka服务端获取服务列表的时间间隔
instance: #eureka客户端实例配置
lease-renewal-interval-in-seconds: 30 #定义服务多久去注册中心续约
lease-expiration-duration-in-seconds: 90 #定义服务多久不去续约认为服务失效
metadata-map:
zone: jiangsu #所在区域
hostname: localhost #服务主机名称
prefer-ip-address: false #是否优先使用ip来作为主机名
server: #eureka服务端配置
enable-self-preservation: false #关闭eureka服务端的保护机制