業餘草 SpringCloud 教程 | 第一篇： 服務的註冊與發現Eureka(Finchley版本)

1、spring cloud簡介

鑑於《史上最簡單的Spring Cloud教程》很受讀者歡迎，再次我特地升級了一下版本，目前支持的版本爲Spring Boot版本2.0.3.RELEASE,Spring Cloud版本爲Finchley.RELEASE。

Finchley版本的官方文檔以下： 
http://cloud.spring.io/spring-cloud-static/Finchley.RELEASE/single/spring-cloud.html

spring cloud 爲開發人員提供了快速構建分佈式系統的一些工具，包括配置管理、服務發現、斷路器、路由、微代理、事件總線、全局鎖、決策競選、分佈式會話等等。它運行環境簡單，能夠在開發人員的電腦上跑。另外說明spring cloud是基於springboot的，因此須要開發中對springboot有必定的瞭解，若是不瞭解的話能夠看這篇文章：2小時學會springboot。另外對於「微服務架構」 不瞭解的話，能夠經過搜索引擎搜索「微服務架構」瞭解下。

2、建立服務註冊中心

在這裏，我仍是採用Eureka做爲服務註冊與發現的組件，至於Consul 以後會出文章詳細介紹。

2.1 首先建立一個maven主工程。

首先建立一個主Maven工程，在其pom文件引入依賴，spring Boot版本爲2.0.3.RELEASE，Spring Cloud版本爲Finchley.RELEASE。這個pom文件做爲父pom文件，起到依賴版本控制的做用，其餘module工程繼承該pom。這一系列文章所有采用這種模式，其餘文章的pom跟這個pom同樣。再次說明一下，之後再也不重複引入。代碼以下：

 

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 4     <modelVersion>4.0.0</modelVersion>
 5  
 6     <groupId>com.forezp</groupId>
 7     <artifactId>sc-f-chapter1</artifactId>
 8     <version>0.0.1-SNAPSHOT</version>
 9     <packaging>pom</packaging>
10  
11     <name>sc-f-chapter1</name>
12     <description>Demo project for Spring Boot</description>
13  
14     <parent>
15         <groupId>org.springframework.boot</groupId>
16         <artifactId>spring-boot-starter-parent</artifactId>
17         <version>2.0.3.RELEASE</version>
18         <relativePath/>
19     </parent>
20  
21     <modules>
22         <module>eureka-server</module>
23         <module>service-hi</module>
24     </modules>
25  
26     <properties>
27         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
28         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
29         <java.version>1.8</java.version>
30         <spring-cloud.version>Finchley.RELEASE</spring-cloud.version>
31     </properties>
32  
33     <dependencies>
34         <dependency>
35             <groupId>org.springframework.boot</groupId>
36             <artifactId>spring-boot-starter-test</artifactId>
37             <scope>test</scope>
38         </dependency>
39     </dependencies>
40  
41     <dependencyManagement>
42         <dependencies>
43             <dependency>
44                 <groupId>org.springframework.cloud</groupId>
45                 <artifactId>spring-cloud-dependencies</artifactId>
46                 <version>${spring-cloud.version}</version>
47                 <type>pom</type>
48                 <scope>import</scope>
49             </dependency>
50         </dependencies>
51     </dependencyManagement>
52  
53     <build>
54         <plugins>
55             <plugin>
56                 <groupId>org.springframework.boot</groupId>
57                 <artifactId>spring-boot-maven-plugin</artifactId>
58             </plugin>
59         </plugins>
60     </build>
61  
62 </project>

2.2 而後建立2個model工程:一個model工程做爲服務註冊中心，即Eureka Server,另外一個做爲Eureka Client。

下面以建立server爲例子，詳細說明建立過程：

右鍵工程->建立model-> 選擇spring initialir 以下圖：

下一步->選擇cloud discovery->eureka server ,而後一直下一步就好了。

建立完後的工程，其pom.xml繼承了父pom文件，並引入spring-cloud-starter-netflix-eureka-server的依賴，代碼以下：

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 4     <modelVersion>4.0.0</modelVersion>
 5  
 6     <groupId>com.forezp</groupId>
 7     <artifactId>eureka-server</artifactId>
 8     <version>0.0.1-SNAPSHOT</version>
 9     <packaging>jar</packaging>
10  
11     <name>eureka-server</name>
12     <description>Demo project for Spring Boot</description>
13  
14     <parent>
15         <groupId>com.forezp</groupId>
16         <artifactId>sc-f-chapter1</artifactId>
17         <version>0.0.1-SNAPSHOT</version>
18     </parent>
19  
20     <dependencies>
21         <dependency>
22             <groupId>org.springframework.cloud</groupId>
23             <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
24         </dependency>
25     </dependencies>
26  
27 </project>

2.3 啓動一個服務註冊中心，只須要一個註解@EnableEurekaServer，這個註解須要在springboot工程的啓動application類上加：

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

2.4 eureka是一個高可用的組件，它沒有後端緩存，每個實例註冊以後須要向註冊中心發送心跳（所以能夠在內存中完成），在默認狀況下erureka server也是一個eureka client ,必需要指定一個 server。eureka server的配置文件appication.yml：

 1 server:
 2   port: 8761
 3  
 4 eureka:
 5   instance:
 6     hostname: localhost
 7   client:
 8     registerWithEureka: false
 9     fetchRegistry: false
10     serviceUrl:
11       defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
12  
13 spring:
14   application:
15     name: eurka-server

經過eureka.client.registerWithEureka：false和fetchRegistry：false來代表本身是一個eureka server.

2.5 eureka server 是有界面的，啓動工程,打開瀏覽器訪問： 
http://localhost:8761 ,界面以下：

No application available 沒有服務被發現 ……^_^ 
由於沒有註冊服務固然不可能有服務被發現了。

3、建立一個服務提供者 (eureka client)

當client向server註冊時，它會提供一些元數據，例如主機和端口，URL，主頁等。Eureka server 從每一個client實例接收心跳消息。 若是心跳超時，則一般將該實例從註冊server中刪除。

建立過程同server相似,建立完pom.xml以下：

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 4     <modelVersion>4.0.0</modelVersion>
 5  
 6     <groupId>com.forezp</groupId>
 7     <artifactId>service-hi</artifactId>
 8     <version>0.0.1-SNAPSHOT</version>
 9     <packaging>jar</packaging>
10  
11     <name>service-hi</name>
12     <description>Demo project for Spring Boot</description>
13  
14     <parent>
15         <groupId>com.forezp</groupId>
16         <artifactId>sc-f-chapter1</artifactId>
17         <version>0.0.1-SNAPSHOT</version>
18     </parent>
19  
20     <dependencies>
21         <dependency>
22             <groupId>org.springframework.cloud</groupId>
23             <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
24         </dependency>
25         <dependency>
26             <groupId>org.springframework.boot</groupId>
27             <artifactId>spring-boot-starter-web</artifactId>
28         </dependency>
29     </dependencies>
30  
31     <build>
32         <plugins>
33             <plugin>
34                 <groupId>org.springframework.boot</groupId>
35                 <artifactId>spring-boot-maven-plugin</artifactId>
36             </plugin>
37         </plugins>
38     </build>
39  
40  <!-- www.xttblog.com -->
41 </project>

經過註解@EnableEurekaClient 代表本身是一個eurekaclient.

@SpringBootApplication
@EnableEurekaClient
@RestController
public class ServiceHiApplication {
 
    public static void main(String[] args) {
        SpringApplication.run( ServiceHiApplication.class, args );
    }
 
    @Value("${server.port}")
    String port;
 
    @RequestMapping("/hi")
    public String home(@RequestParam(value = "name", defaultValue = "forezp") String name) {
        return "hi " + name + " ,i am from port:" + port;
    }
 
}

僅僅@EnableEurekaClient是不夠的，還須要在配置文件中註明本身的服務註冊中心的地址，application.yml配置文件以下：

 1 server:
 2   port: 8762
 3  
 4 spring:
 5   application:
 6     name: service-hi
 7  
 8 eureka:
 9   client:
10     serviceUrl:
11       defaultZone: http://localhost:8761/eureka/
12  

 

須要指明spring.application.name,這個很重要，這在之後的服務與服務之間相互調用通常都是根據這個name 。 
啓動工程，打開http://localhost:8761 ，即eureka server 的網址：

你會發現一個服務已經註冊在服務中了，服務名爲SERVICE-HI ,端口爲7862

這時打開 http://localhost:8762/hi?name=forezp ，你會在瀏覽器上看到 :

hi forezp,i am from port:8762

源碼下載：https://github.com/forezp/SpringCloudLearning/tree/master/sc-f-chapter1

4、參考資料

http://cloud.spring.io/spring-cloud-static/Finchley.RELEASE/single/spring-cloud.html

感謝您的關注！可加QQ1羣：135430763，QQ2羣：454796847，QQ3羣：187424846。QQ羣進羣密碼：xttblog，想加微信羣的朋友，能夠微信搜索：xmtxtt，備註：「xttblog」，添加助理微信拉你進羣。備註錯誤不會贊成好友申請。再次感謝您的關注！後續有精彩內容會第一時間發給您！原創文章投稿請發送至532009913@qq.com郵箱。商務合做可添加助理微信進行溝通！