MySQL Manager

管理本地开发实例共用的 MySQL Docker 容器。

架构

mysql-manager/
├── docker-compose.yml   # MySQL 8.0 容器
└── run.sh               # 生命周期管理 + 数据库管理 CLI

MySQL 容器运行在共享的 Docker 网络上（默认为 nginx-proxy_net），因此所有应用容器均可通过主机名（codai_db）访问该容器。数据持久化存储于命名卷（mysql_data）中。

命令

./run.sh start                    # 启动 MySQL 容器
./run.sh stop                     # 停止容器（数据保留在卷中）
./run.sh status                   # 查看容器状态 + 列出数据库
./run.sh wait                     # 阻塞等待，直至 MySQL 就绪（适用于脚本调用）
./run.sh create-db          # CREATE DATABASE IF NOT EXISTS
./run.sh drop-db            # DROP DATABASE（交互式确认）
./run.sh dump          # mysqldump src | mysql dest
./run.sh list-dbs                 # SHOW DATABASES（过滤后输出）

任务执行方式

首次启动 MySQL

cd mysql-manager && ./run.sh start

首次运行时，Docker 将创建数据卷并初始化 codai_main 数据库。

为新实例创建数据库

./run.sh create-db codai_alpha

将主数据库快照复制到新实例

./run.sh dump codai_main codai_alpha

删除工作树对应的数据库

./run.sh drop-db codai_alpha   # 会提示确认

检查状态

./run.sh status

启动顺序

必须在启动任意应用实例之前先启动 MySQL：

1. proxy-manager：./run.sh start（创建共享 Docker 网络）
2. mysql-manager：./run.sh start（加入共享网络）
3. worktree-manager：./run.sh start

配置

可通过环境变量或 mysql-manager/ 目录下的 .env 文件设置：

规则

• 禁止删除 MYSQL_MAIN_DB —— 它是所有快照的唯一可信数据源。
• drop-db 命令始终要求交互式确认。
• 所有 SQL 或 Shell 操作前，数据库名均需通过正则表达式 ^[a-z][a-z0-9_]{0,62}$ 校验。
• stop 命令保留 Docker 卷中的数据。docker compose down -v 仅在明确需要清除持久化数据时使用。
• 容器配置了 restart: unless-stopped —— Docker 守护进程重启后会自动恢复运行。完成使用后请运行 ./run.sh stop 显式停止。
• 宿主机端口（MYSQL_PORT）仅绑定至 127.0.0.1。在共享机器上，请务必设置非默认的 MYSQL_ROOT_PASSWORD。
• 容器名称（codai_db）即为后端应用连接数据库时使用的主机名。

相关插件

• proxy-manager —— 管理用于将流量路由至各应用实例的 nginx-proxy（需最先启动）
• worktree-manager —— 管理应用实例与 Git 工作树（依赖本插件）