综述
最近项目升级使用Spring Cloud Alibaba,在使用nacos的时候发现官方文档写的非常含糊,网上的资料坑也很多,特整理一份给初学者使用
但是对于初学者来说看官网还是非常重要的
https://nacos.io/zh-cn/docs/what-is-nacos.html
什么是Nacos
说人话就是可以把各个服务都注册到注册中心,服务之间就可以使用nacos互相调用;原本在项目的配置文件可以放到nacos中统一管理,本文主要讲配置中心的使用
下载Nacos
https://github.com/alibaba/nacos/releases
在nacos/bin文件夹下执行
启动命令:nohup sh startup.sh -m standalone &
停止命令:./shutdown.sh
启动成功后访问http://127.0.0.1:8848/nacos/index.htm输入账号密码,默认都是nacos
可以执行下面两个命令看看配置中心是否可用
新写了一个配置文件,项目有时候会读取不到,可以重启nacos试试
curl -X POST “http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=example.properties&group=DEFAULT_GROUP&content=HelloWorld”
curl -X POST “http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=example.properties&group=DEFAULT_GROUP&content=HelloWorld”
项目Maven
<!-- https://mvnrepository.com/artifact/com.alibaba.cloud/spring-cloud-starter-alibaba-nacos-discovery -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
<version>2.1.1.RELEASE</version>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
<version>2.1.1.RELEASE</version>
</dependency>
项目配置
需要在原本 application.yml 处新建一个 bootstrap.yml
文件,它会比application.yml文件先执行。
项目配置使用需要一个格式
官方原文
在 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 类型。
翻译一下就是需要一个三段的格式
server-name-dev.yml
这个名字就是后面要在nacos里创建的 Data ID
spring:
application:
name: service-name #这里就是你要注册到nacos里的服务名字
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
config:
server-addr: 127.0.0.1:8848
file-extension: yml #这个代表你的文件类型
profiles:
active: dev #这个代表你的环境 开发环境dev
Nacos里新建配置
进入nacos页面
这里的Data ID就是上面拼出来的名字
类型选择YAML
下面就可以把原来application.yml里的配置信息放到这里来了
拖到下面点击发布
命名空间
如果服务多起来,可以给服务注册和配置中心配一个命名空间
除了命名空间,还有Group和 归属应用 可以配置
命名空间看过去最直观
新增一个命名空间再切换到配置列表,顶部就可以切换命名空间
bootstrap.yml 里只需要多配一行代码就能使用
spring:
application:
name: service-name #这里就是你要注册到nacos里的服务名字
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
namespace: xxxxxxxx-xxxx-4517-b589-4e45eedfc111 #这里就是填命名空间id
config:
server-addr: 127.0.0.1:8848
file-extension: yml #这个代表你的文件类型
namespace: xxxxxxxx-xxxx-4517-b589-4e45eedfc111
profiles:
active: dev #这个代表你的环境 开发环境dev
Nacos持久化
目前Nacos仅支持Mysql数据库,且版本要求:5.6.5+
nacos/conf目录里有一个初始化文件:nacos-mysql.sql
创建一个数据库 执行这个sql
打开同目录的 application.properties 文件,在底部新增配置,
注意修改数据连接
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/mynacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
db.user=root
db.password=123456
重启项目再配置的文件就会存储到 mynacos中的数据库表 config_info里面
Nacos通过集中式存储来保证数据的持久化,同时也为Nacos集群部署奠定了基础