从0搭建SpringCloud集群与OAuth2.1前后分离框架（1/12）

一、概要

        实战文章，主要分为两部分。 一是搭建SpringCloud微服务与集群；二是基于OAuth2.1（Spring Authorization Server）搭建前后分离安全框架。

        后端主要采用的技术栈：SpringBoot3.0，Security6.0，OAuth2.1。

        前端主要采用的技术栈：Vue3.0+Vite，ElementPlus。

二、环境

        系统：MAC Apple M2 13.3

        开发工具：IntelliJ IDEA 2022.3.3 (Ultimate Edition)

        JDK版本：OpenJDK 17.0.8

三、文章内容

本章内容，创建项目框架，配置并启动Eureka集群服务。

1、新建项目主体

选择New Module，选择Spring Initializr，设置以下，然后Next。

• Type选择Maven
• JDK选择OpenJDK17
• java版本选择17

这里SpringBoot版本，选择3.0.9版本（后续会在依赖中，将其改成更低版本。其他依赖暂时不需要在这里添加），然后Create……

 新建项目后，打开cloud目录，删除没有用的东西，只保留红框中的内容。这将作为微项目的父工程。

 2、父工程依赖

父工程依赖引入，统一管理项目。修改如下：

• SpringBoot版本，<parent><version>改为3.0.8，用于兼容框架需要的其他插件版本。
• <properties>中，新建版本信息标签，进行依赖版本管理。
• 添加snakeyaml（2.0），修改1.33版本的漏洞。
• 添加lombok（1.18.28），注解开发需要的依赖。
• 创建<dependencyManagement>版本管理，即子项目引入时，由父项目进行版本管理，父项目本身不引入改依赖。
• 版本管理，添加spring-cloud-dependencies（2022.0.1），SpringCloud依赖管理器，后续添加SpringCloud的依赖时，会自动选择可以适配2022.0.1的版本。

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>3.0.8</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>

	<groupId>com.example</groupId>
	<artifactId>cloud</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>pom</packaging>

	<name>cloud</name>
	<description>cloud</description>
	<modules>
		<module>cloud-test</module>
		<module>cloud-user</module>
		<module>cloud-common</module>
		<module>cloud-eureka</module>
	</modules>

	<properties>
		<java.version>17</java.version>
		<!-- snakeyaml版本 -->
		<snakeyaml.version>2.0</snakeyaml.version>
		<!-- lombok注解版本 -->
		<lombok.version>1.18.28</lombok.version>
		<!-- SpringCloud版本 -->
		<spring-cloud.version>2022.0.1</spring-cloud.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>

		<!--  指定snakeyaml，修复1.33版本漏洞  -->
		<dependency>
			<groupId>org.yaml</groupId>
			<artifactId>snakeyaml</artifactId>
			<version>${snakeyaml.version}</version>
		</dependency>

		<!--  lombok注解开发  -->
		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
			<version>${lombok.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<dependencyManagement>
		<dependencies>
			<!--  spring-cloud  -->
			<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>

3、添加四个微服务

添加4个项目作为主要架构的服务：

• 业务服2个，测试服（cloud-test），用户信息服（cloud-user）。 
• 公共服1个，公共服（cloud-common），用于存放项目共用的东西。
• 架构服1个，Eureka服（cloud-eureka），用于注册与发现集群中的微服务。（这里可以选择用Nacos。基于项目本身比较简单，使用Eureka会更加简洁。）

首先，创建测试服（cloud-test）。右键cloud目录，选择New Module，这里项目种类直接选择New Module，Parent为cloud，项目会自动继承我们的cloud父项目。

同理，再新建用户信息服（cloud-user），公共服（cloud-common），Eureka服（cloud-eureka），整完后，项目结构如下：

4、Eureka服务 编写

 （1）添加依赖

这里主要添加Eureka服务端的依赖

<?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>
    <parent>
        <groupId>com.panda</groupId>
        <artifactId>panda-cloud</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>

    <artifactId>eureka-service</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!--  Eureka服务端依赖  -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
        </dependency>
    </dependencies>

</project>

（2）设置参数

在src.main.resources包中，创建application.yml配置文件（其中注释部分可根据需求自行调整）

主要设置：

• spring.application.name，修改服务名称，后续方便在注册中心查看。
• service.port，分配端口。
• eureka.instance.hostname，修改host，用于在本地实现集群。
• eureka.client.fetch-registry，修改为false，作为服务端，不需要获取服务端。
• eureka.client.service-url.defaultZone，指向另外一个eureka服务，实现集群。

spring:
  application:
    name: EUREKA-SERVICE

server:
  port: 7101

eureka:
  instance:
    # 填写主机名称，一般为localhost
    # 但由于Eureka只支持单服单例，因此通过host文件，修改代理实现单服多例
    hostname: eureka01
    # 是否将自己的ip注册到eureka中，默认false。这里用主机名注册
    #prefer-ip-address: true
    # 每一次eureka client 向 eureka server发送心跳的时间间隔
    #lease-renewal-interval-in-seconds: 30
    # 如果90秒内eureka server没有收到eureka client的心跳包，则剔除该服务
    #lease-expiration-duration-in-seconds: 90

  client:
    # 作为服务端，不需要获取服务端，改为false（默认为true）
    fetch-registry: false
    # 是否将自己注册到Eureka（集群则用默认true）
    #register-with-eureka: false
    # Eureka服务端地址
    service-url:
      defaultZone: http://eureka02:7102/eureka

  dashboard:
    # 是否启用eureka web控制台
    enabled: true
    # 设置eureka web控制台默认访问路径
    #path: /

(3) 修改本地代理

由于Eureka只支持单服单例，因此通过host文件，修改代理实现单服多例。

打开终端，输入sudo vi /etc/hosts，将以下两行参数填入文件末行，:wq保存即可。

127.0.0.1       eureka01

127.0.0.1       eureka02

即在本地访问指定网址，可代理指向指定IP。如访问eureka01，即为访问127.0.0.1。

（4）启动类修改

在src.main.java.com.example包中，将Main启动类修改为

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

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

（5）配置启动工具

点击build与run中间的下拉框，选择Edit Configurations。

 打开Run设置界面，主要操作：

• 左侧部份，新建文件夹EurekaService，复制一个EurekaApplication项目，设置为EurekaApplication01和EurekaApplication02。
• 右侧部份，EurekaApplication02项目，点击Modify options，勾选Override configuration properties（启动时需要覆盖的配置）。修改端口、hostname、还有指向另一台Eureka服务器的地址（这里填eureka01这台）。

IDEA底部，选择Services，然后Add service添加服务，点击Run Configuration Type，选中SpringBoot。 

 完成上述步骤后，这里就可以启动两个Eureka服务，如下：

打开浏览器，输入http://eureka01:7101（或http://eureka02:7102，或http://127.0.0.1:7101），可打开Eureka的可视化界面，查看服务的情况。如下：

 发现，两个Eureka服务已被发现，并且eureka02已被设置为available-replicas。

四、后续

下一章：搭建用户信息服（cloud-user）、测试服（cloud-test）、公共服（cloud-common），并实现负载均衡。从0开始搭建SpringCloud集群（2/12）_秋雨忆的博客-CSDN博客