一、安装 nacos 服务器
1.下载 nacos-server
docker pull nacos/nacos-server:v2.0.3
2.启动 nacos-server
(1) 单机启动
MODE:设置使用单机模式
注意:如果服务器是多网卡,配置NACOS_SERVER_IP参数来指定IP,否则可能会导致外网无法访问;
docker run -d -p 8848:8848 --env MODE=standalone --env NACOS_SERVER_IP=192.168.1.208 --name nacos nacos/nacos-server:v2.0.3
启动成功后,访问 http://114.116.119.117:8848/nacos/index.html 默认登录账号密码 nacos/nacos
(2) 集群启动
准备3台服务器;分别执行如下命令;
docker run -d --name nacos-cluster -p 8848:8848 \
--env NACOS_SERVERS=192.168.56.102,192.168.56.104,192.168.56.105 \
--env NACOS_SERVER_IP=192.168.56.102 \
--env SPRING_DATASOURCE_PLATFORM=mysql \
--env MYSQL_SERVICE_HOST=192.168.56.103 \
--env MYSQL_SERVICE_DB_NAME=nacos \
--env MYSQL_SERVICE_USER=root \
--env MYSQL_SERVICE_PASSWORD=123456 \
--env MYSQL_DATABASE_NUM=1 \
nacos/nacos-server
参数说明:
- NACOS_SERVERS : 集群节点信息
- NACOS_SERVER_IP : 服务IP,多网卡模式下建议指定
- SPRING_DATASOURCE_PLATFORM : 使用数据库类型
- MYSQL_SERVICE_HOST : MySQL数据库地址
- MYSQL_SERVICE_DB_NAME : 数据库名称
- MYSQL_SERVICE_DB_NAME : 数据库用户名
- MYSQL_SERVICE_PASSWORD : 数据库密码
- MYSQL_DATABASE_NUM : 数据库数量,默认就是1,可以不填写
二、集成 Nacos
1. 自动刷新配置
(1)引入jar包
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>
版本问题可参考:
1. 版本说明
2. spring-boot、spring-cloud、spring-cloud-alibaba版本对应
注意:引入 nacos管理配置时,要同时引入spring-cloud-starter-bootstrap这个 jar,不引入这个 jar,bootstrap.properties 配置文件不生效,会导致读取不到配置。
(2) nacos自动刷新配置管理详解
新建 bootstrap.properties 代替 application.properties(bootstrap是 application 的父类,项目启动加载配置文件时,先加载父类)
配置如下:
#基础配置信息
spring.application.name=deviceLink
# nacos配置详解参考
# https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-config#%E5%9F%BA%E4%BA%8E-dataid-%E4%B8%BA-yaml-%E7%9A%84%E6%96%87%E4%BB%B6%E6%89%A9%E5%B1%95%E5%90%8D%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F
#=====================nacos 动态刷新配置===============================
# nacos 服务器地址.
# 注意当你使用域名的方式来访问 Nacos 时,spring.cloud.nacos.config.server-addr 配置的方式为 域名:port。
# 例如 Nacos 的域名为abc.com.nacos,监听的端口为 80,则 spring.cloud.nacos.config.server-addr=abc.com.nacos:80。
# 注意 80 端口不能省略。
spring.cloud.nacos.config.server-addr=114.116.119.117:8848
# nacos 配置文件类型
spring.cloud.nacos.config.file-extension=properties
# nacos 空间 ID
spring.cloud.nacos.config.namespace=Iot-Develop-V2
# nacos 获取配置失败重试时间
spring.cloud.nacos.config.config-retry-time=10
# nacos 配置字符格式
spring.cloud.nacos.config.encode=UTF-8
# nacos 连接用户名,默认为 nacos
spring.cloud.nacos.config.username=nacos
# nacos 连接密码,默认为 nacos
spring.cloud.nacos.config.password=nacos
# 从nacos server获取配置最大等待时长
spring.cloud.nacos.config.timeout=3000
# 最大重连 nacos server 次数
spring.cloud.nacos.config.max-retry=10
# nacos 配置所属组,默认DEVELOP_GROUP(为默认值时,不配置此属性,否则会报错)
#spring.cloud.nacos.config.group=dev
# nacos 自动刷新 true:开启(默认) false:关闭
spring.cloud.nacos.config.refresh-enabled=true
(3)添加@RefreshScope 注解
在class 类上添加@RefreshScope 标签。当 nacos 中修改 downloadExcelUrl 的值时,运行的项目会同步修改对应的值。
2. 服务注册与发现
(1)引入jar包
<!--Nacos-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
版本问题可参考:
1. 版本说明
2. spring-boot、spring-cloud、spring-cloud-alibaba版本对应
(2) nacos 服务注册发现配置详解
#==========================nacos 服务注册中心============================
# 详情参考 https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-discovery
spring.cloud.nacos.discovery.server-addr=114.116.119.117:8848
# 空间 ID(服务注册到哪个空间,默认为 public)
spring.cloud.nacos.discovery.namespace=Iot-Develop-V2
# 服务注册与发现,默认为 true开启,如果不使用 nacos为注册中心,设置为 false
spring.cloud.nacos.discovery.enabled=true
# 注册的服务名,默认为spring.application.name的值
spring.cloud.nacos.discovery.service=deviceLink
# 服务分组,默认DEVELOP_GROUP
#spring.cloud.nacos.discovery.group=DEVELOP_GROUP
# nacos客户端向服务端发送心跳的时间间隔,默认5s
# 注,若在3次心跳的间隔时间(默认15s)内服务端没有接受到该实例的心跳请求,则认为该实例不健康,该实例将无法被消费。如果再次经历3次心跳的间隔时间,服务端接受到该实例的请求,那么会立刻将其设置为健康,并可以被消费,若未接受到,则删除该实例的注册信息。推荐配置为5s,如果有的业务线希望服务下线或者出故障时希望尽快被发现,可以适当减少该值。
spring.cloud.nacos.discovery.heart-beat-interval=5000
#服务端没有接受到客户端心跳请求就将其设为不健康的时间间隔,默认为15s
#注:推荐值该值为15s即可,如果有的业务线希望服务下线或者出故障时希望尽快被发现,可以适当减少该值。
spring.cloud.nacos.discovery.heart-beat-timeout=15000
#客户端在启动时读取本地配置项(一个文件)来获取服务列表,默认为false(不读)。
#注:推荐该值为false,若改成true。则客户端会在本地的一个文件中保存服务信息,当下次宕机启动时,会优先读取本地的配置对外提供服务。
spring.cloud.nacos.discovery.naming-load-cache-at-start=false
#该项目是否向注册中心注册服务,默认为true
#注:如果服务从注册中心只消费服务,没有对外提供服务,那么该值可设置为false,可减少客户端线程池的创建,无需向服务端发送心跳请求,提高性能。
spring.cloud.nacos.discovery.register-enabled=true
#默认为true,客户端在启动时会创建一个线程池,该线程定期去查询服务端的信息列表,该请求不会立刻返回,默认等待时长为spring.cloud.nacos.discovery.watch-delay值 30S,若在30s内,服务端信息列表发生变化,则该请求立刻返回,通知客户端拉取服务端的服务信息列表,若30s内,没有变化,则30s时该请求返回响应,客户端服务列表不变,再次发生该请求。
#注:推荐该功能为true,这是nacos类似长连接推送服务变化的功能,不要关闭
spring.cloud.nacos.discovery.watch.enabled=true
#注:推荐该值为30s即可,无需修改
spring.cloud.nacos.discovery.watch-delay=30000
#nacos支持服务端基于权重的负载均衡,该值默认为1,取值范围 1——100,越大转发到该实例的请求越多。
spring.cloud.nacos.discovery.weight=1
(3)添加 @EnableDiscoveryClient 注解
在启动类 ***Application 上添加 @EnableDiscoveryClient 注解,开启服务注册与发现相关功能。