保存すべきデータと復旧手順を整理する
JSONの書き出し、サイト転送、障害からの復元を区別します。データベース、画像、コード、暗号化キーを一組で保存する考え方を学びます。
目次
バックアップは「戻せること」まで確認する
サイトを復旧するには、データベース、画像などの実ファイル、動作するコード、暗号化キーなどの秘密値を揃えて保存します。記事を書き出したファイルだけでは、ログインできるサイトへ戻せるとは限りません。
これらは別々の場所に保存されるため、どの組み合わせで使っていたかも記録します。保存日時、対象の環境、コードの版を残し、その組み合わせで復旧できることを確認しましょう。
似ているコピー機能の違い
| 方法 | 主な目的 | そのまま障害復旧に使えるか |
|---|---|---|
| seed | 新規サイトの初期設定 | 運用中データの完全復元には使わない |
| 管理画面のJSONバックアップ | 内容の確認や独自処理 | このJSONを復元する標準機能はない |
| サイトパッケージ | 別の空のEmDashへ内容を移す | ユーザーや秘密値などは移らない |
| 生のデータベースのバックアップ | 元の環境のデータを復元 | 画像、コード、秘密値も別に揃える |
「JSONをダウンロードしたから、更新に失敗しても戻せる」とは判断しないでください。公式ガイド(別タブで開く)も、JSONを破壊的変更前の復旧地点として使わないと説明しています。
保存する4種類
データベースには、記事だけでなくユーザー、設定、変更履歴、プラグインの記録などがあります。使用しているデータベース全体を復元する方法を選びます。
画像などの実ファイルは、R2やローカル保存先から別にコピーします。データベースに画像の登録情報が残っていても、ファイルがなければ画像は表示できません。
コードと設定は、依存パッケージの版を決めるlockファイルと一緒に保存します。復元したデータに対応する版が必要です。
暗号化キーなどの秘密値は、通常のコード保管先と分けて管理します。暗号化した設定を戻すには、それに対応するEMDASH_ENCRYPTION_KEYが必要です。キーを切り替えたことがあるなら、必要な旧キーも含めた一覧を保管します。
ローカルSQLiteの例
SQLiteは、一つのファイルを中心にデータを保存するデータベースです。実際の場所はastro.config.mjsのdatabase設定で確認します。以下は、プロジェクトのdata/emdash.dbを使う場合の例です。別のパスなら置き換えます。
SQLiteのコマンドが使える環境で、プロジェクトのフォルダーから実行します。EmDashがSQLiteを使えていても、sqlite3 というコマンドまで入っているとは限りません。sqlite3 --version で番号が出ない場合は、制作担当者にSQLiteのコマンド用ツール(別タブで開く)の準備を依頼してください。
VS Codeのターミナルを開き、Windowsではコマンドプロンプトを選びます。入力画面の開き方も参照してください。保存先は新しい日時名のフォルダーにして、以前のバックアップを上書きしないようにします。以下の日付は実行日のものへ置き換え、どちらか一方の手順を1行ずつ実行します。
Macの場合
mkdir -p backups/2026-11-07
sqlite3 data/emdash.db ".backup backups/2026-11-07/emdash.db"
sqlite3 backups/2026-11-07/emdash.db "PRAGMA integrity_check"Windowsのコマンドプロンプトの場合
mkdir backups\2026-11-07
sqlite3 data/emdash.db ".backup backups/2026-11-07/emdash.db"
sqlite3 backups/2026-11-07/emdash.db "PRAGMA integrity_check"最初の行で保存先フォルダーを作り、次の行でデータベース(DB)をバックアップします。最後の行では、コピーしたDBの内部に矛盾がないかを確認します。Windowsではフォルダー作成に -p を付けません。SQLiteへ渡すパスは、上の例ではどちらも / 区切りです。
最後の確認でokと表示される想定です。画像の表示やログインまで復元できるかは、別に確認する必要があります。
普通のファイルコピーで保存する場合は、書き込み処理を止め、隣にある-walや-shmも含めた公式手順を使います。稼働中のDB本体だけをコピーすると、直近の確定済みデータを取りこぼす場合があります。
Cloudflare D1とR2の例
D1ではTime Travelという、過去の時点へ戻す仕組みを使えます。更新前に次で復旧地点の情報を取得し、記録します。my-databaseは自分の対象名へ置き換えます。
npx wrangler d1 time-travel info my-database保持期間には限りがあります。必要な期間がそれを超える場合や、別のDBで復元を試す場合は、外部へSQLを書き出す方法も準備します。
EmDashで検索を有効にするとFTS5という検索用の特殊テーブルがあり、D1の全体exportがそのまま通らない場合があります。公式手順では検索索引を除き、テーブル定義、メディアフォルダー、データ、index・triggerを分けて保存します。独自に一部を省略せず、D1の書き出し手順(別タブで開く)で対象と順序を確認してください。
R2の画像は別に保存します。復元確認は空の復旧用バケットと別のDBへ行い、元のサイトと同じ画像が開くかを確かめます。公開バケットにバックアップも置く場合は、JSONやSQLが読者へ公開されない配置にします。
復元のリハーサル
- 対応するコード、DB、画像、キーが揃った復旧地点を選びます。
- 公開先と分けた空の復旧環境を作ります。
- DBとファイルを、それぞれの方式の手順で復元します。
- 復旧環境の接続先と秘密値を設定し、対応するコードで起動します。
- ログイン、公開記事、下書き、変更履歴、画像、暗号化設定を確認します。
- 練習記事の保存・公開も試し、書き込みできることを確認します。
公開先へ戻す段階では、書き込みを止める範囲と、新しいデータがどこまで失われるかも確認します。古い時点へ戻すと、その後の投稿や編集が残らない場合があります。
ローカルから公開先へ「移す」場合
新しいサイトへ記事と画像を移す目的なら、サイトパッケージを使えます。移行先の空のサイトでパッケージを解析し、移行元と移行先の利用者を対応付けてから取り込みます。取り込み結果の記録(receipt)を使い、移した内容が合っているか確認します。
ただし、ユーザーのログイン情報、APIトークン、プラグインの保存データや秘密値は含まれません。公開先のURLなど、移行先が維持する設定もあります。障害復旧とは分けて、公式のサイト転送ガイド(別タブで開く)を使います。
コードを戻す操作と、データの復元の違いは、Cloudflareの切り戻し実習でも確かめられます。Workerだけを戻した後、D1のメモとR2の画像を別々に確認します。