nacos 1.2.1 版本从安装到使用配置中心

最新推荐文章于 2024-09-04 11:33:53 发布

zj420964597

最新推荐文章于 2024-09-04 11:33:53 发布

阅读量4.8k

点赞数 3

分类专栏： nacos 文章标签： java

本文链接：https://blog.csdn.net/zj420964597/article/details/106429415

版权

nacos 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

Nacos Spring Cloud 快速开始

一、安装nacos

1. 下载nacos

https://github.com/alibaba/nacos/releases

我是安装到linux，则下载****.tar.gz

2. 解压

下载完成的nacos-server-1.2.1.tar.gz进行解压

解压命令：

tar zxvf nacos-server-1.2.1.tar.gz

3. 启动nacos

解压后进入到bin目录，然后执行命令：

sh startup.sh -m standalone

该方式启动，是单机模式启动。

4. 报错

若发现启动完成报错：java.io.FileNotFoundException: /data/nacos/conf/cluster.conf (No such file or directory)

简单粗暴的解决方式：

1. vim startup.sh 2. 将脚本中的 if [ "${MODE}" == "standalone" ]; 改为if [ "${MODE}" = "standalone" ]; 即可

然后重新启动

5. 启动成功访问页面

http://ip:8848/nacos/

默认账号密码： nacos nacos

二、使用nacos

Nacos Spring Cloud 快速开始

1. 添加依赖：

<dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
            <version>2.1.1.RELEASE</version>
        </dependency>

注意：版本 2.1.x.RELEASE 对应的是 Spring Boot 2.1.x 版本。版本 2.0.x.RELEASE 对应的是 Spring Boot 2.0.x 版本，版本 1.5.x.RELEASE 对应的是 Spring Boot 1.5.x 版本。

2. 在 bootstrap.properties 中配置 Nacos server 的地址和应用名

# nacos 配置
spring.application.name=nacos-config-client
#配置文件类型[TEXT,JSON,XML,YAML,HTML,Properties]
spring.cloud.nacos.config.file-extension=yml
spring.cloud.nacos.config.server-addr=192.168.26.115:8848
spring.cloud.nacos.config.namespace=public



# 配置分组,当前的业务基本选择为某些的GROUP,可以基于业务来划分不同的分组.
#spring.cloud.nacos.config.group=DEFAULT_GROUP
# 默认选择的配置环境,当前把环境划分为4套, dev[开发环境],test[测试环境],pre[预发环境],prod[生产环境]
#spring.profiles.active=dev

在 Nacos Spring Cloud 中，dataId 的完整格式如下：

${spring.application.name}-${spring.profile.active}.${file-extension}

prefix 默认为 spring.application.name 的值，也可以通过配置项 spring.cloud.nacos.config.prefix来配置。
spring.profile.active 即为当前环境对应的 profile，详情可以参考 Spring Boot文档。 注意：当 spring.profile.active 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成 ${prefix}.${file-extension}
file-exetension 为配置内容的数据格式，可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。

版本对应关系参考：版本说明 Wiki

nacos关闭客户端心跳日志：

客户端依赖nacos版本：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2.1.2.RELEASE</version>
</dependency>

客户端控制台一直打印：

INFO 17770 --- [131_32480-ta404] c.a.n.client.config.impl.ClientWorker : get changedGroupKeys:[]
INFO 17770 --- [131_32480-ta404] c.a.n.client.config.impl.ClientWorker : get changedGroupKeys:[]

关闭客户端心跳日志：

logging:
  level:
    com:
      alibaba:
        nacos:
          client: error

nacos配置：

nacos配置可分为：shared、extConfig、ApplicationConfig（加载顺序shared、extConfig、ApplicationConfig，后加载的配置可覆盖先加载的配置）

源码：
NacosPropertySourceLocator类：

loadSharedConfiguration(composite);
loadExtConfiguration(composite);
loadApplicationConfiguration(composite, dataIdPrefix, this.nacosConfigProperties, env);

spring:
 cloud:
  nacos:
    config:
      file-extension: yml
      server-addr: 192.168.26.131:31971
      prefix: test
spring:
  profiles:
    active: dev,mybatis,cas,platform

默认读取: test test-dev.yml test-mybatis.yml test-cas.yml test-platform.yml

后读取的覆盖先读取的，test-platform.yml（优先级最高）的配置默认覆盖之前的

配置中心的配置>启动参数>项目里的配置

配置写法：

spring:
  profiles:
    active: dev,mybatis
  application:
    name: demo
  cloud:
    nacos:
      config:
        file-extension: yml
        server-addr: 127.0.0.1:8848
        namespace: public
        enableRemoteSyncConfig: true
        shared-dataids: shareconfig1.yml,shareconfig2.yml
        refreshable-dataids: shareconfig1.yml,shareconfig2.yml
        extConfig:
          - dataId: example.yaml
            refresh: true

配置自动更新

1. 通过 Spring Cloud 原生注解 @RefreshScope 实现配置自动更新

@RestController
@RequestMapping("/config")
@RefreshScope
public class ConfigController {

    @Value("${useLocalCache:false}")
    private boolean useLocalCache;

    @RequestMapping("/get")
    public boolean get() {
        return useLocalCache;
    }
}

2. java 配置类实现自动刷新：

//@RefreshScope   配置bean不用加这个注解
@Component
@ConfigurationProperties(prefix = "ta")
public class TaAudit1Properties {

    /**
     * 上传开关
     */
    private boolean uploadSwitch = false;

    /**
     * 上传扩展
     */
//	@Value("${explore}")  配置bean不用加这个注解
    private String explore = "base";

    public String getExplore() {
        return explore;
    }

    public void setExplore(String explore) {
    	System.out.println("进入set方法~~~~~");
        this.explore = explore;
    }

    public boolean isUploadSwitch() {
        return uploadSwitch;
    }

    public void setUploadSwitch(boolean uploadSwitch) {
        this.uploadSwitch = uploadSwitch;
    }
}

总结：

其他类中使用@Value 需要添加@RefreshScope才能动态修改配置

Java 配置bean：去掉@RefreshScope和@Value ，则修改配置时就能修改环境，然后走set 方法（正确的用法）

Java配置bean：只要加上@RefreshScope，则修改配置时，修改了环境但是没走set方法，反而在调用的时候get的时候才走set 方法（即调用get 的时候才刷新bean）只加@value没问题

nacos界面权限控制没有效果

需要在nacos 安装目录下的application.properties中将配置设为true：nacos.core.auth.enabled=true

nacos原理：

1. 首先更新环境中配置

2.将所有java配置bean 销毁后重新初始化

Map<String, Object> beanMap = applicationContext.getBeansWithAnnotation(ConfigurationProperties.class);
// 刷新bean的配置
if (beanMap != null){
   for (Map.Entry<String, Object> entry : beanMap.entrySet()) {
      String beanName = entry.getKey();
      Object bean = entry.getValue();
      rebind(beanName, bean);
   }
}
public boolean rebind(String beanName, Object bean) {
   if (this.applicationContext != null) {
      try {
         if (AopUtils.isAopProxy(bean)) {
            bean = ProxyUtils.getTargetObject(bean);
         }
         if (bean != null) {
            this.applicationContext.getAutowireCapableBeanFactory().destroyBean(bean);
            this.applicationContext.getAutowireCapableBeanFactory().initializeBean(bean, beanName);
            return true;
         }
      } catch (RuntimeException var3) {
         if (log.isDebugEnabled()) {
            log.debug("更新bean失败", var3);
         }
         throw new AppException("更新bean失败");
      } catch (Exception var4) {
         if (log.isDebugEnabled()) {
            log.debug("Cannot rebind to {}", beanName, var4);
         }
         throw new AppException("Cannot rebind to " + beanName);
      }
   }
   return false;
}

三、nacos源码开发：

nacos使用外嵌数据库mysql，需在配置文件中配置如下：且必须配置spring.datasource.platform=mysql ，否则还是用内嵌数据库(Derby)

## mysql datasource
spring.datasource.platform=mysql 

db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
db.user=root
db.password=123456

nacos客户端如何获取配置：

nacos客户端维护了一个长轮询的任务，定时去拉取发生变更的配置信息，然后将最新的数据推送给 Listener 的持有者。

考虑到服务端故障的问题，客户端将最新数据获取后会保存在本地的 snapshot 文件中，以后会优先从文件中获取配置信息的值。

参考：https://www.jianshu.com/p/38b5452c9fec

nacos客户端读取配置：

b6fYVfQ.jpg!web

获取配置的优先级依次为：本地配置 -> 服务端获取的配置 -> Snapshot保存的配置。

参考：https://www.joyk.com/dig/detail/1552743057306459

源码：
NacosConfigService -->getConfigInner()


/Users/zj/nacos/config/fixed-127.0.0.1_8848-namespace1_nacos/snapshot-tenant/namespace1/DEFAULT_GROUP/example.yaml

nacos存在的问题：

启动报错org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length = 1

检查yml文件中包含中文，去掉再启动就好了

或者解决方案：

设置JVM参数 -Dfile.encoding=utf-8即可，java -Dfile.encoding=utf-8 -jar

开启这个权限会存在很多问题：
nacos.core.auth.enabled=true
1. 界面控制不当，没有权限的人也能看到全部命名空间的问题

nacos打包命令

mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U

nacos启动类

nacos-console模块下

nacos k8s 配置：

表格来着：https://www.cnblogs.com/allennote/articles/12459907.html

name	description	option
MODE	cluster模式/standalone模式	cluster/standalone default cluster
NACOS_SERVERS	nacos cluster地址	eg. ip1,ip2,ip3
PREFER_HOST_MODE	是否支持hostname	hostname/ip default ip
NACOS_SERVER_PORT	nacos服务器端口	default 8848
NACOS_SERVER_IP	多网卡下的自定义nacos服务器IP
SPRING_DATASOURCE_PLATFORM	standalone 支持 mysql	mysql / empty default empty
MYSQL_MASTER_SERVICE_HOST	mysql 主节点host
MYSQL_MASTER_SERVICE_PORT	mysql 主节点端口	default : 3306
MYSQL_MASTER_SERVICE_DB_NAME	mysql 主节点数据库
MYSQL_MASTER_SERVICE_USER	数据库用户名
MYSQL_MASTER_SERVICE_PASSWORD	数据库密码
MYSQL_SLAVE_SERVICE_HOST	mysql从节点host
MYSQL_SLAVE_SERVICE_PORT	mysql从节点端口	default :3306
MYSQL_DATABASE_NUM	数据库数量	default :2
JVM_XMS	-Xms	default :2g
JVM_XMX	-Xmx	default :2g
JVM_XMN	-Xmn	default :1g
JVM_MS	-XX:MetaspaceSize	default :128m
JVM_MMS	-XX:MaxMetaspaceSize	default :320m
NACOS_DEBUG	开启远程调试	y/n default :n
TOMCAT_ACCESSLOG_ENABLED	server.tomcat.accesslog.enabled	default :false