保存すべきデータと復旧手順を整理する

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が読者へ公開されない配置にします。

復元のリハーサル

  1. 対応するコード、DB、画像、キーが揃った復旧地点を選びます。
  2. 公開先と分けた空の復旧環境を作ります。
  3. DBとファイルを、それぞれの方式の手順で復元します。
  4. 復旧環境の接続先と秘密値を設定し、対応するコードで起動します。
  5. ログイン、公開記事、下書き、変更履歴、画像、暗号化設定を確認します。
  6. 練習記事の保存・公開も試し、書き込みできることを確認します。

公開先へ戻す段階では、書き込みを止める範囲と、新しいデータがどこまで失われるかも確認します。古い時点へ戻すと、その後の投稿や編集が残らない場合があります。

ローカルから公開先へ「移す」場合

新しいサイトへ記事と画像を移す目的なら、サイトパッケージを使えます。移行先の空のサイトでパッケージを解析し、移行元と移行先の利用者を対応付けてから取り込みます。取り込み結果の記録(receipt)を使い、移した内容が合っているか確認します。

ただし、ユーザーのログイン情報、APIトークン、プラグインの保存データや秘密値は含まれません。公開先のURLなど、移行先が維持する設定もあります。障害復旧とは分けて、公式のサイト転送ガイド(別タブで開く)を使います。

コードを戻す操作と、データの復元の違いは、Cloudflareの切り戻し実習でも確かめられます。Workerだけを戻した後、D1のメモとR2の画像を別々に確認します。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。