天天看点

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;
	}
           

这样就可以微服务直接 服务之间的数据交换了。