
开源项目 db-branch 发布:基于 ZFS 为 AI agent 和 CI 提供秒级数据库分支
来源标题:Show HN: db-branch – database branches in seconds for AI agents and CI, via ZFS
开源项目 db-branch 发布,可在自有服务器上为 MySQL 和 PostgreSQL 秒级创建写时复制数据库分支,无需实际复制数据。它基于 ZFS 克隆,自托管并采用 Apache-2.0 许可,适用于测试迁移、运行 AI agent 或为每个 PR 提供独立数据库副本。项目目前处于 Beta 阶段,API 和命令行细节在 1.0 前可能仍有变动。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
为 MySQL 和 PostgreSQL 在自己服务器上实现秒级数据库分支。
测试迁移、让 AI agent 放手操作,或者给每个 pull request 一份独立的数据库副本。db-branch 能在几秒内为大型数据库创建一个写时复制分支,全程不复制任何数据。改坏了就重置,不用了就丢弃。基于 ZFS clone,自托管,Apache-2.0 许可。
状态:Beta。db-branch 现在已可用,但 API 和命令行细节在 1.0 之前仍可能变化。这是一个从零构建的独立开源项目。
在浏览器里,0 分钟。有一个实时控制台演示完全在页面内运行(不会创建任何真实资源):https://demo.db-branch.com/
在 Mac 或 Windows 机器上,大约 2 分钟。db-branch 需要 Linux 和 ZFS,所以请用 Multipass 在 Ubuntu 虚拟机里运行它。一条命令即可创建虚拟机、安装 db-branch、在基于文件的 ZFS 池上初始化它,并载入一个小型示例 base,名为 shop(MySQL 8.4):
multipass launch 24.04 --name db-branch-eval --memory 4G --disk 30G --timeout 900
--cloud-init https://raw.githubusercontent.com/db-branch/db-branch/main/scripts/eval-cloud-init.yaml
multipass exec db-branch-eval -- cloud-init status --wait # 等待安装完成(约两分钟)
multipass exec db-branch-eval -- cat /etc/motd # 控制台 URL 和登录信息(admin / admin),或失败原因
multipass shell db-branch-eval # 然后执行:sudo db-branch branch create try --base shop --ttl 1h --record
在 Windows 上(PowerShell 或 cmd),请把 multipass launch 命令放在一行,并去掉 \:
multipass launch 24.04 --name db-branch-eval --memory 4G --disk 30G --timeout 900 --cloud-init https://raw.githubusercontent.com/db-branch/db-branch/main/scripts/eval-cloud-init.yaml
history 模块已开启,付费模块可无密钥运行 30 天。--record 会记录一个分支,以便将其恢复到任意时间点。
该池是一个文件,因此速度较慢,不适合存放真实数据。初始管理员密码是 admin;控制台会在首次登录时要求设置新密码。
在 Apple Silicon(以及其他 arm64 机器)上,安装过程会为 MySQL 下载约 800 MB,而在 Intel 上只需 80 MB,因为 Oracle 没有为 arm64 提供最小化构建。--timeout 900 可以防止 launch 在慢速连接下放弃。
如果安装失败,/etc/motd 会说明,而在虚拟机内执行 sudo tail -n 30 /var/log/cloud-init-output.log 可以看到原因。
用 multipass delete --purge db-branch-eval 删除该虚拟机。
在自己的 Ubuntu 服务器上。参见 Install。
AI agent 沙箱。内置的 MCP server 让 LLM agent 可以创建分支、在其上运行有风险的查询或迁移,然后删除该分支,因此生产数据永远不会被触碰。
每个 pull request 一个数据库。每次 CI 运行或每个 PR 都会获得一份大型数据库的独立副本,几秒内就绪,并在不再需要时由 --ttl 自动删除。
版本升级检查。先在一个分支上运行大版本升级(例如 MySQL 8.0 到 8.4),用 branch upgrade --check-only 查看会遇到什么问题,然后再动 base。
功能说明
秒级分支。在我们自己的 3 节点测试集群上,一个 PostgreSQL 分支约 0.5 秒就绪,一个 MySQL 分支约 3 秒就绪,创建时复制 0 字节(写时复制)。
重置与过期。branch reset 将分支返回到创建时的状态;--ttl 会自动删除它。
检查点。branch checkpoint 即时保存运行中分支的状态;branch restore 将其恢复。恢复会替换当前状态,而你已有的每个检查点都仍然可以恢复。
按分支升级。branch upgrade 将单个分支迁移到更新的 MySQL 或 PostgreSQL 版本,而 base 和其他分支保持不动。会先保存一个检查点,升级失败会自动回滚。
MySQL 和 PostgreSQL,多版本并存。引擎运行时按版本安装,可以并存。
处处同一接口。CLI、REST API、Web 控制台和 MCP server(让 LLM agent 可以创建和查询自己的分支)都使用同一套 API。
单节点或集群。由虚拟机组成的 Raft 集群,可选 ProxySQL 路由,让应用保持一个地址。
Web 控制台
要求:Ubuntu 24.04 LTS 或 26.04 LTS,以及一个 ZFS 池(zfsutils-linux 包会作为依赖安装)。
curl -fsSL https://apt.db-branch.com/db-branch.gpg | sudo tee /usr/share/keyrings/db-branch.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/db-branch.gpg] https://apt.db-branch.com stable main" | sudo tee /etc/apt/sources.list.d/db-branch.list
sudo apt update && sudo apt install db-branch
sudo db-branch init --pool <zpool>
仓库签名密钥指纹为 3F404C4E5D49FA653F8385692C6E89E341D4D7A5。db-branch init 会一次性打印初始管理员密码。
db-branch runtime install postgres@18.6 # 一个数据库引擎版本
db-branch base create prod --runtime postgres@18.6 --dump prod.sql.gz # 一个 base:你的数据,只载入一次
db-branch branch create feature-x --base prod --ttl 72h # 一个分支:即时、写时复制
db-branch branch dsn feature-x # 连接 URL(包含密码)
db-branch branch checkpoint feature-x --name before-migration # 保存状态(即时)
db-branch branch restore feature-x before-migration # 回到已保存的状态
db-branch branch reset feature-x # 丢弃所有更改
db-branch branch delete feature-x # 删除它
MySQL 的用法相同,例如 mysql@8.4.13。用 db-branch runtime available 列出可安装的版本。要在一个 MySQL 分支上尝试版本升级:
db-branch branch upgrade feature-x --runtime mysql@8.4.13 --check-only # 升级会遇到什么问题?
db-branch branch upgrade feature-x --runtime mysql@8.4.13 # 只迁移这个分支;会先保存一个检查点
工作原理
base 是一个 ZFS dataset,存放着一个已载入的数据库。分支是 base 快照的 ZFS clone,因此创建一个分支不会复制任何数据,每个分支都在自己的端口上运行自己的数据库服务器。可选地,ProxySQL 按用户名(或通过 /db_branch='name'/ 查询注释)将客户端连接路由到正确的分支。多个节点组成一个 Raft 集群,共享 base、分支、设置和用户。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。