欢迎访问我的GitHub
这里分类和汇总了欣宸的全部原创(含配套源码):https://github.com/zq2599/blog_demos
- 本文是《Spring Cloud Alibaba实战系列》的第五篇,学习如何将Nacos服务所用的数据库从嵌入式数据库改为MySql。
官方操作指导
- 下图是来自官方的操作指导,地址是:https://nacos.io/zh-cn/docs/deployment.html ,可见步骤很简单:
- 如果您是在物理机上操作,按照上述步骤即可完成,如果您的Nacos部署在Docker上,下本文可以用来做参考:
环境信息
- Nacos server版本:1.1.0
- 操作系统:CentOS Linux release 7.6.1810
- Docker:1.13.1, build b2f74b2/1.13.1
- docker-compose:1.24.1, build 4667896
- jdk:1.8.0_191
- maven:3.6.0
- Nacos的镜像和测试应用都来自《Docker下,两分钟极速体验Nacos配置中心》一文,编排容器的docker-compose.yml内容如下:
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环境操作步骤简介
- 简单介绍一下整个实战的步骤:
- 准备初始化nacos数据库的sql脚本;
- docker-compose.yml中增加mysql,并设置容器创建时执行前面的sql脚本;
- 准备nacos配置文件给docker-compose.yml中nacos容器使用;
- 启动,验证功能正常;
- 检查数据库中是否有数据;
- 删除容器,再重建容器,确认数据可以完全恢复;
- 接下来一起实战吧。
准备初始化nacos数据库的sql脚本
- 此sql用于创建nacos server运行所需的表和数据,去下载nacos server安装包,地址是:https://github.com/alibaba/nacos/releases/download/1.1.0/nacos-server-1.1.0.tar.gz ;
- 下载的安装包解压后,文件 nacos/conf/nacos-mysql.sql 就是我们所需的sql脚本;
- 打开此脚本,可见内容中没有创建数据库,这样的脚本在mysql的docker容器内无法自动执行,需要在sql文件的开始位置添加以下内容:
CREATE DATABASE nacos_config;
use nacos_config;
- 将文件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'
- 至此,准备完毕,可以验证了;
验证
- 首先验证nacos的配置服务是否正常,验证方法和操作步骤和《Docker下,两分钟极速体验Nacos配置中心》完全一致,下面给出关键步骤:
- 在docker-compose.yml文件所在目录执行以下命令,即可启动所有容器:
docker-compose up -d
- 我这里宿主机的IP是192.168.121.131,登录Nacos的web页面,创建应用所需的配置项,地址是:http://192.168.121.131:8848/nacos ,用户名和密码都是nacos;
- 如下图,新增一个配置项:
- 浏览器访问地址:http://192.168.121.131:8080/test ,如下图,可见应用已经从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的配置页面,原来的数据还在:
- 访问demo应用,依然可以成功从nacos取得配置内容:
- 至此,Docker下Nacos持久化配置实战就完成了,希望能给您的容器化项目提供一些参考。
官方Docker服务
- Naocs的官方也给出了Docker下的Nacos镜像以及对应的编排操作指南,地址是:https://github.com/nacos-group/nacos-docker ,您也可以根据官方指导来实践,官方编排提供了更多的设置和配置,功能更强大,但是由于内容过多(例如Mysql使用了主从的容器设置),不适合本次文章的主题,因此我这里依然沿用了之前自己动手做的镜像;