Nacos的安装和实操

曾经终败给现在 2024-02-20 09:23 48阅读 0赞

## 前言 ##

最近在学SpringCloud，写下遇到的问题方便自己方便他人，主要描述Nacos的安装与会遇到的一些问题＋代码实操

#### 文章目录 ####

*  前言
 *  Nacos基本介绍
 *  Nacos基本使用
 *   *  Nacos的安装部署
     *  Nacos配置MySQL数据源
     *  管理界面鉴权设置
 *  简单的操作Demo

## Nacos基本介绍 ##

Nacos是Dynamic Naming and Configuration Service的首字母简称，一个由阿里开发，用于云原始应用动态服务发现、配置管理和服务管理平台。

## Nacos基本使用 ##

### Nacos的安装部署 ###

Nacos就是微服务的组件，所以自然就有单机部署、集群部署、多集群部署三种模式，下面主要介绍单机部署

*  **安装JDK：** 因为Nacos是用Java语言写的，所以我们必须在系统上配置好JDK，我建议JDK版本>1.8的，我试过1.8的然后Tomcat启动不了，换成16、17就可以了
 *  **安装并启动：**
    
     *  源码安装
     *  编译压缩包安装（推荐）
    
    --------------------
 *  **下载压缩包**：[nacos-server-2.2.3.zip][]
 *  **解压缩**：windows使用解压工具即可，Linux使用tar -xvf nacos-server-$version.tar.gz；
 *  进入Nacos运行目录：cd nacos/bin![在这里插入图片描述][e982819bf5044345815375b500be44be.png_pic_center]
 *  **启动**  
    \- Linus/MacOS：sh startup.sh -m standalone启动Nacos单机模式  
    \- Windows：startup.cmd -m standalone
 *  **启动成功样图**  
    ![在这里插入图片描述][fe1b212c759f410baf932cfeb1831a74.png_pic_center]
 *  启动成功后，进入管理界面：localhost:8848/nacos  
    ![在这里插入图片描述][fe997db53d7d4ab58ee091c0832db514.png_pic_center]

> 到这一步，一般是没有问题的，假如你的Nacos无法启动，查看系统环境变量是否配置了JDK，也可以在命令窗口使用java -version进行查看，假如你配置了，还是没有正常启动并且错误提示为`Unable to start embedded Tomcat`的话，就是Tomcat启动失败，如果你去看nacos.log可能会发现是某个filter加载失败，这个时候建议去`换一个高版本的JDK`，这样应该可以解决问题了（我1.8有问题，切换成16、17后就没有问题了，C站上普遍都说是集群启动而非单机启动的问题，没有其他方案T\_T）

小技巧：（Windows）

> 到nacos/bin目录中找到startup.cmd这个文件，使用Vs或者文本模式打开，修改一下启动模式（集群改为单机），如下图：  
> ![3bfaf8ac5f754769af5194831aa33f8f.png][]  
> 这样我们下次单机模式启动的时候就双击startup.cmd这个文件就可以了，而不需要输入命令启动单机模式

### Nacos配置MySQL数据源 ###

进入nacos/conf目录，打开下面这个文件![在这里插入图片描述][e54f0c64d7984973b96b7760e394f3f2.png_pic_center]  
找到下图这几行代码，去掉注释并配置你数据库的账户和密码  
![在这里插入图片描述][f98dcccbdd54423292ac9052a5e1fa22.png]  
打开MySQL，输入下面SQL

/*
     * Copyright 1999-2018 Alibaba Group Holding Ltd.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *      http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    
    drop DATABASE if EXISTS nacos;
    CREATE DATABASE nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    use nacos;
    
    /******************************************/
    /*   表名称 = config_info                  */
    /******************************************/
    CREATE TABLE `config_info` (
      `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
      `data_id` varchar(255) NOT NULL COMMENT 'data_id',
      `group_id` varchar(128) DEFAULT NULL COMMENT 'group_id',
      `content` longtext NOT NULL COMMENT 'content',
      `md5` varchar(32) DEFAULT NULL COMMENT 'md5',
      `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
      `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间',
      `src_user` text COMMENT 'source user',
      `src_ip` varchar(50) DEFAULT NULL COMMENT 'source ip',
      `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
      `tenant_id` varchar(128) DEFAULT '' COMMENT '租户字段',
      `c_desc` varchar(256) DEFAULT NULL COMMENT 'configuration description',
      `c_use` varchar(64) DEFAULT NULL COMMENT 'configuration usage',
      `effect` varchar(64) DEFAULT NULL COMMENT '配置生效的描述',
      `type` varchar(64) DEFAULT NULL COMMENT '配置的类型',
      `c_schema` text COMMENT '配置的模式',
      `encrypted_data_key` text NOT NULL COMMENT '密钥',
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_configinfo_datagrouptenant` (`data_id`,`group_id`,`tenant_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_info';
    
    /******************************************/
    /*   表名称 = config_info_aggr             */
    /******************************************/
    CREATE TABLE `config_info_aggr` (
      `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
      `data_id` varchar(255) NOT NULL COMMENT 'data_id',
      `group_id` varchar(128) NOT NULL COMMENT 'group_id',
      `datum_id` varchar(255) NOT NULL COMMENT 'datum_id',
      `content` longtext NOT NULL COMMENT '内容',
      `gmt_modified` datetime NOT NULL COMMENT '修改时间',
      `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
      `tenant_id` varchar(128) DEFAULT '' COMMENT '租户字段',
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_configinfoaggr_datagrouptenantdatum` (`data_id`,`group_id`,`tenant_id`,`datum_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='增加租户字段';
    
    
    /******************************************/
    /*   表名称 = config_info_beta             */
    /******************************************/
    CREATE TABLE `config_info_beta` (
      `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
      `data_id` varchar(255) NOT NULL COMMENT 'data_id',
      `group_id` varchar(128) NOT NULL COMMENT 'group_id',
      `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
      `content` longtext NOT NULL COMMENT 'content',
      `beta_ips` varchar(1024) DEFAULT NULL COMMENT 'betaIps',
      `md5` varchar(32) DEFAULT NULL COMMENT 'md5',
      `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
      `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间',
      `src_user` text COMMENT 'source user',
      `src_ip` varchar(50) DEFAULT NULL COMMENT 'source ip',
      `tenant_id` varchar(128) DEFAULT '' COMMENT '租户字段',
      `encrypted_data_key` text NOT NULL COMMENT '密钥',
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_configinfobeta_datagrouptenant` (`data_id`,`group_id`,`tenant_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_info_beta';
    
    /******************************************/
    /*   表名称 = config_info_tag              */
    /******************************************/
    CREATE TABLE `config_info_tag` (
      `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
      `data_id` varchar(255) NOT NULL COMMENT 'data_id',
      `group_id` varchar(128) NOT NULL COMMENT 'group_id',
      `tenant_id` varchar(128) DEFAULT '' COMMENT 'tenant_id',
      `tag_id` varchar(128) NOT NULL COMMENT 'tag_id',
      `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
      `content` longtext NOT NULL COMMENT 'content',
      `md5` varchar(32) DEFAULT NULL COMMENT 'md5',
      `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
      `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间',
      `src_user` text COMMENT 'source user',
      `src_ip` varchar(50) DEFAULT NULL COMMENT 'source ip',
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_configinfotag_datagrouptenanttag` (`data_id`,`group_id`,`tenant_id`,`tag_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_info_tag';
    
    /******************************************/
    /*   表名称 = config_tags_relation         */
    /******************************************/
    CREATE TABLE `config_tags_relation` (
      `id` bigint(20) NOT NULL COMMENT 'id',
      `tag_name` varchar(128) NOT NULL COMMENT 'tag_name',
      `tag_type` varchar(64) DEFAULT NULL COMMENT 'tag_type',
      `data_id` varchar(255) NOT NULL COMMENT 'data_id',
      `group_id` varchar(128) NOT NULL COMMENT 'group_id',
      `tenant_id` varchar(128) DEFAULT '' COMMENT 'tenant_id',
      `nid` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'nid, 自增长标识',
      PRIMARY KEY (`nid`),
      UNIQUE KEY `uk_configtagrelation_configidtag` (`id`,`tag_name`,`tag_type`),
      KEY `idx_tenant_id` (`tenant_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_tag_relation';
    
    /******************************************/
    /*   表名称 = group_capacity               */
    /******************************************/
    CREATE TABLE `group_capacity` (
      `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
      `group_id` varchar(128) NOT NULL DEFAULT '' COMMENT 'Group ID，空字符表示整个集群',
      `quota` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '配额，0表示使用默认值',
      `usage` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '使用量',
      `max_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '单个配置大小上限，单位为字节，0表示使用默认值',
      `max_aggr_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '聚合子配置最大个数，，0表示使用默认值',
      `max_aggr_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '单个聚合数据的子配置大小上限，单位为字节，0表示使用默认值',
      `max_history_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '最大变更历史数量',
      `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
      `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间',
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_group_id` (`group_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='集群、各Group容量信息表';
    
    /******************************************/
    /*   表名称 = his_config_info              */
    /******************************************/
    CREATE TABLE `his_config_info` (
      `id` bigint(20) unsigned NOT NULL COMMENT 'id',
      `nid` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT 'nid, 自增标识',
      `data_id` varchar(255) NOT NULL COMMENT 'data_id',
      `group_id` varchar(128) NOT NULL COMMENT 'group_id',
      `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
      `content` longtext NOT NULL COMMENT 'content',
      `md5` varchar(32) DEFAULT NULL COMMENT 'md5',
      `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
      `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间',
      `src_user` text COMMENT 'source user',
      `src_ip` varchar(50) DEFAULT NULL COMMENT 'source ip',
      `op_type` char(10) DEFAULT NULL COMMENT 'operation type',
      `tenant_id` varchar(128) DEFAULT '' COMMENT '租户字段',
      `encrypted_data_key` text NOT NULL COMMENT '密钥',
      PRIMARY KEY (`nid`),
      KEY `idx_gmt_create` (`gmt_create`),
      KEY `idx_gmt_modified` (`gmt_modified`),
      KEY `idx_did` (`data_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='多租户改造';
    
    
    /******************************************/
    /*   表名称 = tenant_capacity              */
    /******************************************/
    CREATE TABLE `tenant_capacity` (
      `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
      `tenant_id` varchar(128) NOT NULL DEFAULT '' COMMENT 'Tenant ID',
      `quota` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '配额，0表示使用默认值',
      `usage` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '使用量',
      `max_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '单个配置大小上限，单位为字节，0表示使用默认值',
      `max_aggr_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '聚合子配置最大个数',
      `max_aggr_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '单个聚合数据的子配置大小上限，单位为字节，0表示使用默认值',
      `max_history_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '最大变更历史数量',
      `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
      `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间',
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_tenant_id` (`tenant_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='租户容量信息表';
    
    
    CREATE TABLE `tenant_info` (
      `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
      `kp` varchar(128) NOT NULL COMMENT 'kp',
      `tenant_id` varchar(128) default '' COMMENT 'tenant_id',
      `tenant_name` varchar(128) default '' COMMENT 'tenant_name',
      `tenant_desc` varchar(256) DEFAULT NULL COMMENT 'tenant_desc',
      `create_source` varchar(32) DEFAULT NULL COMMENT 'create_source',
      `gmt_create` bigint(20) NOT NULL COMMENT '创建时间',
      `gmt_modified` bigint(20) NOT NULL COMMENT '修改时间',
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_tenant_info_kptenantid` (`kp`,`tenant_id`),
      KEY `idx_tenant_id` (`tenant_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='tenant_info';
    
    CREATE TABLE `users` (
    	`username` varchar(50) NOT NULL PRIMARY KEY COMMENT 'username',
    	`password` varchar(500) NOT NULL COMMENT 'password',
    	`enabled` boolean NOT NULL COMMENT 'enabled'
    );
    
    CREATE TABLE `roles` (
    	`username` varchar(50) NOT NULL COMMENT 'username',
    	`role` varchar(50) NOT NULL COMMENT 'role',
    	UNIQUE INDEX `idx_user_role` (`username` ASC, `role` ASC) USING BTREE
    );
    
    CREATE TABLE `permissions` (
        `role` varchar(50) NOT NULL COMMENT 'role',
        `resource` varchar(255) NOT NULL COMMENT 'resource',
        `action` varchar(8) NOT NULL COMMENT 'action',
        UNIQUE INDEX `uk_role_permission` (`role`,`resource`,`action`) USING BTREE
    );
    
    INSERT INTO users (username, password, enabled) VALUES ('nacos', '$2a$10$EuWPZHzz32dJN7jexM34MOeYirDdFAZm2kuWj7VEOJhhZkDrxfvUu', TRUE);
    
    INSERT INTO roles (username, role) VALUES ('nacos', 'ROLE_ADMIN');

这个你的数据库配置就完成了，重新启动Nacos，进行角色添加，再去查看mysql中是否有记录就可以确认是否成功配置了。  
![在这里插入图片描述][58f7a6ec2bc64514918c7c7036451977.png_pic_center]  
![在这里插入图片描述][a4a8e7b6a1b1487c9022c211710b2c33.png_pic_center]

### 管理界面鉴权设置 ###

管理界面的鉴权就是管理界面的登录设置，默认是不需要登录的，显然这是不安全的，谁都能进去不就出大问题了，所以必须鉴权

开启鉴权也很方便，还是/nacos/conf/application.properties这个文件，打开找到下面配置行并修改

nacos.core.auth.enabled=true
    nacos.core.auth.plugin.nacos.token.secret.key=SecretKey012345678901234567890123456789012345678901234567890123456789
    # 访问 Nacos 敏感接口的白名单，key 和 value 必须要有值
    nacos.core.auth.server.identity.key=nacos
    nacos.core.auth.server.identity.value=nacos

重启Nacos，重新进入localhost:8848/nacos，出现登录界面如下：  
![在这里插入图片描述][cfe9c61ad95c4af19c02fedc0eae6c16.png_pic_center]

> 到这里Nacos 的搭建和配置就完成了

--------------------

## 简单的操作Demo ##

在多机部署项目的时候，配置文件这种高度统一的文件，可以提取出来，大家共享一个，避免要修改文件时整个项目集群都要修改，而我们的Nacos就有这种功能，可以创建配置文件，供项目进行读取  
![在这里插入图片描述][6056f008b9614971bd8e5f035df85e47.png_pic_center]  
![在这里插入图片描述][3019258248114549bd2d6f63652c80f6.png_pic_center]

创建SpringBoot项目，导入Nacos对应包，这里建议使用阿里源（start.aliyun.com）  
![在这里插入图片描述][d52958060b5e4019b1d0b66e15bdbba1.png_pic_center]  
![在这里插入图片描述][044f51553e16467ebe6f483a01c67474.jpeg_pic_center]  
这里我们导入配置中心就可以了

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

之后我们将一些无效文件进行删除  
![在这里插入图片描述][76d7bcdcc15142fbada3260afb74fd4a.png_pic_center]  
修改application.properties文件

# Nacos认证信息
    spring.cloud.nacos.config.username=nacos
    spring.cloud.nacos.config.password=nacos
    spring.cloud.nacos.config.contextPath=/nacos
    # 设置配置中心服务端地址
    spring.cloud.nacos.config.server-addr=localhost:8848
    # Nacos 配置中心的namespace。需要注意，如果使用 public 的 namcespace ，请不要填写这个值，直接留空即可
    # spring.cloud.nacos.config.namespace=
    # spring.cloud.nacos.config.group=
    spring.config.import=nacos:nacos-config-example
    # 配置文件类型
    spring.cloud.nacos.config.file-extension=properties

创建一个testController

@RestController
    public class TestController {
        
    
        @Value("${myconfig}")
        private String myconfig;
    
        @RequestMapping("/my")
        public void test(){
        
            System.out.println(myconfig);
        }
    }

启动项目，访问路由后，控制台打印Nacos配置文件中的内容  
![在这里插入图片描述][8d0aababe01f4d60bfcbc7903213db22.png]

--------------------

END

[nacos-server-2.2.3.zip]: https://github.com/alibaba/nacos/releases
[e982819bf5044345815375b500be44be.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/b261fb09415a499cbd1deebb7121da12.png
[fe1b212c759f410baf932cfeb1831a74.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/b73e7316a61e43f2952597de0e63a8c5.png
[fe997db53d7d4ab58ee091c0832db514.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/fe5f037a77ce45b48e8cc10415f7e7b9.png
[3bfaf8ac5f754769af5194831aa33f8f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/98b88911b6f843c1b3556f64acb6c81f.png
[e54f0c64d7984973b96b7760e394f3f2.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/8404b40d07de4af79f745901fb4411e9.png
[f98dcccbdd54423292ac9052a5e1fa22.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/55498af93c714065a6d26267fe7ae18d.png
[58f7a6ec2bc64514918c7c7036451977.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/e9a71f8d00314993843aae4227c5c97a.png
[a4a8e7b6a1b1487c9022c211710b2c33.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/f24f2cef2e87435b9294a2b5b49295ba.png
[cfe9c61ad95c4af19c02fedc0eae6c16.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/d310fd15044244148c013333f2b5be28.png
[6056f008b9614971bd8e5f035df85e47.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/ad8892285c4442c5afa63ad79af06180.png
[3019258248114549bd2d6f63652c80f6.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/2186870f41d74640bc04720e143b45e3.png
[d52958060b5e4019b1d0b66e15bdbba1.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/1a5b68bf00f04ad08171a3197160ad49.png
[044f51553e16467ebe6f483a01c67474.jpeg_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/bc94317f228d4b7383a3978ffeed9b54.png
[76d7bcdcc15142fbada3260afb74fd4a.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/0868e9f834ca405d9dc441799ca40c6e.png
[8d0aababe01f4d60bfcbc7903213db22.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/a6ab50c68d074b7baa260f1daae2ba17.png