32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
# DBX 数据库测试环境
|
||
|
||
此目录提供可重复创建的 Docker Compose 数据库环境，用于人工验证数据库功能。每个带版本的配方都固定镜像版本、使用命名卷、仅绑定本机回环地址、定义健康检查，并提供初始化数据或在验证阶段创建的冒烟数据。
|
||
|
||
在仓库根目录执行：
|
||
|
||
```bash
|
||
make db-list
|
||
make db DB=mysql@8.4
|
||
make db-verify DB=postgresql@17.4
|
||
make db-down DB=postgresql@17.4
|
||
```
|
||
|
||
所有网络数据库默认使用标准端口 `+1` 的宿主端口，默认密码统一为 `123456`，默认数据库名为 `dbx`；Redis 使用 DB 0 和 `dbx:` 键前缀。容器名统一为 `dbx-<product>-<version>`。同一种数据库的不同版本共用默认宿主端口，并行启动时请使用 `DB_PORT` 覆盖其中一个端口。`DB_PORT` 和 `DB_PASSWORD` 可以覆盖默认主机端口和密码。端口默认仅绑定 `127.0.0.1`；如需远程访问，必须显式设置 `DB_BIND_ADDRESS=0.0.0.0`，同时使用强密码和防火墙限制访问。`make db-reset` 会删除命名卷及其数据，因此必须显式传入 `CONFIRM=1`：
|
||
|
||
```bash
|
||
make db-reset DB=redis@7.4 CONFIRM=1
|
||
```
|
||
|
||
主要 Make 目标为 `db-list`、`db`、`db-verify`、`db-down`、`db-reset` 和 `db-check`。执行 `make db` 会为每个配方输出一条可直接复制的启动命令。`make db-completion` 会输出 Bash、Zsh 和 PowerShell 补全加载命令，`completion/` 中的脚本会动态补全配方选择器。目标不再依赖 POSIX Shell 条件语法，可在 PowerShell、Git Bash 或 WSL 中通过 GNU Make 使用。诊断时可使用底层命令 `pnpm db:env -- info|status|logs|shell <product> <version>`。
|
||
|
||
## 配方结构
|
||
|
||
```text
|
||
<product>/<version>/
|
||
├── recipe.json # 连接字段和冒烟命令
|
||
├── compose.yaml # Docker Compose 环境
|
||
└── init/ # 环境初始化数据
|
||
```
|
||
|
||
Redis 不支持镜像初始化目录约定；其 `init/README.md` 说明了 `verify` 会创建并读取的冒烟键。添加或修改配方后运行 `make db-check`。它会检查配方结构、标准容器名，并要求 Docker Compose 校验每个 Compose 文件。
|