springcloud环境搭建

springcloud环境搭建

• springcloud环境搭建
  • 新建IDEA项目
    • 初始化父工程
      • 父工程的pom文件
    • 初始化服务一/Eureka服务注册中心
      • 子module的pom
      • 微服务eureka的配置步骤
    • 建立父子项目的关系
    • 初始化服务二/客户端

新建IDEA项目

初始化父工程

初始化名称，这是父工程。

父服务的作用：

1. 为所有的子module提供公共的jar包依赖
2. 具体功能由每个module完成，即每个微服务

不选择任何jar包，单独添加。

项目目录结构

springcloud-eureka-clientEureka 服务注册中心
Springcloud-ms-eureka 是服务端

父工程的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 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>2.0.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>springcloud</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <!-- 注意 最后打包 最外层的pom 需要更改为 pom而不是jar   -->
    <packaging>pom</packaging>
<!--    <packaging>pom</packaging>-->

    <name>springcloud</name>
    <description>Demo project for Spring Boot</description>

    <modules>
        <module>springcloud-ms-eureka</module>
        <module>springcloud-eureka-client</module>
    </modules>

    <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>2.0.0.RELEASE</spring-cloud.version>-->
        <spring.cloud-version>Finchley.RELEASE</spring.cloud-version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!--最外层 主项目 添加spring cloud依赖 https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-starter -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.5.0</version>
            <scope>test</scope>
        </dependency>

    </dependencies>

    <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>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

需要注意的是springboot和springcloud版本之间需要对应，本文springboot使用2.0.3.RELEASE，springcloud使用Finchley.RELEASE。

具体对照需要官网查看https://start.spring.io/actuator/info（firefox查看是json格式）。

或者官网查看最新版本https://spring.io/projects/spring-cloud#learn

大版本对应：

使用中具体版本对应：

初始化服务一/Eureka服务注册中心

创建Eureka，也就是创建本项目的子模块

• Eureka服务注册中心的作用：
  • 让本项目的其他微服务在服务注册中心进行注册
  • 服务启动后，注册中心可以查询所有可用服务的实例库，并缓存到本地
  • 内置轮询负载均衡算法，默认发送心跳检测是30s，一个微服务停止了，需要3个心跳才能让服务器和客户端的元数据相同

子module的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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <artifactId>springcloud-ms-eureka</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>springcloud-ms-eureka</name>
    <description>Demo project for Spring Boot</description>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>springcloud</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <packaging>jar</packaging>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
<!--        <dependency>-->
<!--            <groupId>org.springframework.cloud</groupId>-->
<!--            <artifactId>spring-cloud-starter-eureka-server</artifactId>-->
<!--            <version>1.3.5.RELEASE</version>-->
<!--        </dependency>-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
        </dependency>
    </dependencies>
</project>

微服务eureka的配置步骤

• （1）完善eureka微服务的完整的pom.xml文【注意spring boot2.0版本 eureka的jar包名字已经改变】

  eureka的pom.xml

• （2）在eureka微服务的启动类中添加注解@EnableEurekaServer

  import org.springframework.boot.SpringApplication;
  import org.springframework.boot.autoconfigure.SpringBootApplication;
  import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;
  
  @EnableEurekaServer
  @SpringBootApplication
  public class SpringcloudMsEurekaApplication {
  
      public static void main(String[] args) {
          SpringApplication.run(SpringcloudMsEurekaApplication.class, args);
      }
  }

• （3）完善eureka的配置文件properties文件

  #声明本服务在注册中心展示的名字、也是在网关访问时定位服务的名字
  spring.application.name=spring-cloud-ms-eureka
  eureka.instance.hostname=127.0.0.1
  server.port=8000
  
  #是否将自己作为服务注册到注册中心，默认为true，false不能将自己注册到自己,
  #如果有多个服务注册中心的微服务的话，可以将这个设置为true，表示可以将注册中心1注册到注册中心2中
  #eureka.client.register-with-eureka=false
  #表示是否从eureka注册中心中获取注册信息,默认为true
  #eureka.client.fetch-registry=false
  eureka.client.registerWithEureka=false
    #是否将自己注册到 Eureka-Server 中，默认的为 true   registerWithEureka等同于register_with_eureka
  eureka.client.fetchRegistry=false
    #是否需要拉取服务信息，默认未true fetchRegistry等同于 fetch-registry
  
  #注册中心的交互地址，设置多个地址可以用,分隔  查询服务和注册服务都需要依赖这个地址
  #关于设置注册中心这么关键的服务，如果是单点话，遇到故障就是毁灭性的。
  #在一个分布式系统中，服务注册中心是最重要的基础部分，理应随时处于可以提供服务的状态。为了维持其可用性，使用集群是很好的解决方案
  #所以 在一个分布式系统中，设置最少两个服务注册中心是最基本的
  eureka.client.serviceUrl.defaultZone=http://${eureka.instance.hostname}:${server.port}/eureka/
  #eureka.client.serviceUrl.defaultZone=http://localhost:8000/eureka/

• （4）启动服务中心
  访问http:localhost:8000

  可以看到现在，注册中心中，没有服务注册。

  

建立父子项目的关系

• 在外层的父项目中的pom.xml文件中进行声明
  声明的子级项目的名字 对应的是项目的pom.xml文件中子级项目的名字

  <!--父 pom.xml-->
  <artifactId>springcloud</artifactId>
  ...
  <modules>
      <module>springcloud-ms-eureka</module>
      <module>springcloud-eureka-client</module>
  </modules>

• 在子项目中<parent>中声明父级名称

  <!--子 pom.xml-->
  <modelVersion>4.0.0</modelVersion>
  <artifactId>springcloud-ms-eureka</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>springcloud-ms-eureka</name>
  <description>Demo project for Spring Boot</description>
  <parent>
      <groupId>com.example</groupId>
      <artifactId>springcloud</artifactId>
      <version>0.0.1-SNAPSHOT</version>
  </parent>

初始化服务二/客户端

客户端client，提供真正的服务的配置，此服务在注册中心注册

• client的pom.xml

  <?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>
      <!--    <groupId>com.example</groupId>-->
      <artifactId>springcloud-eureka-client</artifactId>
      <version>0.0.1-SNAPSHOT</version>
      <name>springcloud-eureka-client</name>
      <description>Demo project for Spring Boot</description>
      <parent>
          <groupId>com.example</groupId>
          <artifactId>springcloud</artifactId>
          <version>0.0.1-SNAPSHOT</version>
      </parent>
  
      <packaging>jar</packaging>
  
      <properties>
          <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
          <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
          <java.version>1.8</java.version>
      </properties>
      <dependencies>
          <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>
      </dependencies>
  </project>

• 完善配置文件properties文件

#声明本服务在注册中心展示的名字、也是在网关访问时定位服务的名字
spring.application.name=spring-cloud-eureka-client
eureka.instance.hostname=127.0.0.1
server.port=8001

eureka.client.registerWithEureka=true
#是否将自己注册到 Eureka-Server 中，默认的为 true   registerWithEureka等同于register_with_eureka
eureka.client.fetchRegistry=true

eureka.client.serviceUrl.defaultZone=http://${eureka.instance.hostname}:8000/eureka/

• 提供服务

在client的启动类添加@EnableDiscoveryClient，代表自己是一个服务注册方。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient  //代表自己是服务提供方
public class SpringcloudEurekaClientApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringcloudEurekaClientApplication.class, args);
    }

}

• 编写一个所提供的测试服务

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/hello")
public class TestController {

    @RequestMapping("/world")
    public String HelloWorld(String s){
        return "传入的值为" + s;
    }

}

• 运行client程序

可以看到服务提供者已经被注册进eureka

访问此服务

http://localhost:8001/hello/world?s=1