Spring Cloud Alibaba基礎教程:使用Nacos實現服務注冊與發現


自Spring Cloud Alibaba發布第一個Release以來,就備受國內開發者的高度關注。雖然Spring Cloud Alibaba還沒能納入Spring Cloud的主版本管理中,但是憑借阿里中間件團隊的背景,還是得到不少團隊的支持;同時,由於Spring Cloud Alibaba中的幾項主要功能都直指Netflix OSS中的重要組件,而后者最近頻繁宣布各組件不在更新新特性,這使得Spring Cloud Alibaba關注度不斷飆升,不少開發者或團隊也開始小范圍試水。筆者對此也進行了一段時間的調研與試水,接下來計划以《Spring Cloud Alibaba基礎教程》為主題,為大家完成一套快速入門的免費內容,以支持開源社區的發展! ^_^

更多關於Spring Cloud Alibaba的介紹可見:《Spring Cloud 加盟重量級成員Spring Cloud Alibaba,打造更符合中國國情的微服務體系》

什么是Nacos

Nacos致力於幫助您發現、配置和管理微服務。Nacos提供了一組簡單易用的特性集,幫助您快速實現動態服務發現、服務配置、服務元數據及流量管理。Nacos幫助您更敏捷和容易地構建、交付和管理微服務平台。Nacos是構建以“服務”為中心的現代應用架構 (例如微服務范式、雲原生范式) 的服務基礎設施。

在接下里的教程中,將使用Nacos作為微服務架構中的注冊中心(替代:eurekba、consul等傳統方案)以及配置中心(spring cloud config)來使用。

安裝Nacos

補充(2019-04-28):本文案例已升級Spring Cloud Alibaba 0.2.2,同時Nacos版本升級到第一個正式生產版本1.0.0

下載地址:https://github.com/alibaba/nacos/releases
本文版本:1.0.0

下載完成之后,解壓。根據不同平台,執行不同命令,啟動單機版Nacos服務:

  • Linux/Unix/Mac:
    sh startup.sh -m standalone

     

  • Windows:
    cmd startup.cmd -m standalone

     

startup.sh腳本位於Nacos解壓后的bin目錄下。這里主要介紹Spring Cloud與Nacos的集成使用,對於Nacos的高級配置,后續再補充。所以,持續關注我的博客或者公眾號吧!

啟動完成之后,訪問:http://127.0.0.1:8848/nacos/,可以進入Nacos的服務管理頁面,具體如下;

補充(2019-01-23):如果使用Nacos 0.8.0以上版本,會出現登錄頁面,默認用戶名密碼為:nacos

構建應用接入Nacos注冊中心

在完成了Nacos服務的安裝和啟動之后,下面我們就可以編寫兩個應用(服務提供者與服務消費者)來驗證服務的注冊與發現了。

服務提供者

第一步:創建一個Spring Boot應用,可以命名為:alibaba-nacos-discovery-server。如果您還不會或者不了解Spring Boot應用,建議先學習《Spring Boot基礎教程》

第二步:編輯pom.xml,加入必要的依賴配置,比如:

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.5.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Finchley.SR1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>0.2.2.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.2</version>
        <optional>true</optional>
    </dependency>
</dependencies>

 

parent:定義spring boot的版本上述內容主要三部分:

  • dependencyManagement:spring cloud的版本以及spring cloud alibaba的版本,由於spring cloud alibaba還未納入spring cloud的主版本管理中,所以需要自己加入
  • dependencies:當前應用要使用的依賴內容。這里主要新加入了Nacos的服務注冊與發現模塊:spring-cloud-starter-alibaba-nacos-discovery。由於在dependencyManagement中已經引入了版本,所以這里就不用指定具體版本了。

第三步:創建應用主類,並實現一個HTTP接口:

@EnableDiscoveryClient
@SpringBootApplication
public class TestApplication {

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

    @Slf4j
    @RestController
    static class TestController {
        @GetMapping("/hello")
        public String hello(@RequestParam String name) {
            log.info("invoked name = " + name);
            return "hello " + name;
        }
    }
}

 

第四步:配置服務名稱和Nacos地址內容非常簡單,@SpringBootApplication定義是個Spring Boot應用;@EnableDiscoveryClient開啟Spring Cloud的服務注冊與發現,由於這里引入了spring-cloud-starter-alibaba-nacos-discovery模塊,所以Spring Cloud Common中定義的那些與服務治理相關的接口將使用Nacos的實現。這點不論我們使用Eureka、Consul還是其他Spring Cloud整合的注冊中心都一樣,這也是Spring Cloud做了封裝的好處所在,如果對Eureka、Consul這些注冊中心的整合還不熟悉的可以看看以前的這篇:Spring Cloud構建微服務架構:服務注冊與發現(Eureka、Consul)

spring.application.name=alibaba-nacos-discovery-server
server.port=8001

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

 

在應用啟動好之后,我們可以在控制台或日志中看到如下內容,代表已經注冊成功:第五步:啟動上面創建的應用。可以在啟動時候增加-Dserver.port=8001的形式在本機的不同端口上啟動多個實例。

INFO 10476 --- [           main] o.s.c.a.n.registry.NacosServiceRegistry  : nacos registry, alibaba-nacos-discovery-server 10.123.18.216:8001 register finished

 

在啟動都ok之后,我們可以訪問Nacos的管理頁面http://127.0.0.1:8848/nacos/來查看服務列表,此時可以看到如下內容:

這里會顯示當前注冊的所有服務,以及每個服務的集群數目、實例數、健康實例數。點擊詳情,我們還能看到每個服務具體的實例信息,如下圖所示:

服務消費者

接下來,實現一個應用來消費上面已經注冊到Nacos的服務。

第一步:創建一個Spring Boot應用,命名為:alibaba-nacos-discovery-client-common

第二步:編輯pom.xml中的依賴內容,與上面服務提供者的一樣即可。

第三步:創建應用主類,並實現一個HTTP接口,在該接口中調用服務提供方的接口。

@EnableDiscoveryClient
@SpringBootApplication
public class TestApplication {

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

    @Slf4j
    @RestController
    static class TestController {

        @Autowired
        LoadBalancerClient loadBalancerClient;

        @GetMapping("/test")
        public String test() {
            // 通過spring cloud common中的負載均衡接口選取服務提供節點實現接口調用
            ServiceInstance serviceInstance = loadBalancerClient.choose("alibaba-nacos-discovery-server");
            String url = serviceInstance.getUri() + "/hello?name=" + "didi";
            RestTemplate restTemplate = new RestTemplate();
            String result = restTemplate.getForObject(url, String.class);
            return "Invoke : " + url + ", return : " + result;
        }
    }
}

 

第四步:配置服務名稱和Nacos地址,讓服務消費者可以發現上面已經注冊到Nacos的服務。這里使用了Spring Cloud Common中的LoadBalancerClient接口來挑選服務實例信息。然后從挑選出的實例信息中獲取可訪問的URI,拼接上服務提供方的接口規則來發起調用。

spring.application.name=alibaba-nacos-discovery-client-common
server.port=9000

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

 

$ curl localhost:9000/test
Invoke : http://10.123.18.216:8001/hello?name=didi, return : hello didi
$ curl localhost:9000/test
Invoke : http://10.123.18.216:8002/hello?name=didi, return : hello didi

 

可以看到,兩次不同請求的時候,真正實際調用的服務提供者實例是不同的,也就是說,通過LoadBalancerClient接口在獲取服務實例的時候,已經實現了對服務提供方實例的負載均衡。但是很明顯,這樣的實現還是比較繁瑣,預告下后面的幾篇,關於服務消費的幾種不同姿勢。第五步:啟動服務消費者,然后通過curl或者postman等工具發起訪問,下面以curl為例:

參考資料

代碼示例

本文示例讀者可以通過查看下面倉庫的中的alibaba-nacos-discovery-serveralibaba-nacos-discovery-client-common項目:


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM