服务注册与分布式协调 / 系统课时

切换外置数据库保存系统数据

切换外置数据库保存系统数据

内置存储适合快速验证,但生产环境需要把持久化数据放到可备份、可审计的外置数据库。本节以 Nacos 3.x 发行包和 MySQL 为例,完成 Schema 初始化、数据源切换、既有配置迁移,并验证重启后配置仍然存在。

学习目标

  • 能初始化 Nacos 所需的 MySQL Schema,并配置外置数据源。
  • 能在切换前备份既有配置,避免把“换数据库”误当成“自动迁移”。
  • 能通过重启验证配置确实由外置数据库持久化。

切换前确认迁移边界

修改数据源配置只会改变 Nacos 之后读写的位置,不会自动把旧的 Derby 数据复制到 MySQL。已有环境应安排维护窗口,先备份可迁移数据,再初始化目标库并切换;配置数据可以使用 Nacos 的导出与导入能力迁移。

本地用户、角色和权限等鉴权数据不包含在配置 ZIP 中。若目标库是全新 Schema,应在切换后按既定账号与权限清单重新初始化,或使用经过同版本验证的数据库迁移方案,不能只复制几张表就假定系统状态完整。

Nacos 从内置存储切换到外置数据库的流程

初始化 MySQL Schema

先让数据库管理员准备专用账号与目标库,再使用发行包自带的 conf/mysql-schema.sql 初始化表结构。下面命令中的 <DB_HOST>、<DB_PORT>、<DB_ADMIN_USER> 与 <PATH> 都要替换成实际值。

bash
set -euo pipefail

DB_HOST='<DB_HOST>'
DB_PORT='<DB_PORT>'
DB_ADMIN='<DB_ADMIN_USER>'
NACOS_HOME='<PATH>'

mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_ADMIN" -p   -e "CREATE DATABASE IF NOT EXISTS nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" >/dev/null

mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_ADMIN" -p   nacos < "$NACOS_HOME/conf/mysql-schema.sql" >/dev/null

TABLE_OK="$(mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_ADMIN" -p -Nse   "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='nacos' AND table_name='config_info';")"

printf 'config_info_table=%s\n' "$TABLE_OK"

预期输出

text
config_info_table=1

看到 1 说明核心配置表已经创建。生产环境不要让 Nacos 使用数据库管理员账号,应该使用只对 nacos 库具有所需权限的专用账号,并把密码交给部署系统或密钥系统管理。

配置 Nacos 使用外置数据库

修改 <PATH>/conf/application.properties。下面使用 Nacos 3.x 新部署常用的 spring.sql.init.platform 与 db.* 配置,并通过环境变量注入数据库账号密码。

properties
spring.sql.init.platform=mysql

db.num=1
db.url.0=jdbc:mysql://<DB_HOST>:<DB_PORT>/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user=${MYSQL_USER}
db.password=${MYSQL_PASSWORD}

db.pool.config.connectionTimeout=3000
db.pool.config.maximumPoolSize=20

这份配置生效后,Nacos 的持久化 SQL 会发往 MySQL。若是多节点集群,所有节点必须使用同一套数据库地址、Schema 和凭据来源;不要让部分节点仍指向内置存储。

迁移既有配置

切换前可先从旧 Nacos 导出配置。下面示例以 public 命名空间为例,要求默认 Nacos 鉴权或 LDAP 鉴权可通过用户名密码登录,并已安装 curl 与 jq。<NACOS_PASSWORD> 和 <PATH> 需要替换。

bash
set -euo pipefail

NACOS='http://127.0.0.1:8848'
NACOS_USER='nacos'
NACOS_PASSWORD='<NACOS_PASSWORD>'
BACKUP='<PATH>/public-config.zip'

TOKEN="$(curl -fsS -X POST "$NACOS/nacos/v3/auth/user/login"   -d "username=$NACOS_USER&password=$NACOS_PASSWORD"   | jq -r '.accessToken')"

curl -fsS -G "$NACOS/nacos/v3/admin/cs/config/export"   -H "Authorization: Bearer $TOKEN"   --data-urlencode 'namespaceId=public'   --data-urlencode 'ids='   -o "$BACKUP"

test -s "$BACKUP" && echo 'backup-ready'

预期输出

text
backup-ready

有多个命名空间时要逐个导出并记录对应 Namespace ID。完成 MySQL 切换并初始化新环境的管理员身份后,再把 ZIP 导入原来的命名空间;导入前先确认冲突策略,避免误覆盖已经在新库产生的配置。

bash
set -euo pipefail

NACOS='http://127.0.0.1:8848'
NACOS_USER='nacos'
NACOS_PASSWORD='<NACOS_PASSWORD>'
BACKUP='<PATH>/public-config.zip'

TOKEN="$(curl -fsS -X POST "$NACOS/nacos/v3/auth/user/login"   -d "username=$NACOS_USER&password=$NACOS_PASSWORD"   | jq -r '.accessToken')"

curl -fsS -X POST "$NACOS/nacos/v3/admin/cs/config/import"   -H "Authorization: Bearer $TOKEN"   -F 'namespaceId=public'   -F 'policy=ABORT'   -F "file=@$BACKUP"   | jq -e '.code == 0' >/dev/null

echo 'import-ok'

预期输出

text
import-ok

重启验证持久化结果

最后不要只看“服务启动成功”,而要写入一条测试配置、重启 Nacos,再重新读取它。下面示例假定数据库环境变量会随 Nacos 进程启动时注入,且默认鉴权已可登录。

bash
set -euo pipefail

NACOS_HOME='<PATH>'
NACOS='http://127.0.0.1:8848'
NACOS_USER='nacos'
NACOS_PASSWORD='<NACOS_PASSWORD>'
export MYSQL_USER='nacos'
export MYSQL_PASSWORD='<DB_PASSWORD>'

TOKEN="$(curl -fsS -X POST "$NACOS/nacos/v3/auth/user/login"   -d "username=$NACOS_USER&password=$NACOS_PASSWORD"   | jq -r '.accessToken')"

curl -fsS -X POST "$NACOS/nacos/v3/admin/cs/config"   -H "Authorization: Bearer $TOKEN"   -d 'namespaceId=public'   -d 'groupName=DEFAULT_GROUP'   -d 'dataId=storage-check.properties'   --data-urlencode 'content=storage=external-mysql'   | jq -e '.data == true' >/dev/null

bash "$NACOS_HOME/bin/shutdown.sh" >/dev/null 2>&1
sleep 5
bash "$NACOS_HOME/bin/startup.sh" -m standalone >/dev/null 2>&1

for _ in $(seq 1 30); do
  if curl -fsS -G "$NACOS/nacos/v3/client/cs/config"     -H "Authorization: Bearer $TOKEN"     --data-urlencode 'namespaceId=public'     --data-urlencode 'groupName=DEFAULT_GROUP'     --data-urlencode 'dataId=storage-check.properties'     -o /tmp/nacos-storage-check.json 2>/dev/null; then
    break
  fi
  sleep 2
done

jq -r '.data.content' /tmp/nacos-storage-check.json

预期输出

text
storage=external-mysql

如果重启后读取不到这条配置,优先检查数据库连通性、Schema 是否完整、Nacos 启动进程是否拿到了 MYSQL_USER 与 MYSQL_PASSWORD,以及是否仍有更高优先级的启动参数覆盖 application.properties。只有写入、重启、再次读取三步都通过,才能认为外置数据库切换完成。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

切换外置数据库保存系统数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通