Show HN: db-branch – ZFS経由でAIエージェントやCIのために数秒でデータベースブランチを作成
Show HN: db-branch – database branches in seconds for AI agents and CI, via ZFS (github.com)
要約
db-branchは、ZFSクローンを利用してMySQLおよびPostgreSQLデータベースのブランチを数秒で作成できるツールです。これにより、マイグレーションのテスト、AIエージェントの実行、またはプルリクエストごとにデータベースのコピーを提供することが容易になります。データはコピーオンライト方式で複製されるため、ストレージ容量を節約し、ブランチの作成、リセット、破棄を高速に行えます。このプロジェクトは現在ベータ版であり、セルフホスト型でApache-2.0ライセンスの下で提供されています。
全文翻訳
db-branch
MySQLおよびPostgreSQLのインスタントデータベースブランチを、お客様自身のサーバーで。
マイグレーションをテストしたり、AIエージェントを自由に実行させたり、各プルリクエストにデータベースのコピーを提供したりできます。db-branchは、何もコピーせずに数秒で大規模データベースのコピーオンライトブランチを作成します。破壊しても、リセットしても、破棄しても構いません。ZFSクローン上に構築され、セルフホスト型で、Apache-2.0ライセンスです。
ステータス: ベータ版。 db-branchは現在使用可能ですが、APIやコマンドラインの詳細が1.0まで変更される可能性があります。これは独立したオープンソースプロジェクトで、ゼロから構築されました。
[画像: ブランチを作成し、テーブルを削除し、ブランチをリセットし、削除する]
試してみる
-
ブラウザで、0分。 ライブコンソールデモはページ全体で実行されます(実際には何も作成されません): https://demo.db-branch.com/
-
MacまたはWindowsマシンで、約2分。 db-branchはLinuxとZFSを必要とするため、Multipassを使用したUbuntu VMで実行します。1つのコマンドでVMを作成し、db-branchをインストールし、ファイルベースのZFSプールで初期化し、小さなサンプルベース「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 # セットアップを待機(約2分) 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 --recordWindows(PowerShellまたはcmd)では、
multipass launchコマンドを1行にし、\を削除します。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- ヒストリーモジュールがオンになり、有料モジュールはキーなしで30日間実行されます。
--recordはブランチを記録するため、いつでも復元できます。 - プールはファイルなので、遅く、実際のデータには適していません。最初の管理者パスワードは
adminです。コンソールは初回サインイン時に新しいパスワードを要求します。 - Apple Silicon(およびその他のarm64マシン)では、セットアップはMySQLの場合約800MBをダウンロードしますが、Intelでは80MBです。これは、Oracleがarm64用の最小ビルドを提供していないためです。
--timeout 900は、launchが接続不良でタイムアウトするのを防ぎます。 - セットアップが失敗した場合、
/etc/motdにその旨が表示され、VMでsudo tail -n 30 /var/log/cloud-init-output.logを実行すると理由が表示されます。 - VMは
multipass delete --purge db-branch-evalで削除します。
- ヒストリーモジュールがオンになり、有料モジュールはキーなしで30日間実行されます。
-
お客様自身のUbuntuサーバーで。 インストールを参照してください。
ユースケース
- AIエージェントサンドボックス。 組み込みのMCPサーバーにより、LLMエージェントはブランチを作成し、それにリスクのあるクエリやマイグレーションを実行し、ブランチを削除できます。これにより、本番データが侵害されることはありません。
- プルリクエストごとのデータベース。 各CI実行またはPRは、数秒で準備完了する独自のデータベースコピーを取得し、不要になったら
--ttlによって削除されます。 - バージョンアップグレードチェック。 MySQL 8.0から8.4へのメジャーバージョンアップグレードなどを、まず1つのブランチで
branch upgrade --check-onlyを実行して、何が問題になるかを確認してから、ベースに触れます。
機能
- 数秒でのブランチ作成。 独自の3ノードテストクラスターでは、PostgreSQLブランチは約0.5秒、MySQLブランチは約3秒で準備完了します。作成時に0バイトしかコピーされません(コピーオンライト)。
- リセットと期限切れ。
branch resetはブランチを作成時の状態に戻します。--ttlは自動的に削除します。 - チェックポイント。
branch checkpointは実行中のブランチの状態を即座に保存します。branch restoreはそれを元に戻します。復元は現在の状態を置き換え、既存のチェックポイントはすべて復元可能です。 - ブランチごとのアップグレード。
branch upgradeは、ベースと他のブランチはそのままで、1つのブランチを新しいMySQLまたはPostgreSQLバージョンに移動します。まずチェックポイントが保存され、アップグレードが失敗した場合は自動的にロールバックします。 - MySQLおよびPostgreSQL、複数のバージョンを同時に。 エンジンランタイムはバージョンごとにインストールされ、共存できます。
- どこでも同じインターフェース。 CLI、REST API、Webコンソール、MCPサーバー(LLMエージェントが独自のブランチを作成・クエリできるようにするため)はすべて同じAPIを使用します。
- シングルノードまたはクラスター。 オプションでProxySQLルーティングを備えたVMのRaftクラスターにより、アプリケーションは単一のアドレスを維持します。
Webコンソール
[画像: Webコンソールのブランチページ] [画像: 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 # ベース: お客様のデータ、一度ロードされます
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で一覧表示できます。1つの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 # このブランチのみを移動します。まずチェックポイントが保存されます
仕組み
ベースは、ロードされたデータベースを保持するZFSデータセットです。ブランチはベーススナップショットのZFSクローンであるため、作成時に何もコピーされず、各ブランチは独自のデータベースサーバーを独自のポートで実行します。オプションで、ProxySQLはユーザー名(または/*db_branch='name'*/クエリコメント)によってクライアント接続を適切なブランチにルーティングします。複数のノードがRaftクラスターを形成し、ベース、ブランチ、設定、ユーザーを共有します。
エディション
- コア(このリポジトリ)、Apache-2.0: ブランチ、ベース、ランタイム、クラスタリング、CLI、API、Webコンソール、MCP、モニタリング、通知、制限付きの匿名(サインインなし)ブランチ、スケジュールされたベースリフレッシュ、クラスター状態のバックアップ。
- 無料モジュール(同じaptリポジトリ内):
proxysql、greenmask、greenmask-mysql、anon(ルーティングとデータマスキング)。 - 有料モジュール(認証/SSO、監査、履歴、差分、FSxストレージ)は、別個のクローズドソースパッケージで、セルフホストされ、ライセンスキー(月次または年次)で有効化されます。管理されたマスキングワークフローは、オプトインベータとして計画されており、現時点ではどのプランにも含まれていません。拡張ポイントについては、docs/modules.mdを参照してください。
db-branchのホスト型またはクラウド版はありません。
ドキュメント
- docs/README.md: 設計および参照ドキュメントのインデックス(日本語で記述)
- 英語のユーザー向けドキュメント: https://db-branch.com/docs/
- ウェブサイト: https://db-branch.com(英語)、https://db-branch.com/ja/(日本語)
- api/openapi.yaml: 機械可読なREST API定義
- CHANGELOG.md
貢献、セキュリティ、サポート
- 貢献を歓迎します: CONTRIBUTING.mdを参照してください。コミットにはDCOサインオフ(
git commit -s)が必要です。 - セキュリティに関する問題: SECURITY.mdを参照してください。公開イシューではなく、プライベート脆弱性報告を使用してください。
- サポート: SUPPORT.mdを参照してください。サポートは保証されていません。イシューは可能な限り読みます。
- Code of Conductに従ってください。
ライセンス
Apache-2.0。 LICENSEおよびNOTICEを参照してください。
日本語
db-branch は、ZFS クローンで MySQL / PostgreSQL のデータベースブランチを発行・リセット・破棄するツールです。現在は Beta で、1.0 までに API が変わる可能性があります。コアは Apache-2.0 で、有償モジュール(認証/SSO・監査・履歴・差分・FSx ストレージ)は別パッケージ(クローズドソース、セルフホスト、ライセンスキー)です。
Mac / Windows では、Multipass のコマンド1つで試せます: https://db-branch.com/ja/docs/getting-started/#multipass-ですぐ試す。日本語のサイトは https://db-branch.com/ja/、設計ドキュメントは docs/ にあります(日本語)。