天天看點

spring cloud nacos服務注冊和消費前言Nacos sever 快速開始(Nacos中文官網手冊)Spring cloud 服務提供方

前言

Nacos sever 快速開始(Nacos中文官網手冊)

這個快速開始手冊是幫忙您快速在您的電腦上,下載下傳、安裝并使用 Nacos。官網位址(https://nacos.io/zh-cn/docs/quick-start.html)

0.版本選擇

您可以在Nacos的release notes及部落格中找到每個版本支援的功能的介紹,目前推薦的穩定版本為1.2.1。

1.預備環境準備

Nacos 依賴 Java 環境來運作。如果您是從代碼開始建構并運作Nacos,還需要為此配置 Maven環境,請確定是在以下版本環境中安裝使用:

64 bit OS,支援 Linux/Unix/Mac/Windows,推薦選用 Linux/Unix/Mac。

64 bit JDK 1.8+;下載下傳 & 配置。

Maven 3.2.x+;下載下傳 & 配置。

2.下載下傳源碼或者安裝包

你可以通過源碼和發行包兩種方式來擷取 Nacos。

從 Github 上下載下傳源碼方式

git clone https://github.com/alibaba/nacos.git

cd nacos/

mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U

ls -al distribution/target/

// change the v e r s i o n t o y o u r a c t u a l p a t h c d d i s t r i b u t i o n / t a r g e t / n a c o s − s e r v e r − version to your actual path cd distribution/target/nacos-server- versiontoyouractualpathcddistribution/target/nacos−server−version/nacos/bin

下載下傳編譯後壓縮包方式

您可以從 最新穩定版本 下載下傳 nacos-server-$version.zip 包。

unzip nacos-server- v e r s i o n . z i p 或 者 t a r − x v f n a c o s − s e r v e r − version.zip 或者 tar -xvf nacos-server- version.zip或者tar−xvfnacos−server−version.tar.gz

cd nacos/bin

3.啟動伺服器

Linux/Unix/Mac

啟動指令(standalone代表着單機模式運作,非叢集模式):

sh startup.sh -m standalone

如果您使用的是ubuntu系統,或者運作腳本報錯提示[[符号找不到,可嘗試如下運作:

bash startup.sh -m standalone

Windows

啟動指令:

cmd startup.cmd

或者輕按兩下startup.cmd運作檔案。

4.服務注冊&發現和配置管理

服務注冊

curl -X POST ‘http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080’

服務發現

curl -X GET ‘http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName’

釋出配置

curl -X POST “http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld”

擷取配置

curl -X GET “http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test”

5.關閉伺服器

Linux/Unix/Mac

sh shutdown.sh

Windows

cmd shutdown.cmd

或者輕按兩下shutdown.cmd運作檔案。

Spring cloud 服務提供方

環境

jdk1.8

spring boot 2.2.0.RELEASE

spring cloud Hoxton.SR4

nocas 2.2.1.RELEASE

注意:版本 2.1.x.RELEASE 對應的是 Spring Boot 2.1.x 版本。版本 2.0.x.RELEASE 對應的是 Spring Boot 2.0.x 版本,版本 1.5.x.RELEASE 對應的是 Spring Boot 1.5.x 版本。

更多版本對應關系參考:https://github.com/alibaba/spring-cloud-alibaba/wiki/%E7%89%88%E6%9C%AC%E8%AF%B4%E6%98%8E

依賴

<!-- spring cloud -->
		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-dependencies</artifactId>
			<version>Hoxton.SR4</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>

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

在 application.properties 中配置 Nacos server 的位址和應用名

spring.application.name=nocas-example
//(也可以配置)如果nacos在伺服器上面,把下面的ip位址改成伺服器的ip位址既可以了
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848//部署在本地
           

說明:之是以需要配置 spring.application.name ,是因為它是構成 Nacos 配置管理 dataId字段的一部分。

在 Nacos Spring Cloud 中,dataId 的完整格式如下:

  1. prefix 預設為 spring.application.name 的值,也可以通過配置項spring.cloud.nacos.config.prefix來配置。
  2. spring.profile.active 即為目前環境對應的 profile,詳情可以參考 spring boot文檔 注意:當spring.profile.active 為空時,對應的連接配接符 - 也将不存在,dataId 的拼接格式變成 p r e f i x . {prefix}. prefix.{file-extension}
  3. file-exetension 為配置内容的資料格式,可以通過配置項spring.cloud.nacos.config.file-extension 來配置。目前隻支援 properties 和 yaml

    類型。

    然後在Spring Boot的啟動檔案NacosApplication加上@EnableDiscoveryClient注解,代碼如下:

@SpringBootApplication
@EnableDiscoveryClient
public class NacosApplication{

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

}
           
spring cloud nacos服務注冊和消費前言Nacos sever 快速開始(Nacos中文官網手冊)Spring cloud 服務提供方

如果看到這句話就說明向nacos已經注冊成功了 上面的ip就是自己的ip

spring cloud nacos服務注冊和消費前言Nacos sever 快速開始(Nacos中文官網手冊)Spring cloud 服務提供方

提供一個接口服務接口

/**
	 * 查詢所有使用者的資訊
	 */
	@RequestMapping(value = "/getUserList", method = RequestMethod.POST, produces = "application/json;charset=UTF-8")
	public JtsResult<List<User>> getUserList(HttpServletRequest request, HttpServletResponse response, @RequestBody User user) {
		List<User> users=userService.getList(user);
		JtsResult<List<User>> result = JtsResultUtil.success(users);
		return result;
	}
           
spring cloud nacos服務注冊和消費前言Nacos sever 快速開始(Nacos中文官網手冊)Spring cloud 服務提供方

服務消費(feign)

環境

jdk1.8

spring cloud Hoxton.SR4

spring boot 2.2.0.RELEASE

spring cloud nocas 2.2.1.RELEASE

spring cloud feign 2.2.0.RELEASE

依賴

<dependency>
		<groupId>org.springframework.cloud</groupId>
		<artifactId>spring-cloud-dependencies</artifactId>
		<version>Hoxton.SR4</version>
		<type>pom</type>
		<scope>import</scope>
	</dependency>

	<!-- spring cloud alibaba -->
	<dependency>
		<groupId>com.alibaba.cloud</groupId>
		<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
		<version>2.2.1.RELEASE</version>
	</dependency>
	
	<!-- spring cloud feign -->
	<dependency>
		<groupId>org.springframework.cloud</groupId>
		<artifactId>spring-cloud-starter-openfeign</artifactId>
		<version>2.2.0.RELEASE</version>
	</dependency>
           

在 application.properties 中配置 Nacos server 的位址和應用名

spring.application.name=nocas-provider
//(也可以配置)如果nacos在伺服器上面,把下面的ip位址改成伺服器的ip位址既可以了
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848//部署在本地
           

然後在Spring Boot的啟動檔案添加@EnableDiscoveryClient和@EnableFeignClients注解

寫一個RemoteApi ,調用nacos-provider的服務,代碼如下:

@FeignClient(name = "nocas-example")
public interface RemoteApi {
	
	
	
	@PostMapping(value = "/xadmin/user/getUserList")
	public JtsResult<List<User>> getUserList(User user);

}
           

寫一個消費API,該API使用RemoteApi 來調用nocas-example的API服務,代碼如下:

/**
	 * 查詢使用者清單
	 */
	@RequestMapping(value = "/getUserList")
	public JtsResult<List<User>> getUserList(HttpServletRequest request, HttpServletResponse response, Folder folder) {
		JtsResult<List<User>> result = RemoteApi.getUserList(new User());
		return result;
	}
           

這樣就可以微服務直接 服務之間的資料交換了。