前言
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 的完整格式如下:
${prefix}-${spring.profile.active}.${file-extension}
- prefix 默认为 spring.application.name 的值,也可以通过配置项spring.cloud.nacos.config.prefix来配置。
- spring.profile.active 即为当前环境对应的 profile,详情可以参考 spring boot文档 注意:当spring.profile.active 为空时,对应的连接符 - 也将不存在,dataId 的拼接格式变成 p r e f i x . {prefix}. prefix.{file-extension}
- 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);
}
}
如果看到这句话就说明向nacos已经注册成功了 上面的ip就是自己的ip
提供一个接口服务接口
/**
* 查询所有用户的信息
*/
@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;
}
服务消费(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;
}
这样就可以微服务直接 服务之间的数据交换了。