為什么使用SAE服務(wù)注冊(cè)中心

SAE服務(wù)注冊(cè)中心提供了開源Nacos Server的商用版本，使用開源版本Spring Cloud Alibaba Nacos Discovery開發(fā)的應(yīng)用可以直接使用SAE提供的商業(yè)版服務(wù)注冊(cè)中心。

SAE服務(wù)注冊(cè)中心與Nacos、Eureka和Consul相比，具有以下優(yōu)勢(shì)：

• 共享組件，節(jié)省了部署、運(yùn)維Nacos、Eureka或Consul的成本。

• 在服務(wù)注冊(cè)和發(fā)現(xiàn)的調(diào)用中都進(jìn)行了鏈路加密，保護(hù)您的服務(wù)，無需再擔(dān)心服務(wù)被未授權(quán)的應(yīng)用發(fā)現(xiàn)。

• SAE服務(wù)注冊(cè)中心與SAE其他組件緊密結(jié)合，為您提供一整套的微服務(wù)解決方案，包括環(huán)境隔離、灰度發(fā)布等。

您在SAE部署應(yīng)用時(shí)，SAE服務(wù)注冊(cè)中心以高優(yōu)先級(jí)自動(dòng)設(shè)置Nacos Server服務(wù)端地址和服務(wù)端口，以及命名空間、AccessKey、Context-path等信息，無需進(jìn)行任何額外的配置。

準(zhǔn)備工作

• 下載Maven并設(shè)置環(huán)境變量。

• 啟動(dòng)Nacos Server。

  1. 下載并解壓Nacos Server。

  2. 進(jìn)入nacos/bin目錄，啟動(dòng)Nacos Server。

     • Linux、Unix、macOS系統(tǒng)：執(zhí)行命令sudo sh startup.sh -m standalone。

     • Windows系統(tǒng)：執(zhí)行命令startup.cmd -m standalone。

     說明

     standalone表示單機(jī)模式運(yùn)行，非集群模式。startup.cmd文件默認(rèn)以集群模式啟動(dòng)，因此您在使用Windows系統(tǒng)時(shí)，如果直接雙擊執(zhí)行startup.cmd文件會(huì)導(dǎo)致啟動(dòng)失敗，此時(shí)需要在startup.cmd文件內(nèi)設(shè)置MODE="standalone"。 更多信息，請(qǐng)參見Nacos快速開始。

步驟一：創(chuàng)建服務(wù)提供者

在本地創(chuàng)建服務(wù)提供者應(yīng)用工程，添加依賴，開啟服務(wù)注冊(cè)與發(fā)現(xiàn)功能，并將注冊(cè)中心指定為Nacos Server。

1. 創(chuàng)建命名為nacos-service-provider的Maven工程。

2. 在pom.xml文件中添加依賴。

   具體示例，請(qǐng)參見nacos-service-provider。本文以Spring Boot 2.1.4.RELEASE和Spring Cloud Greenwich.SR1為例，依賴如下：

   說明

   不支持Spring Boot 2.4及以上版本。支持Spring Cloud Alibaba2.2.6.RELEASE版本（1.4.2客戶端版本）。

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>2.1.4.RELEASE</version>
       <relativePath/>
   </parent>
   
   <dependencies>
       <dependency>
           <groupId>com.alibaba.cloud</groupId>
           <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
           <version>2.1.0.RELEASE</version>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
   </dependencies>
   
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-dependencies</artifactId>
               <version>Greenwich.SR1</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>                  

   示例中使用的版本為Spring Cloud Greenwich，對(duì)應(yīng)Spring Cloud Alibaba版本為2.1.1.RELEASE。

   • 如果使用Spring Cloud Finchley版本，對(duì)應(yīng)Spring Cloud Alibaba版本為2.0.1.RELEASE。

   • 如果使用Spring Cloud Edgware版本，對(duì)應(yīng)Spring Cloud Alibaba版本為1.5.1.RELEASE。

     說明

     Spring Cloud Edgware版本的生命周期已結(jié)束，不推薦使用該版本開發(fā)應(yīng)用。

3. 在src\main\java下創(chuàng)建Packagecom.aliware.edas。

4. 在Packagecom.aliware.edas中創(chuàng)建服務(wù)提供者的啟動(dòng)類ProviderApplication，并添加以下代碼。

   其中@EnableDiscoveryClient注解表明此應(yīng)用需開啟服務(wù)注冊(cè)與發(fā)現(xiàn)功能。

       package com.aliware.edas;
   
       import org.springframework.boot.SpringApplication;
       import org.springframework.boot.autoconfigure.SpringBootApplication;
       import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
   
       @SpringBootApplication
       @EnableDiscoveryClient
       public class ProviderApplication {
   
           public static void main(String[] args) {
               SpringApplication.run(ProviderApplication.class, args);
           }
       }             

5. 在Packagecom.aliware.edas中創(chuàng)建EchoController。

   EchoController中，指定URL mapping為/echo/{string} ，指定HTTP方法為GET，從URL路徑中獲取方法參數(shù)，并回顯收到的參數(shù)。

       package com.aliware.edas;
   
       import org.springframework.web.bind.annotation.PathVariable;
       import org.springframework.web.bind.annotation.RequestMapping;
       import org.springframework.web.bind.annotation.RequestMethod;
       import org.springframework.web.bind.annotation.RestController;
   
       @RestController
       public class EchoController {
           @RequestMapping(value = "/echo/{string}", method = RequestMethod.GET)
           public String echo(@PathVariable String string) {
               return string;
           }
       }              

6. 在src\main\resources路徑下創(chuàng)建文件application.properties，在application.properties中添加如下配置，指定Nacos Server的地址。

       spring.application.name=service-provider
       server.port=18081
       spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848               

   其中127.0.0.1為Nacos Server的地址。如果您的Nacos Server部署在另外一臺(tái)機(jī)器，則需要修改成對(duì)應(yīng)的IP地址。如果有其它需求，可以在application.properties文件中增加配置。更多信息，請(qǐng)參見配置項(xiàng)參考。

7. 驗(yàn)證結(jié)果。

   1. 執(zhí)行nacos-service-provider中ProviderApplication的main函數(shù)，啟動(dòng)應(yīng)用。

   2. 登錄本地啟動(dòng)的Nacos Server控制臺(tái)http://127.0.0.1:8848/nacos。

      本地Nacos控制臺(tái)的默認(rèn)用戶名和密碼同為nacos。

   3. 在左側(cè)導(dǎo)航欄，選擇服務(wù)管理 > 服務(wù)列表。

      可以看到服務(wù)列表中已經(jīng)包含了service-provider，且在詳情中可以查詢?cè)摲?wù)的詳情。

步驟二：創(chuàng)建服務(wù)消費(fèi)者

本節(jié)除介紹服務(wù)注冊(cè)的功能，還將介紹Nacos服務(wù)與RestTemplate和FeignClient兩個(gè)客戶端如何配合使用。

1. 創(chuàng)建命名為nacos-service-consumer的Maven工程。

2. 在pom.xml中添加依賴。

   具體示例，請(qǐng)參見nacos-service-consumer。

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>2.1.4.RELEASE</version>
       <relativePath/>
   </parent>
   
   <dependencies>
       <dependency>
           <groupId>com.alibaba.cloud</groupId>
           <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
           <version>2.1.0.RELEASE</version>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
       <dependency>
           <groupId>org.springframework.cloud</groupId>
           <artifactId>spring-cloud-starter-openfeign</artifactId>
       </dependency>
   </dependencies>
   
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-dependencies</artifactId>
               <version>Greenwich.SR1</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>        

3. 在src\main\java下創(chuàng)建Packagecom.aliware.edas。

4. 在Packagecom.aliware.edas中配置RestTemplate和FeignClient。

   1. 在Packagecom.aliware.edas中創(chuàng)建一個(gè)接口類EchoService，添加@FeignClient注解，并配置對(duì)應(yīng)的HTTP URL地址及HTTP方法。

      package com.aliware.edas;
      
      import org.springframework.cloud.openfeign.FeignClient;
      import org.springframework.web.bind.annotation.PathVariable;
      import org.springframework.web.bind.annotation.RequestMapping;
      import org.springframework.web.bind.annotation.RequestMethod;
      
      @FeignClient(name = "service-provider")
      public interface EchoService {
          @RequestMapping(value = "/echo/{str}", method = RequestMethod.GET)
          String echo(@PathVariable("str") String str);
      }                   

   2. 在Packagecom.aliware.edas中創(chuàng)建啟動(dòng)類ConsumerApplication并添加相關(guān)配置。

      • 使用@EnableDiscoveryClient注解啟用服務(wù)注冊(cè)與發(fā)現(xiàn)。

      • 使用@EnableFeignClients注解激活FeignClient。

      • 添加@LoadBalanced注解將RestTemplate與服務(wù)發(fā)現(xiàn)集成。

      package com.aliware.edas;
      
      import org.springframework.boot.SpringApplication;
      import org.springframework.boot.autoconfigure.SpringBootApplication;
      import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
      import org.springframework.cloud.client.loadbalancer.LoadBalanced;
      import org.springframework.cloud.openfeign.EnableFeignClients;
      import org.springframework.context.annotation.Bean;
      import org.springframework.web.client.RestTemplate;
      
      @SpringBootApplication
      @EnableDiscoveryClient
      @EnableFeignClients
      public class ConsumerApplication {
      
          @LoadBalanced
          @Bean
          public RestTemplate restTemplate() {
              return new RestTemplate();
          }
      
          public static void main(String[] args) {
              SpringApplication.run(ConsumerApplication.class, args);
          }
      }

5. 在Packagecom.aliware.edas中創(chuàng)建類TestController以演示和驗(yàn)證服務(wù)發(fā)現(xiàn)功能。

       package com.aliware.edas;
   
       import org.springframework.beans.factory.annotation.Autowired;
       import org.springframework.web.bind.annotation.PathVariable;
       import org.springframework.web.bind.annotation.RequestMapping;
       import org.springframework.web.bind.annotation.RequestMethod;
       import org.springframework.web.bind.annotation.RestController;
       import org.springframework.web.client.RestTemplate;
   
       @RestController
       public class TestController {
   
           @Autowired
           private RestTemplate restTemplate;
           @Autowired
           private EchoService echoService;
   
           @RequestMapping(value = "/echo-rest/{str}", method = RequestMethod.GET)
           public String rest(@PathVariable String str) {
               return restTemplate.getForObject("http://service-provider/echo/" + str,
                       String.class);
           }
   
           @RequestMapping(value = "/echo-feign/{str}", method = RequestMethod.GET)
           public String feign(@PathVariable String str) {
               return echoService.echo(str);
           }
   
       }           

6. 在src\main\resources路徑下創(chuàng)建文件application.properties，在application.properties中添加以下配置，指定Nacos Server的地址。

       spring.application.name=service-consumer
       server.port=18082
       spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

   其中127.0.0.1為Nacos Server的地址。如果您的Nacos Server部署在另外一臺(tái)機(jī)器，則需要修改成對(duì)應(yīng)的IP地址。如果有其它需求，可以在application.properties文件中增加配置。更多信息，請(qǐng)參見配置項(xiàng)參考。

7. 驗(yàn)證結(jié)果。

   1. 執(zhí)行nacos-service-consumer中ConsumerApplication的main函數(shù)，啟動(dòng)應(yīng)用。

   2. 登錄本地啟動(dòng)的Nacos Server控制臺(tái)http://127.0.0.1:8848/nacos。

      本地Nacos控制臺(tái)的默認(rèn)用戶名和密碼同為nacos。

   3. 在左側(cè)導(dǎo)航欄，選擇服務(wù)管理 > 服務(wù)列表，可以看到服務(wù)列表中已經(jīng)包含了service-consumer，且在詳情中可以查詢?cè)摲?wù)的詳情。

步驟三：本地測(cè)試

在本地測(cè)試消費(fèi)者對(duì)提供者的服務(wù)調(diào)用結(jié)果。

• Linux、Unix、macOS系統(tǒng)：運(yùn)行以下命令。

  curl http://127.0.0.1:18082/echo-rest/rest-rest
  curl http://127.0.0.1:18082/echo-feign/feign-rest

• Windows系統(tǒng)：在瀏覽器中輸入http://127.0.0.1:18082/echo-rest/rest-rest和http://127.0.0.1:18082/echo-feign/feign-rest。

步驟四：將應(yīng)用部署到SAE

當(dāng)您將應(yīng)用部署到SAE時(shí)，SAE服務(wù)注冊(cè)中心會(huì)以更高優(yōu)先級(jí)去設(shè)置Nacos Server服務(wù)端地址和服務(wù)端口，以及命名空間、AccessKey、Context-path信息。您無需進(jìn)行任何額外的配置，原有的配置內(nèi)容可以選擇保留或刪除。

步驟五：結(jié)果驗(yàn)證

1. 為部署到SAE的應(yīng)用綁定SLB。具體步驟，請(qǐng)參見為應(yīng)用綁定CLB。

2. 在瀏覽器輸入配置好的公網(wǎng)訪問地址，并在應(yīng)用首頁發(fā)起調(diào)用請(qǐng)求。

3. 在SAE控制臺(tái)查看服務(wù)調(diào)用數(shù)據(jù)。

   1. 登錄SAE控制臺(tái)。

   2. 在左側(cè)導(dǎo)航欄，選擇應(yīng)用管理 > 應(yīng)用列表，在頂部菜單欄選擇地域，然后單擊具體應(yīng)用名稱。

   3. 在消費(fèi)者應(yīng)用基本信息頁面的左側(cè)導(dǎo)航欄，選擇應(yīng)用監(jiān)控 > 應(yīng)用總覽，查看服務(wù)調(diào)用數(shù)據(jù)總覽。

   如果能夠監(jiān)測(cè)到調(diào)用數(shù)據(jù)，說明服務(wù)調(diào)用成功。

配置項(xiàng)參考

更多關(guān)于Spring Cloud Alibaba Nacos Discovery的信息，請(qǐng)參見開源版本的Nacos Discovery。