spring boot使用nacos作为配置中心实践

概述

本文主要介绍自己将nacos作为spring boot的配置中心的实践过程,希望对有需求的小伙伴提供一些帮助。
通过nacos实现配置管理:支持分布式系统中的外部化配置,配置更改时自动刷新。

详细的说明可以查看官方文档:https://nacos.io/zh-cn/docs/quick-start-spring-boot.html

使用docker-compose安装nacos

在linux系统中可以通过以下命令安装 docker-compse:

yum install -y docker-compose

使用如下命令创建部署文件nacos-standalone-mysql-8.yaml

vim nacos-standalone-mysql-8.yaml

文件内容如下:

version: "2"
services:
  nacos:
    image: nacos/nacos-server:2.0.0
    container_name: nacos-standalone-mysql
    environment:
      - PREFER_HOST_MODE=hostname
      - MODE=standalone
      - SPRING_DATASOURCE_PLATFORM=mysql
      - MYSQL_SERVICE_HOST=mysql
      - MYSQL_SERVICE_DB_NAME=nacos_devtest
      - MYSQL_SERVICE_PORT=3306
      - MYSQL_SERVICE_USER=nacos
      - MYSQL_SERVICE_PASSWORD=nacos
    volumes:
      - ./standalone-logs/:/home/nacos/logs
    ports:
      - "8848:8848"
      - "9555:9555"
    depends_on:
      - mysql
    restart: always
  mysql:
    container_name: mysql
    image: nacos/nacos-mysql:8.0.16
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=nacos_devtest
      - MYSQL_USER=nacos
      - MYSQL_PASSWORD=nacos
    volumes:
      - ./mysql:/var/lib/mysql
    ports:
      - "3306:3306"

使用如下命令启动nacos:

docker-compose -f nacos-standalone-mysql-8.yaml up -d

使用下面的命令可以查看启动日志:

docker-compose -f nacos-standalone-mysql-8.yaml  logs -f

启动成功后访问:http://localhost:8848/nacos

登录用户名:nacos

登录密码:nacos

spring boot 整合nacos的配置管理

1、添加依赖

可以去maven中央仓库查找nacos-config-spring-boot-starter最新依赖,这里使用的最新依赖。
image.png

<!-- https://mvnrepository.com/artifact/com.alibaba.boot/nacos-config-spring-boot-starter -->
<dependency>
    <groupId>com.alibaba.boot</groupId>
    <artifactId>nacos-config-spring-boot-starter</artifactId>
    <version>0.2.7</version>
</dependency>

注意:版本 0.2.x.RELEASE 对应的是 Spring Boot 2.x 版本,版本 0.1.x.RELEASE 对应的是 Spring Boot 1.x 版本。

2、修改配置文件

将spring boot项目中原有的配置放到nacos中,如下图所示:
image.png

application.yaml 文件中配置 Nacos server 的地址:

nacos:
  config:
    server-addr: 127.0.0.1:8848

使用 @NacosPropertySource 加载nacos中dataId = "spring-boot-demo.yaml"的配置文件,并开启自动更新:

@SpringBootApplication
@NacosPropertySource(dataId = "spring-boot-demo.yaml", autoRefreshed = true)
public class NacosConfigApplication {

    public static void main(String[] args) {
        SpringApplication.run(NacosConfigApplication.class, args);
    }
}

通过 Nacos 的 @NacosValue 注解设置属性值。

@RestController
public class ConfigController {
    @NacosValue(value = "${name:test}", autoRefreshed = true)
    private String name;

    @GetMapping("/get")
    public String get() {
        return name;
    }
}

启动 NacosConfigApplication,调用 http://localhost:8777/spring-boot-demo/get,返回内容是 祢豆子。

总结

使用spring boot整合nacos的配置管理还是挺简单的,总体来说就只有三步:

1、引入 nacos-config-spring-boot-starter 依赖

2、在配置文件中设置nacos的地址

3、在启动类上使用注解@NacosPropertySource 指定nacos中配置的 Data ID

存在的问题

1、在application.yaml配置文件中指定nacos中配置的 Data ID 不会生效,需要通过注解@NacosPropertySource指定才能生效。

2、 nacos-config-spring-boot-starter:0.2.7依赖最高支持 spring boot 2.3.x,如果使用spring boot 2.4.x将会报如下错误:

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'nacosConfigurationPropertiesBinder': Bean instantiation via constructor failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [com.alibaba.boot.nacos.config.binder.NacosBootConfigurationPropertiesBinder]: Constructor threw exception; nested exception is java.lang.NoClassDefFoundError: org/springframework/boot/context/properties/ConfigurationBeanFactoryMetadata
	at org.springframework.beans.factory.support.ConstructorResolver.instantiate(ConstructorResolver.java:315) ~[spring-beans-5.3.2.jar:5.3.2]
	at org.springframework.beans.factory.support.ConstructorResolver.autowireConstructor(ConstructorResolver.java:296) ~[spring-beans-5.3.2.jar:5.3.2]
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.autowireConstructor(AbstractAutowireCapableBeanFactory.java:1356) ~[spring-beans-5.3.2.jar:5.3.2]
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1206) ~[spring-beans-5.3.2.jar:5.3.2]
Caused by: org.springframework.beans.BeanInstantiationException: Failed to instantiate [com.alibaba.boot.nacos.config.binder.NacosBootConfigurationPropertiesBinder]: Constructor threw exception; nested exception is java.lang.NoClassDefFoundError: org/springframework/boot/context/properties/ConfigurationBeanFactoryMetadata
	at org.springframework.beans.BeanUtils.instantiateClass(BeanUtils.java:225) ~[spring-beans-5.3.2.jar:5.3.2]
	at org.springframework.beans.factory.support.SimpleInstantiationStrategy.instantiate(SimpleInstantiationStrategy.java:117) ~[spring-beans-5.3.2.jar:5.3.2]
	at org.springframework.beans.factory.support.ConstructorResolver.instantiate(ConstructorResolver.java:311) ~[spring-beans-5.3.2.jar:5.3.2]
	... 20 common frames omitted
Caused by: java.lang.NoClassDefFoundError: org/springframework/boot/context/properties/ConfigurationBeanFactoryMetadata
	at com.alibaba.boot.nacos.config.binder.NacosBootConfigurationPropertiesBinder.<init>(NacosBootConfigurationPropertiesBinder.java:51) ~[nacos-config-spring-boot-autoconfigure-0.2.7.jar:0.2.7]
	at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) ~[na:1.8.0_181]
	at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62) ~[na:1.8.0_181]
	at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45) ~[na:1.8.0_181]
	at java.lang.reflect.Constructor.newInstance(Constructor.java:423) ~[na:1.8.0_181]
	at org.springframework.beans.BeanUtils.instantiateClass(BeanUtils.java:212) ~[spring-beans-5.3.2.jar:5.3.2]
	... 22 common frames omitted
Caused by: java.lang.ClassNotFoundException: org.springframework.boot.context.properties.ConfigurationBeanFactoryMetadata
	at java.net.URLClassLoader.findClass(URLClassLoader.java:381) ~[na:1.8.0_181]
	at java.lang.ClassLoader.loadClass(ClassLoader.java:424) ~[na:1.8.0_181]
	at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:349) ~[na:1.8.0_181]
	at java.lang.ClassLoader.loadClass(ClassLoader.java:357) ~[na:1.8.0_181]
	... 28 common frames omitted

  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
使用 Nacos 作为 Spring Cloud 的注册中心需要以下几个步骤: 1. 添加依赖:在项目的 `pom.xml` 文件中添加以下依赖: ```xml <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId> </dependency> ``` 2. 配置 Nacos 地址:在项目的 YAML 配置文件(比如 `application.yml`)中添加以下配置: ```yaml spring: cloud: nacos: discovery: server-addr: your-nacos-server-address:port ``` 请将 `your-nacos-server-address` 替换为实际的 Nacos 服务器地址和端口。 3. 启用服务注册和发现:在 Spring Boot 的启动类上添加 `@EnableDiscoveryClient` 注解,例如: ```java import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.client.discovery.EnableDiscoveryClient; @SpringBootApplication @EnableDiscoveryClient public class YourApplication { public static void main(String[] args) { SpringApplication.run(YourApplication.class, args); } } ``` 4. 在需要注册的服务上添加 `@RestController` 和 `@RequestMapping` 注解,例如: ```java import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class YourController { @RequestMapping("/your-endpoint") public String yourEndpoint() { return "Hello, world!"; } } ``` 5. 启动应用程序:运行 Spring Boot 应用程序,它将自动向 Nacos 注册服务,并可通过 Nacos 进行服务发现。 这样,你就成功将 Nacos 作为 Spring Cloud 的注册中心了。可以通过 Nacos 控制台验证服务是否注册成功,并使用服务名访问注册的服务。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值