Nacos入门指南02 - 环境搭建
你好，欢迎阅读，本文是系列文章中的第2篇。
Part1 - Nacos 是什么？
Part2 - Nacos 环境搭建
Part3 - Nacos 服务发现实践
Part4 - Nacos 分布式配置实践
本文的目的是把 Nacos 跑起来，并体验一下 Nacos 的 OpenAPI。
1. 环境搭建
有2种方式：
（1）手动编译、启动
（2）使用 Docker 容器
1.1 手动编译启动
需要2个步骤：
- 编译 Nacos
- 启动
步骤1 - 编译 Nacos
有2种方式，可以下载源码后自己编译，也可以直接下载官方编译后的。
方式1 - 源码编译
从 GitHub 上下载 Nacos 项目源码，项目地址：
git clone https://github.com/alibaba/nacos.git
下载好项目源码后，进入目录，进行编译：
mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U
第一次编译的时间会很长，需要下载大量的依赖包。
完成后，成果位置：
distribution/target/nacos-server-$version/nacos
小提示：如果在 GitHub 下载速度慢的话，建议到国内的码云下载。 码云同步了 GitHub 中知名项目，所以从这下载会很快。操作如下图。
方式2 - 下载官方编译的包
官方也提供了编译好的压缩包，可以在 GitHub 中直接下载。
在 Nacos 项目首页的右侧，有一个 Releases 部分，点进去。
这就是编译后的压缩包，下载即可。
可惜的是码云中只同步了源码，并没有同步发布页面中的内容，直接在 GitHub 中下载会很慢。
步骤2 - 启动
在 nacos 编译后的目录下执行：
sh bin/startup.sh -m standalone
-m standalone 表示使用单机方式启动，这是最简单的方式，适合我们练习使用。
启动后的效果如下：
Nacos 会在后台启动，最后提示了日志的输出位置。
如果是 Windows 系统，执行 startup.cmd 即可。
1.2 Docker 容器
Nacos 官方提供了 Docker 镜像，可以直接使用：
# 下载 nacos docker 项目
git clone https://github.com/nacos-group/nacos-docker.git
# 单机模式启动
cd nacos-docker
docker-compose -f example/standalone-derby.yaml up
会启动3个容器：
- prometheus，用于采集 nacos 数据，进行监控
- grafana，用于图形化显示监控数据
- nacos-standalone，nacos server
nacos 容器的本机挂载端口为 8848，访问其控制台
http://localhost:8848/nacos
默认的用户名与密码都为 nacos。
2. 体验 Nacos API
下面体验4个主要 API ：
- 注册实例
- 心跳
- 查询服务实例列表
- 注销实例
2.1 注册实例
发送请求：
curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=service-a&ip=192.168.1.1&port=8080'
查看控制台中的服务列表：
已经注册成功了，但 service-a 这个服务实例是不存在的，怎么能注册成功呢？
Nacos 注册中心不管是否真的存在，只要能注册上来，并且一直有心跳就认为此实例是存活的，没心跳就删掉。
2.2 实例心跳
发送请求：
curl -X PUT 'http://127.0.0.1:8848/nacos/v1/ns/instance/beat?serviceName=service-a&beat=%7B%22ip%22:%22192.168.31.1%22,%22port%22:8080%7D'
此接口有2个参数，serviceName 和 beat，其中 beat 的值有点乱，这是因为其值是 JSON 字符串，需要进行 URL 编码，例如：
搜一个在线URL编码网站即可。
2.3 查询服务实例列表
发送请求：
curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=service-a'
返回：
{
"metadata":{
},
"dom":"service-a",
"cacheMillis":3000,
"useSpecifiedURL":false,
"hosts":[
{
"valid":true,
"marked":false,
"metadata":null,
"instanceId":"192.168.31.1#8080#DEFAULT#DEFAULT_GROUP@@service-a",
"port":8080,
"healthy":true,
"ip":"192.168.31.1",
"clusterName":"DEFAULT",
"weight":0,
"ephemeral":true,
"serviceName":"service-a",
"enabled":true
}
],
"name":"DEFAULT_GROUP@@service-a",
"checksum":"2be56e35d79c2cf9982e0b5e19b2bd29",
"lastRefTime":1604222416258,
"env":"",
"clusters":""
}
2.4 注销实例
发送请求：
curl -X DELETE 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=service-a&ip=192.168.31.1&port=8080'
指定服务名、实例IP与端口。
查看控制台的服务列表：
已经空了。