Eclipse(STS) 初次搭建Spring Cloud项目之Eureka服务注册和发现（一）

喜欢ヅ旅行 2022-01-20 10:41 779阅读 0赞

# 一、什么是SpringCloud #

1.  文本 Spring Cloud是一个微服务框架，相比Dubbo等RPC框架, Spring Cloud提供的全套的分布式系统解决方案。
2.  Spring Cloud对微服务基础框架Netflix的多个开源组件进行了封装，同时又实现了和云端平台以及和Spring Boot开发框架的集成。
3.  Spring Cloud为微服务架构开发涉及的配置管理，服务治理，熔断机制，智能路由，微代理，控制总线等

# 二、什么是Eureka #

1.  Eureka是Netflix的一个核心子模块，Eureka是基于的Rest服务，用于定位服务。服务的注册与发现对于微服务架构来说是非常重要的，经过配置之后访问服务只需提供服务标识即可。其功能类似于dubbo的注册中心zookeeper。
2.  分布式系统中一般需要遵循CAP原则：CAP原则又称CAP定理，指的是在一个分布式系统中，Consistency（一致性）、 Availability（可用性）、Partition tolerance（分区容错性），三者不可兼得(摘自百度百科)。
3.  Eureka和zookeeper不同点在于，zookeeper是基于CP原则构建，而Eureka是基于AP原则构建。即任何时刻zookeeper的访问请求都能得到一致性的结果，但是其并不保证服务的可用性，zookeeper的选举机制在节点多了之后会非常耗时。在Eureka平台中不会出现类似于zookeeper的选举leader的过程，如果某台服务器宕机，Eureka会自动切换到新的Eureka节点，当服务器恢复之后，Eureka会重新将其纳入服务器集群管理当中。

# 三、创建parent项目 #

开发环境：
    开发工具：Spring Tool Suite 4
    JDK版本：1.8
    SpringBoot版本：2.0.9.RELEASE
    SpringCloud版本：Finchley.SR3
    复制代码

**File-->New-->Maven Project，选中Create a simple project(skip archetype selection) 点击Next，输入相应的groupId和ArtifactId，packaging修改为pom，点击完成，创建成功。此parent项目为整个springcloud的父项目，主要用于版本控制和公共jar包引入。**

## pom文件 ##

<?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>com.hewl</groupId>
    	<artifactId>springcloud-parent</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    	<packaging>pom</packaging>
    
    	<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>2.0.9.RELEASE</version>
    		<relativePath /> 
    	</parent>
    	<properties>
    		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    		<java.version>1.8</java.version>
    		<spring-cloud.version>Finchley.SR3</spring-cloud.version>
    	</properties>
    	<dependencies>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-test</artifactId>
    			<scope>test</scope>
    		</dependency>
    	</dependencies>
    	<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>
    	<build>
    		<plugins>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    			</plugin>
    		</plugins>
    	</build>
    </project>
    复制代码

# 四、创建Eureka Server项目 #

--------------------

**右键cloud-demo-parent项目-->Maven-->New Maven Module Project，Module Name输入cloud-demo-eureka-server，点击Finish完成创建，PS:如果项目出现红叉，请Maven-->update project**

创建成功项目结构是这样的：根据个人习惯，我改成了这样，没有resource文件夹的同学，右键项目-->New-->source Folder

### pom文件 spring-cloud-starter-security 先注释掉一会再讲 ###

<?xml version="1.0"?>
    <project
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
    	xmlns="http://maven.apache.org/POM/4.0.0"
    	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    	<modelVersion>4.0.0</modelVersion>
    	<parent>
    		<groupId>com.hewl</groupId>
    		<artifactId>cloud-demo-parent</artifactId>
    		<version>0.0.1-SNAPSHOT</version>
    	</parent>
    	<artifactId>cloud-demo-eureka-server</artifactId>
    	<name>cloud-demo-eureka-server</name>
    	<url>http://maven.apache.org</url>
    	<properties>
    		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    	</properties>
    	<dependencies>
    		<dependency>
    			<groupId>org.springframework.cloud</groupId>
    			<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    		</dependency>
    
    	</dependencies>
    </project>
    
    复制代码

### application.yml，此为单机配置，集群环境稍后讲解（yml就是以前的properties，笔者比较喜欢yml的层级写法）。 ###

server:
     port: 8761 # 你的端口
    spring:
    #  security:
    #    user:
    #      name: admin
    #      password: admin
      application:
        name: service-registry
    eureka:
     instance:
       hostname: localhost # 你的地址
       instance-id: ${spring.application.name}:${server.port}:@project.version@
       prefer-ip-address: true
     client:
       registerWithEureka: false # 表示是否注册自身到eureka服务器，因为当前这个应用就是eureka服务器，没必要注册自身，所以这里是false
       fetchRegistry: false # fetchRegistry表示是否从eureka服务器获取注册信息
       serviceUrl:
          defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
    
    复制代码

### 启动服务并访问([http://localhost:8761][http_localhost_8761]),出现此页面，表示启动成功，eureka server启动成功 ###

# 五、 创建Eureka Client 项目 #

### 创建流程与创建eureka server相同，创建名为cloud-demo-eureka-client的项目，这里不再截图演示项目结构改成我们熟悉的样式。 ###

### pom文件，eureka client实际上就是我们应用服务，一般情况下需要提供接口，所以这里引入spring-boot-starter-web，另外引入spring-cloud-starter-netflix-eureka-client ###

<?xml version="1.0"?>
    <project
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
    	xmlns="http://maven.apache.org/POM/4.0.0"
    	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    	<modelVersion>4.0.0</modelVersion>
    	<parent>
    		<groupId>com.hewl</groupId>
    		<artifactId>cloud-demo-parent</artifactId>
    		<version>0.0.1-SNAPSHOT</version>
    	</parent>
    	<artifactId>cloud-demo-eureka-client</artifactId>
    	<name>cloud-demo-eureka-client</name>
    	<url>http://maven.apache.org</url>
    	<properties>
    		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    	</properties>
    	<dependencies>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-web</artifactId>
    		</dependency>
    		<dependency>
    			<groupId>org.springframework.cloud</groupId>
    			<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    		</dependency>
    	</dependencies>
    </project>
    
    复制代码

### application.yml ###

spring:
      application:
        name: service-eureka-client #服务名称
    server:
      port: 8800 #端口
    eureka:
      client:
        service-url:
          defaultZone: http://localhost:8761/eureka/  #服务中心地址
    复制代码

### TestController.java ###

package com.hewl.controller;
    
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestParam;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    public class TestController {
    	
    	@Value("${server.port}")
    	private String port;
    	
    	@GetMapping("/test")
    	public String testMethod(@RequestParam("name") String name) {
    		return "hello world!!!  端口为：" + port + "名字为：" + name;
    	}
    }
    
    
    复制代码

### 先启动eureka server,再启动eureka client，访问http://localhost:8761,出现箭头所示服务名称表示client客户端注册成功 ###

### 访问客户端 [http://localhost:8800/test?name=张三][http_localhost_8800_test_name] ###

### 至此eureka 服务端+客户端配置完成。 ###

# 六、 spring-cloud-starter-security #

像eureka server的这种管理页面，如果随便登录是非常不安全的，那么怎么办呢？我们这里引入这个jar包，给eureka server管理页面增加一个登录验证。

### 放开前面提到的，eureka-server中注释掉的这个maven地址 ###

<dependency>
    			<groupId>org.springframework.cloud</groupId>
    			<artifactId>spring-cloud-starter-security</artifactId>
    		</dependency>
    复制代码

### 相应的cloud-demo-eureka-server项目中的yml做出对应修改，增加spring.security.user.name和spring.security.user.password ###

server:
     port: 8761 # 你的端口
    spring:
      security:
        user:
          name: admin
          password: admin
      application:
        name: service-registry
    eureka:
     instance:
       hostname: localhost # 你的地址
     client:
       registerWithEureka: false # 表示是否注册自身到eureka服务器，因为当前这个应用就是eureka服务器，没必要注册自身，所以这里是false
       fetchRegistry: false # fetchRegistry表示是否从eureka服务器获取注册信息
       serviceUrl:
          defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
    
    复制代码

### cloud-demo-eureka-client项目中的yml也要做出修改，在eureka连接地址配置上增加用户名密码 ###

spring:
      application:
        name: service-eureka-client #服务名称
    server:
      port: 8800 #端口
    eureka:
      client:
        service-url:
          defaultZone: http://admin:admin@localhost:8761/eureka/  #服务中心地址
    复制代码

### 重新启动服务端项目，访问http://location:8761 ###

### 启动客户端项目，发现启动报错 ###

### 这里我们还需要在cloud-demo-eureka-server项目中加入如下代码,再次启动，成功注册服务。这里是因为2.x以后的版本(具体是不是2.x以后不清楚，反正是新版本)的security默认开启了csrf校验 ###

[http_localhost_8761]: https://link.juejin.im?target=http%3A%2F%2Flocalhost%3A8761
[http_localhost_8800_test_name]: https://link.juejin.im?target=http%3A%2F%2Flocalhost%3A8800%2Ftest%3Fname%3D%25E5%25BC%25A0%25E4%25B8%2589