1. 下载nacos, nacos下载地址
Windows版本为例
启动命令(standalone代表着单机模式运行,非集群模式):
cmd startup.cmd -m standalone
浏览器访问:http://localhost:8848/nacos/
默认账号密码都是nacos
2. 添加依赖
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.3.RELEASE</version>
</parent>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2.1.0.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
</dependencies>
3. 配置文件bootstrap.yml(必须是这个文件名称)
spring:
application:
name: nacosConfig
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
enabled: true
config:
server-addr: 127.0.0.1:8848
group: DEFAULT_GROUP
file-extension: yaml
4. dataId字段说明
上面配置的 spring.application.name,会作为 Nacos 配置管理 dataId 字段的一部分。dataId 的完整格式如下:
${prefix}-${spring.profile.active}.${file-extension}
符号名 | 说明 |
---|---|
prefix | 默认为 spring.application.name 的值,也可以通过配置项 spring.cloud.nacos.config.prefix来配置 |
spring.profile.active | 当前环境对应的 profile。当 spring.profile.active 为空时,对应的连接符 - 也将不存在,dataId 的拼接格式变成 {prefix}.{file-extension}。 |
file-exetension | 配置内容的数据格式,可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。 |
nacos新增配置文件如图,当然其他一些通用配置也可以写入其中
5. 在controller层编写代码进行测试,获取这个name的值,注意@RefreshScope注解
@RestController
@RefreshScope
public class NacosController {
@Value("${jst.name}")
private String name;
@RequestMapping("/config")
public String config() {
return name;
}
}
6. 在笔者看来需要注意的有三个点:
1. 配置文件的名称必须以bootstrap.yml命名
2. nacos新建配置文件时dataId字段的格式,以服务名-环境的版本.后缀名
3. 在业务类上加入 @RefreshScope,这样当配置中心的配置值发生变化时,业务类所引用的值就会自动更新。
若有不足和错误的地方,欢迎留言指明与交流!!