Bun のデータ管理
Bun 実行環境は、信頼性の高い SQLite データベースを $GMSHOP_DATA_DIR/gmshop.sqlite に保存し、プライベートなオブジェクトを同じデータディレクトリ内に保存します。 メンテナンスされている bun run data -- … コマンドを使用し、ライブな SQLite ファイルをコピーするのではなく、利用してください。
バックアップと復元
バックアップまたは復元を行う前に、コンテナを停止することで、データベース、プライベートオブジェクト、および耐久性キューの状態を、一つの論理的な時点に保ちます。
GMSHOP_DATA_DIR=/srv/gmshop bun run data -- backup \
--output /srv/backups/gmshop-2026-08-21
GMSHOP_DATA_DIR=/srv/gmshop-restored bun run data -- restore \
--input /srv/backups/gmshop-2026-08-21バックアップ出力はデータディレクトリ外に出します。復元は、新しいまたは空のターゲットのみを受け取り、既存のインスタンスを上書きしません。マニフェストはすべてのファイルを検証し、復元時にはSQLiteの整合性、外部キー、および不変な移行チェックサムも確認します。
公開された画像には、同じCLIが含まれています。
docker compose stop gmshop-edge
docker compose run --rm --no-deps \
--volume "$PWD/backups:/backups" \
gmshop-edge bun run data -- backup --output /backups/gmshop-2026-08-21バックアップには、認証情報、顧客記録、注文、既定の在庫、プライベートダウンロード、および自動化関連データが含まれます。保存時の暗号化、アクセス制限、定期的な復元テストを実施してください。
CLIは $GMSHOP_DATA_DIR/.maintenance.lock を使用します。クラッシュによってロックファイルが残った場合、まず、そのディレクトリがサーバーまたはデータコマンドによって使用されていないことを確認し、古いロックファイルのみを削除してください。
Cloudflareのエクスポートをインポートする
D1 と R2 を、元のキーに一致するローカルディレクトリに SQL および R2 オブジェクトとしてエクスポートします。新しいまたは空の Bun データディレクトリにのみインポートしてください。
wrangler d1 export DB --remote --output ./d1-export.sql
GMSHOP_DATA_DIR=/srv/gmshop bun run data -- import-cloudflare \
--d1-sql ./d1-export.sql \
--r2-dir ./r2-export \
--r2-manifest ./r2-metadata.json--r2-dir は、インスタンスにオブジェクトがない場合にオプションです。 --r2-manifest もオプションですが、--r2-dir が必要です。R2 HTTP およびカスタムメタデータが保持されます。
輸入者は、リポジトリの移行、SQLiteの整合性、および外部キーを検証し、R2キーをハッシュ化されたオブジェクトの形式に変換します。同時に、危険なパス、不明なメタデータ、オブジェクトなしのメタデータ、および空でないターゲットを拒否します。 復帰モードや双方向の同期機能は提供されません。