Docker下Nacos持久化配置

时间:2022-10-13 14:58:21

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码):https://github.com/zq2599/blog_demos

  • 本文是《Spring Cloud Alibaba实战系列》的第五篇,学习如何将Nacos服务所用的数据库从嵌入式数据库改为MySql。

官方操作指导

  • 下图是来自官方的操作指导,地址是:https://nacos.io/zh-cn/docs/deployment.html ,可见步骤很简单: Docker下Nacos持久化配置
  • 如果您是在物理机上操作,按照上述步骤即可完成,如果您的Nacos部署在Docker上,下本文可以用来做参考:

环境信息

  1. Nacos server版本:1.1.0
  2. 操作系统:CentOS Linux release 7.6.1810
  3. Docker:1.13.1, build b2f74b2/1.13.1
  4. docker-compose:1.24.1, build 4667896
  5. jdk:1.8.0_191
  6. maven:3.6.0
version: '2'
services:
  nacos:
    image: bolingcavalry/nacosserver:0.0.1
    container_name: nacos
    restart: unless-stopped
    ports:
    - '8848:8848'
  config-demo:
    image: bolingcavalry/nacosconfigdemo:1.0-SNAPSHOT
    container_name: config-demo
    restart: unless-stopped
    depends_on:
    - nacos
    ports:
    - '8080:8080'

Docker环境操作步骤简介

  • 简单介绍一下整个实战的步骤:
  1. 准备初始化nacos数据库的sql脚本;
  2. docker-compose.yml中增加mysql,并设置容器创建时执行前面的sql脚本;
  3. 准备nacos配置文件给docker-compose.yml中nacos容器使用;
  4. 启动,验证功能正常;
  5. 检查数据库中是否有数据;
  6. 删除容器,再重建容器,确认数据可以完全恢复;
  • 接下来一起实战吧。

准备初始化nacos数据库的sql脚本

  1. 此sql用于创建nacos server运行所需的表和数据,去下载nacos server安装包,地址是:https://github.com/alibaba/nacos/releases/download/1.1.0/nacos-server-1.1.0.tar.gz ;
  2. 下载的安装包解压后,文件 nacos/conf/nacos-mysql.sql 就是我们所需的sql脚本;
  3. 打开此脚本,可见内容中没有创建数据库,这样的脚本在mysql的docker容器内无法自动执行,需要在sql文件的开始位置添加以下内容:
CREATE DATABASE nacos_config;
use nacos_config;
  1. 将文件nacos-mysql.sql放在docker-compose.yml所在目录下;

docker-compose.yml中增加mysql

  • 接下来在容器编排文件docker-compose.yml中增加mysql容器:
  • 在docker-compose.yml中增加mysql容器,新增的mysql编排信息放在最前面,内容如下:
mysql:
    image: mysql:5.7.27
    container_name: mysql
    restart: unless-stopped
    volumes:
      - ./nacos-mysql.sql:/docker-entrypoint-initdb.d/nacos-mysql.sql
      - ./mysqldata:/var/lib/mysql
    command: --default-authentication-plugin=mysql_native_password
    environment:
      MYSQL_ROOT_PASSWORD: 123456
  • 上述内容有几处需要注意: a. 第一个volumes参数将宿主机的nacos-mysql.sql映射到容器的 /docker-entrypoint-initdb.d/ 目录,mysql容器启动时会执行这个目录下的所有以sh和sql结尾的文件; b. 第二个volumes参数将docker-compose.yml文件所在位置的 mysqldata 目录映射到容器的 /var/lib/mysql 目录,这样数据库所有数据都保存在宿主机上了,此mysqldata文件夹容器启动时自动创建; c. command参数设置了mysql的鉴权方式是密码方式; d. 环境变量MYSQL_ROOT_PASSWORD设置了mysql的root密码为123456;

准备nacos配置文件给docker-compose.yml中nacos容器使用

  • 接下来需要设置nacos server的参数,将mysql相关参数配置好,这样nacos server启动后就会使用mysql保存数据:
  • 进入刚才下载和解压的nacos server安装包,文件 nacos/conf/application.properties 就是我们所需的配置文件;
  • 将文件 application.properties 复制到docker-compose.yml所在目录;
  • 打开文件 application.properties ,在尾部新增以下内容,这些是mysql相关的配置:
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://mysql:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
db.user=root
db.password=123456
  • 打开docker-compose.yml文件,找到nacos的配置,修改后的内容如下:
nacos:
    image: bolingcavalry/nacosserver:0.0.1
    container_name: nacos
    restart: unless-stopped
    volumes:
      - ./application.properties:/root/nacos/conf/application.properties
    depends_on:
      - mysql
    ports:
      - '8848:8848'
  • 如上所示,nacos的配置有两处修改: a. 增加volumes,将宿主机的application.properties文件映射到容器中,作为nacos的配置文件; b. 增加依赖配置,在mysql容器启动成功后才会启动nacos;

  • 完整的docker-compose.yml内容如下:

version: '2'
services:
  mysql:
    image: mysql:5.7.27
    container_name: mysql
    restart: unless-stopped
    volumes:
      - ./nacos-mysql.sql:/docker-entrypoint-initdb.d/nacos-mysql.sql
      - ./mysqldata:/var/lib/mysql
    command: --default-authentication-plugin=mysql_native_password
    ports:
      - '3306:3306'
    environment:
      MYSQL_ROOT_PASSWORD: 123456
  nacos:
    image: bolingcavalry/nacosserver:0.0.1
    container_name: nacos
    restart: unless-stopped
    volumes:
      - ./application.properties:/root/nacos/conf/application.properties
    depends_on:
      - mysql
    ports:
      - '8848:8848'
  config-demo:
    image: bolingcavalry/nacosconfigdemo:1.0-SNAPSHOT
    container_name: config-demo
    restart: unless-stopped
    depends_on:
    - nacos
    ports:
    - '8080:8080'
  • 至此,准备完毕,可以验证了;

验证

docker-compose up -d
  • 我这里宿主机的IP是192.168.121.131,登录Nacos的web页面,创建应用所需的配置项,地址是:http://192.168.121.131:8848/nacos ,用户名和密码都是nacos;
  • 如下图,新增一个配置项: Docker下Nacos持久化配置
  • 浏览器访问地址:http://192.168.121.131:8080/test ,如下图,可见应用已经从nacos取得了配置: Docker下Nacos持久化配置
  • 再来看看mysql的数据;
  • 在宿主机执行命令 docker exec -it mysql /bin/bash 进入容器;
  • 进入容器后,执行命令 mysql -h127.0.0.1 -uroot -p123456 连接MySQL;
  • 参考以下的命令,检查MySQL的数据,可见刚才配置的数据都存入了MySQL:
mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| nacos_config       |
| performance_schema |
| sys                |
+--------------------+
5 rows in set (0.00 sec)

mysql> use nacos_config;
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Database changed
mysql> show tables;
+------------------------+
| Tables_in_nacos_config |
+------------------------+
| config_info            |
| config_info_aggr       |
| config_info_beta       |
| config_info_tag        |
| config_tags_relation   |
| group_capacity         |
| his_config_info        |
| roles                  |
| tenant_capacity        |
| tenant_info            |
| users                  |
+------------------------+
11 rows in set (0.00 sec)
mysql> select * from config_info \G
*************************** 1. row ***************************
          id: 1
     data_id: my-nacos-config.yaml
    group_id: BOLING_CAVALRY
     content: bolingcavalry:
  desc: desc from nacos yaml config
         md5: f44c8fd76e8da757380e8f7ddabe6e70
  gmt_create: 2019-08-31 13:53:01
gmt_modified: 2019-08-31 13:53:01
    src_user: NULL
      src_ip: 192.168.121.1
    app_name: 
   tenant_id: 
      c_desc: nacos config demo
       c_use: NULL
      effect: NULL
        type: yaml
    c_schema: NULL
1 row in set (0.00 sec)
  • 至此,可以确定在Docker环境下,Nacos使用MySQL进行持久化存储操作成功,接下来我们验证即使容器被删除,数据也可以恢复

删除容器,再重建容器,确认数据可以完全恢复

  • 在docker-compose.yml所在的目录下执行以下命令,会停止所有容器并将其删除:
docker-compose down
  • 执行 docker ps -a ,确认宿主机上已经没有任何容器存在:
[root@maven test]# docker-compose down
Stopping config-demo ... done
Stopping nacos       ... done
Stopping mysql       ... done
Removing config-demo ... done
Removing nacos       ... done
Removing mysql       ... done
Removing network test_default
[root@maven test]# docker ps -a
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
  • 此时就相当于整个环境已经不存在了,但是MySQL的数据文件夹已经被映射到宿主机,就是 mysqldata 目录;
  • 接下来我们要做的是重新创建所有容器,但是要使用之前的数据,因此不需要再执行nacos-mysql.sql了,在docker-compose.yml中去掉mysql容器的nacos-mysql.sql这个volumens参数:
version: '2'
services:
  mysql:
    image: mysql:5.7.27
    container_name: mysql
    restart: unless-stopped
    volumes:
      - ./mysqldata:/var/lib/mysql
    command: --default-authentication-plugin=mysql_native_password
    ports:
      - '3306:3306'
    environment:
      MYSQL_ROOT_PASSWORD: 123456
  nacos:
    image: bolingcavalry/nacosserver:0.0.1
    container_name: nacos
    restart: unless-stopped
    volumes:
      - ./application.properties:/root/nacos/conf/application.properties
    depends_on:
      - mysql
    ports:
      - '8848:8848'
  config-demo:
    image: bolingcavalry/nacosconfigdemo:1.0-SNAPSHOT
    container_name: config-demo
    restart: unless-stopped
    depends_on:
    - nacos
    ports:
    - '8080:8080'
  • 再次执行 docker-compose up -d ,启动所有容器;
  • 打开nacos的配置页面,原来的数据还在: Docker下Nacos持久化配置
  • 访问demo应用,依然可以成功从nacos取得配置内容: Docker下Nacos持久化配置
  • 至此,Docker下Nacos持久化配置实战就完成了,希望能给您的容器化项目提供一些参考。

官方Docker服务

  • Naocs的官方也给出了Docker下的Nacos镜像以及对应的编排操作指南,地址是:https://github.com/nacos-group/nacos-docker ,您也可以根据官方指导来实践,官方编排提供了更多的设置和配置,功能更强大,但是由于内容过多(例如Mysql使用了主从的容器设置),不适合本次文章的主题,因此我这里依然沿用了之前自己动手做的镜像;

欢迎关注51CTO博客:程序员欣宸

学习路上,你不孤单,欣宸原创一路相伴...