前言
欢迎来到菜鸟SpringCloud入门实战系列(SpringCloudForNoob),该系列通过层层递进的实战视角,来一步步学习和理解SpringCloud。
本系列适合有一定Java以及SpringBoot基础的同学阅读。
每篇文章末尾都附有本文对应的Github源代码,方便同学调试。
Github仓库地址:
https://github.com/qqxx6661/springcloud_for_noob
菜鸟SpringCloud入门实战系列
你还可以通过以下两种途径查看菜鸟SpringCloud入门实战系列:
- 关注我的公众号:Rude3Knife 点击公众号下方:技术推文——SpringCloud
- 菜鸟SpringCloud实战专栏(CSDN)
实战版本
- SpringBoot:2.0.3.RELEASE
- SpringCloud:Finchley.RELEASE
-----正文开始-----
构建多模块的Maven项目 + 创建注册中心Eureka子模块
构建多模块的Maven项目
由于SpringCloud中有许多组件,每个组件都需要单独进行开发和维护,为了便于统一的版本维护和管理,我们经常会用到Maven的多模块模式。
结构如下:
创建主工程
首先创建一个Maven项目作为主工程,类型无所谓,这里建议使用maven-archetype-quickstart骨架,创建过程如下:
File–>New–>Project –>Maven–>Create from archetype–>maven-archetype-quickstart-Next –>GroupId={你的GroupId}–>AritifactId={你的ArtifactId} –>Next–>Next–>Finish–>New Whindow
创建子模块
在new-module里新建模块:
一路下一步即可:
在这里我们新建子模块名为eureka,用来放之后要用的eureka模块,新建好后,子模块的目录如下:
删除主工程多于目录
由于并不需要在主工程进行任何代码开发,所以删除其src目录。
可以看到现在我们的目录结构:
编辑主工程pom.xml
主工程的pom.xml里做的事:
- 配置Springboot和SpringCloud基础组件
- 配置子模块:可以看出现在有一个子模块`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>
<groupId>com.pricemonitor</groupId>
<artifactId>springcloud</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>pom</packaging>
<name>springcloud</name>
<!–子模块–>
<modules>
<module>eureka</module>
</modules>
<!–父级:Spring Boot–>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.3.RELEASE</version>
</parent>
<!–参数–>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<!–Spring Cloud 版本序列配置–>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Finchley.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!–Spring Boot 执行器组件–>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!–Spring Cloud 基础–>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter</artifactId>
</dependency>
<!–Spring Cloud 服务注册组件–>
<dependency>
<groupId>org.springframework.cloud</groupId>
<!–此处的依赖是SpringBoot2.0以后专用的,如果您使用的SpringBoot版本低于2.0请使用spring-cloud-starter-eureka-server–>
<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>
<!–Spring Boot Web组件–>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!–Spring Boot 测试组件–>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
创建注册中心Eureka子模块
Eureka介绍
服务中心又称注册中心,管理各种服务功能包括服务的注册、发现、熔断、负载、降级等,比如dubbo admin后台的各种功能。
Spring Cloud 封装了 Netflix 公司开发的 Eureka 模块来实现服务注册和发现。Eureka 采用了 C-S 的设计架构。Eureka Server 作为服务注册功能的服务器,它是服务注册中心。而系统中的其他微服务,使用 Eureka 的客户端连接到 Eureka Server,并维持心跳连接。这样系统的维护人员就可以通过 Eureka Server 来监控系统中各个微服务是否正常运行。Spring Cloud 的一些其他模块(比如Zuul)就可以通过 Eureka Server 来发现系统中的其他微服务,并执行相关的逻辑。
Eureka由两个组件组成:Eureka服务器和Eureka客户端。Eureka服务器用作服务注册服务器。Eureka客户端是一个java客户端,用来简化与服务器的交互、作为轮询负载均衡器,并提供服务的故障切换支持。Netflix在其生产环境中使用的是另外的客户端,它提供基于流量、资源利用率以及出错状态的加权负载均衡。
上图简要描述了Eureka的基本架构,由3个角色组成:
1、Eureka Server
- 提供服务注册和发现
2、Service Provider
- 服务提供方
- 将自身服务注册到Eureka,从而使服务消费方能够找到
3、Service Consumer
- 服务消费方
- 从Eureka获取注册服务列表,从而能够消费服务
编辑子模块Eureka的pom.xml
接下来我们在子模块Eureka中创建一个SpringCloud的注册中心Eureka
代码重点:
- 继承了父pom.xml
- 可以看到这里并没有引入任何新的依赖,那如何引入eureka组件依赖呢,回到上面的主pom.xml,你会发现我在其中引入了
spring-cloud-starter-netflix-eureka-server
,这是因为在之后的大部分模块中,我们都会用到Eureka-server,所以将其放在主pom中供其他子模块共享使用 - 子模块是可以打包jar运行的:
<packaging>jar</packaging>
<?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>
<span class="token operator"><</span>artifactId<span class="token operator">></span>eureka<span class="token operator"><</span><span class="token operator">/</span>artifactId<span class="token operator">></span> <span class="token operator"><</span>version<span class="token operator">></span><span class="token number">0.0</span><span class="token punctuation">.</span><span class="token number">1</span><span class="token operator">-</span>SNAPSHOT<span class="token operator"><</span><span class="token operator">/</span>version<span class="token operator">></span> <span class="token operator"><</span>name<span class="token operator">></span>eureka<span class="token operator"><</span><span class="token operator">/</span>name<span class="token operator">></span> <span class="token operator"><</span>packaging<span class="token operator">></span>jar<span class="token operator"><</span><span class="token operator">/</span>packaging<span class="token operator">></span> <span class="token operator"><</span>description<span class="token operator">></span>Demo project <span class="token keyword">for</span> Spring Boot<span class="token operator"><</span><span class="token operator">/</span>description<span class="token operator">></span> <span class="token operator"><</span><span class="token operator">!</span><span class="token operator">--</span>父工程的依赖<span class="token operator">--</span><span class="token operator">></span> <span class="token operator"><</span>parent<span class="token operator">></span> <span class="token operator"><</span>groupId<span class="token operator">></span>com<span class="token punctuation">.</span>pricemonitor<span class="token operator"><</span><span class="token operator">/</span>groupId<span class="token operator">></span> <span class="token operator"><</span>artifactId<span class="token operator">></span>springcloud<span class="token operator"><</span><span class="token operator">/</span>artifactId<span class="token operator">></span> <span class="token operator"><</span>version<span class="token operator">></span><span class="token number">0.0</span><span class="token punctuation">.</span><span class="token number">1</span><span class="token operator">-</span>SNAPSHOT<span class="token operator"><</span><span class="token operator">/</span>version<span class="token operator">></span> <span class="token operator"><</span><span class="token operator">/</span>parent<span class="token operator">></span> <span class="token operator"><</span>dependencies<span class="token operator">></span> <span class="token operator"><</span><span class="token operator">/</span>dependencies<span class="token operator">></span>
</project>
添加启动代码中添加@EnableEurekaServer注解
EurekaApplication.java
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;
@SpringBootApplication
@EnableEurekaServer
public class EurekaApplication {
<span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">main</span><span class="token punctuation">(</span>String<span class="token punctuation">[</span><span class="token punctuation">]</span> args<span class="token punctuation">)</span> <span class="token punctuation">{</span>
SpringApplication<span class="token punctuation">.</span><span class="token function">run</span><span class="token punctuation">(</span>EurekaApplication<span class="token punctuation">.</span><span class="token keyword">class</span><span class="token punctuation">,</span> args<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span>
}
如果你发现@EnableEurekaServer无法引入,请检查你的SpringCloud版本与SpringBoot版本是否兼容:
springboot无法引入@enableeurekaserver以及Spring Cloud与Spring Boot版本匹配关系:
https://blog.csdn.net/zhang53141/article/details/83091032
配置文件
默认生成的配置文件是application.properties,也可以写成application.yml格式,配置如下:
# 端口号
server:
port: 8761
# 服务注册相关配置
eureka:
# 服务实例主机名
instance:
hostname: localhost
# 服务提供者配置
client:
# 不进行注册(当服务注册中心是单点而非高可用时的配置方式)
registerWithEureka: false
# 不获取注册信息(当服务注册中心是单点而非高可用时的配置方式)
fetchRegistry: false
# 服务注册中心地址
serviceUrl:
defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
注意:
- registerWithEureka: false表示当前服务注册中心不在其他服务注册中心进行注册。
- fetchRegistry: false表示当前服务注册中心不获取其他服务注册中心的注册信息。
- 以上两个配置,只有在当服务注册中心是单点配置时才如此配置,因为单点情况下这两个值必然为false。
运行
可以看到下面的页面,其中还没有发现任何服务,这只是一个孤零零的eureka-server。
在下一个教程中,我们将创建服务提供者并在Eureka进行注册。
本文教程所对应工程代码
https://github.com/qqxx6661/springcloud_for_noob/tree/master/01-eureka