自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-server
和alibaba-nacos-discovery-client-common
項目: