Serverless App Engine：將應用的服務註冊與發現中心更改為Nacos

為什麼託管到SAE

原依賴Eureka、Consul、ZooKeeper和Redis等組件實現服務註冊與發現的Spring Cloud應用，如果需要部署至SAE，僅需將原服務註冊與發現中心和配置中心替換為Alibaba Nacos Discovery，無需修改任何業務代碼。

SAE服務註冊中心具有Spring Cloud Alibaba Nacos Discovery所有功能，SAE服務註冊中心可以完全代替Eureka、Consul、ZooKeeper和Redis等，作為您微服務應用的服務註冊中心。

將Spring Cloud應用託管到SAE，您僅需關注Spring Cloud應用自身的邏輯，無需再關注註冊中心和配置中心的搭建和維護，託管後還可以使用SAE提供的Auto Scaling、一鍵批量啟停、應用監控等功能，大幅度降低開發和營運成本。

步驟一：擷取Demo

步驟二：修改Provider應用的服務註冊與發現配置

將雲原生的Provider應用託管到SAE中，需要在應用程式中修改pom依賴，並指定Nacos Server的IP地址。

1. 添加pom依賴。

   開啟應用的pom.xml檔案，將spring-cloud-starter-netflix-eureka-client替換成為spring-cloud-starter-alibaba-nacos-discovery，並設定Nacos Server的版本資訊。

   替換前：

   <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
   </dependency>                            

   替換後：

   <dependency>
       <groupId>com.alibaba.cloud</groupId>
       <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
       <version>2.1.1.RELEASE</version>
   </dependency>                           

   說明

   • 樣本中使用的版本是Spring Cloud Greenwich，對應spring-cloud-starter-alibaba-nacos-discovery的版本為2.1.1.RELEASE。

   • 如果您使用的是Spring Cloud Finchley版本，對應spring-cloud-starter-alibaba-nacos-discovery的版本為2.0.1.RELEASE。

   • 如果您使用的是Spring Cloud Edgware版本，對應spring-cloud-starter-alibaba-nacos-discovery的版本為1.5.1.RELEASE。該版本的生命週期已結束，因此不推薦使用該版本。更多資訊，請參見Spring Cloud Edgware Release Notes。

2. 指定Nacos Server的IP地址。

   開啟src\main\resources路徑下的application.properties檔案，指定Nacos Server的IP地址。

   修改前：

   spring.application.name=service-provider
   server.port=18081
   eureka.client.serviceUrl.defaultZone=http://127.0.0.1:8761/eureka/                            

   修改後：

   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的IP地址。如果Nacos Server部署在其他機器上，則需要修改為對應的IP地址。如果有其他需求，請參見配置項參考在application.properties檔案中增加所需配置。

3. 查詢應用服務。

   1. 執行nacos-service-provider中ProviderApplication的main函數，啟動應用。

   2. 登入本地啟動的Nacos Server控制台127.0.0.1:8848/nacos，在左側導覽列中選擇服務管理 > 服務列表。

      說明

      本地Nacos Server控制台的預設使用者名和密碼均為nacos。

      如果服務列表中顯示service-provider，且在詳情中可以查詢該服務的詳細資料，那麼表示服務註冊成功。

步驟三：修改Consumer應用的服務註冊與發現配置

將雲原生的Consumer應用託管到SAE中，需要在應用程式中修改pom依賴，並指定Nacos Server的IP地址。

1. 添加pom依賴。

   開啟應用的pom.xml檔案，將spring-cloud-starter-netflix-eureka-client替換成為spring-cloud-starter-alibaba-nacos-discovery，並設定Nacos Server的版本資訊。

   替換前：

   <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
   </dependency>                            

   替換後：

   <dependency>
       <groupId>com.alibaba.cloud</groupId>
       <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
       <version>2.1.1.RELEASE</version>
   </dependency>                           

   說明

   • 樣本中使用的版本是Spring Cloud Greenwich，對應spring-cloud-starter-alibaba-nacos-discovery的版本為2.1.1.RELEASE。

   • 如果您使用的是Spring Cloud Finchley版本，對應spring-cloud-starter-alibaba-nacos-discovery的版本為2.0.1.RELEASE。

   • 如果您使用的是Spring Cloud Edgware版本，對應spring-cloud-starter-alibaba-nacos-discovery的版本為1.5.1.RELEASE。該版本的生命週期已結束，因此不推薦使用該版本。更多資訊，請參見Spring Cloud Edgware Release Notes。

2. 指定Nacos Server的IP地址。

   開啟src\main\resources路徑下的application.properties檔案，指定Nacos Server的IP地址。

   修改前：

   spring.application.name=service-consumer
   server.port=18082
   eureka.client.serviceUrl.defaultZone=http://127.0.0.1:8761/eureka/                            

   修改後：

   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的IP地址。如果Nacos Server部署在其他機器上，則需要修改為對應的IP地址。如果有其他需求，請參見配置項參考在application.properties檔案中增加所需配置。

3. 查詢應用服務。

   1. 執行nacos-service-consumer中ConsumerApplication的main函數，啟動應用。

   2. 登入本地啟動的Nacos Server控制台127.0.0.1:8848/nacos，在左側導覽列中選擇服務管理 > 服務列表。

      說明

      本地Nacos Server控制台的預設使用者名和密碼均為nacos。

      如果服務列表中顯示service-consumer，且在詳情中可以查詢該服務的詳情，那麼表示服務註冊成功。

步驟四：查看Provider與Consumer的調用結果

在本地查看Consumer對Provider的服務調用結果。啟動服務，執行IP+port/echo-rest/{自訂變數}或IP+port/echo-feign/{自訂變數}查看調用結果。

• Linux、Unix、macOS系統：執行curl http://127.0.0.1:18082/echo-rest/{自訂變數}或curl http://127.0.0.1:18082/echo-feign/{自訂變數}。

• Windows系統：在瀏覽器中輸入http://127.0.0.1:18082/echo-rest/{自訂變數}或http://127.0.0.1:18082/echo-feign/{自訂變數}。

樣本：以Windows系統為例，當顯示以下結果時，表示Provider與Consumer業務調用成功。

步驟五：將應用部署到SAE

本文將通過樣本說明如何在本地將程式編譯成JAR包。此外，您還可以選擇將該程式製作成鏡像並進行部署。

1. 在應用的pom.xml檔案中添加應用程式的打包配置，添加完成後執行mvn clean package命令將本地的程式編譯成可執行檔JAR包。

   <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>                        

2. 將編譯好的Provider和Consumer應用程式套件部署至SAE。具體操作，請參見使用JAR包部署Java應用。

   重要

   • SAE不支援建立空應用，因此第一次部署需在控制台完成。

   • 如果使用JAR包部署，在應用部署配置時選擇應用運行環境為標準Java應用運行環境。

   • 如果使用WAR包部署，在應用部署配置時應用運行環境為apache-tomcat-XXX。

   當您將應用部署到SAE時，SAE服務註冊中心以高優先順序自動化佈建Nacos Server服務端地址和服務連接埠，以及命名空間、AccessKey ID、AccessKey Secret等資訊，您無需進行任何額外的配置。對於原有的配置內容您可以保留或刪除。

步驟六：結果驗證

1. 為Consumer應用綁定公網CLB，並在瀏覽器鍵入所設定的公網訪問地址，進入應用首頁。具體操作，請參見為應用綁定CLB並產生應用的公網或私網訪問IP。

2. 在應用首頁發起調用請求，然後登入SAE控制台，在左側導覽列，選擇應用管理 > 應用列表，在頂部功能表列，選擇地區。

3. 在應用列表頁面，選擇Consumer應用，進入基本資料頁面。

4. 在左側導覽列，選擇應用監控 > 應用總覽，查看服務調用資料總覽。

   如果能夠檢測到調用資料，則說明服務調用成功。

配置項參考

更多關於Spring Cloud Alibaba Nacos Discovery的資訊，請參見開源版本的Spring Cloud Alibaba Nacos Discovery。

更多資訊

應用建立完成後，您可以對應用進行以下操作。

• 預設情況下，用戶端無法從公網訪問應用，應用也無法主動訪問公網的資源或服務。如果您需要為應用配置網路訪問，請參見應用訪問。

• 更多操作，請參見營運管理。