HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: db-branch – ZFS経由でAIエージェントやCIのために数秒でデータベースブランチを作成

Show HN: db-branch – database branches in seconds for AI agents and CI, via ZFS (github.com)

24 pointsby nu_nu116 コメント

要約

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まで変更される可能性があります。これは独立したオープンソースプロジェクトで、ゼロから構築されました。

[画像: ブランチを作成し、テーブルを削除し、ブランチをリセットし、削除する]

試してみる

  1. ブラウザで、0分。 ライブコンソールデモはページ全体で実行されます(実際には何も作成されません): https://demo.db-branch.com/

  2. 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 --record
    

    Windows(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で削除します。
  3. お客様自身の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のホスト型またはクラウド版はありません。

ドキュメント

貢献、セキュリティ、サポート

  • 貢献を歓迎します: 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/ にあります(日本語)。