記事と画像を、もう1つの練習サイトへ引っ越す

空の移行先を用意し、書き出し、取り込み計画の確認、実行、表示の照合まで進めます。

目次

記事と画像をまとめたファイルを作り、別のEmDashサイトへ取り込めます。この実習では手元に2つのサイトを用意し、移行元を残したまま、空の移行先へコピーします。

移行先には、新しく用意した、記事のないサイトが必要です。すでに記事があるサイトへ継ぎ足す用途には使いません。

先に用意するもの

写真付き一覧のガイドの「練習用サイトを準備する」まで済ませてください。同じダウンロード教材「週末ノート」を使います。EmDash 1.4.0、Astro 7.4.5、Node.js 24.22.1が対象です。実行確認はmacOSで行いました。Windows向けの入力例はコマンドプロンプト用で、Windows実機では未確認です。

以下のファイル名は、特に断りがなければ教材の weekend-note フォルダーからの場所です。ファイルの内容はVS Codeで編集し、指定された名前で保存します。コマンドはファイルに保存せず、コマンド入力画面へ貼り付けて実行します。どちらも、囲みの前にある説明で作業する場所を確認してください。開発サーバーは weekend-note のコマンド入力画面で npm run dev を実行しておきます。

起動に使った画面は開いたままにします。このあとのコマンドは、別の入力画面で実行します。VS Code左側のファイル一覧で weekend-note フォルダーを右クリックし、**Open in Integrated Terminal(統合ターミナルで開く)**を選ぶと、そのフォルダーを作業場所にした画面を開けます。Windowsでは、パソコンの準備で選んだコマンドプロンプトを使います。

1. 元のサイトに写真を1枚入れる

写真付き一覧の実習を済ませ、4350の /cards/ で「週末の記録 01」の画像が出ることを確認します。画像がないまま移行しても、画像の移行を確かめることはできません。

ここからの役割を先に確認しましょう。

役割作業フォルダーURLの番号
移行元weekend-note4350
空の移行先weekend-receiver4352

どちらも教材内のSQLiteと画像保存フォルダーを使い、実サイトには接続しません。

2. 空の移行先を起動する

新しいコマンド入力画面を開きます。教材の親フォルダーにいるなら、次を実行します。すでに weekend-note にいる場合は、最初の行を cd ../weekend-receiver に置き換えます。

cd weekend-receiver
npm ci
npm run dev

初回だけ、ブラウザーで次を開きます。

http://127.0.0.1:4352/_emdash/api/setup/dev-bypass?redirect=/_emdash/admin

移行先の教材には記事の初期データがありません。管理画面が開き、記事がまだない状態で進めます。初期設定として作られる分類などがあっても、取り込み計画で扱いを確認できます。

3. 移行元から書き出す

移行元の weekend-note のコマンド入力画面へ戻り、実行します。

npx emdash site export --output exercises/weekend.emdash --url http://127.0.0.1:4350

exercises/weekend.emdash ができます。このファイルに記事や画像などが入ります。書き出しが完了してから、次へ進みます。

この後も、コマンドは weekend-note から実行します。操作先を決めるのは --url なので、取り込みでは4352へ変えます。

4. 取り込み計画を確認する

npx emdash site import exercises/weekend.emdash --analyze --url http://127.0.0.1:4352 --json

--analyzeは、記事や画像を取り込む前に、取り込み計画を確認する指定です。計画を作るため、移行ファイル自体は移行先へ送られます。手元だけで完結する確認ではない点に注意してください。

結果で次を確認します。

  • executable が true である。
  • blockers が空で、取り込みを止める問題がない。
  • warnings と、記事・画像の件数を確認した。
  • principals と principalMappings で、記事の担当者の対応先が意図どおりになっている。
  • サイト名や説明文を、どちらから使う計画になっているかを確認した。

教材では開発用管理者のメールアドレスが同じなので、自動で対応付けられました。違う利用者を持つサイトで同じ結果になるとは限りません。問題がある場合は、公式のサイト移行ガイド(別タブで開く)で指摘内容を確認してから計画を作り直します。

5. 確認した計画で取り込む

結果にあるplanDigestは、確認した計画を見分けるための値です。sha256:で始まる長い文字列全体をコピーし、以下のPLAN_DIGESTをその値に置き換えます。

npx emdash site import exercises/weekend.emdash --plan PLAN_DIGEST --confirm --url http://127.0.0.1:4352 --json

--confirm は、確認した計画の実行を指示します。state が complete になれば完了です。検証では受領記録の verification が verified、receiptDigestValid が true になりました。

計画が変わったと表示された場合は、古い値のまま何度も実行せず、もう一度 --analyze して内容を確認します。

6. 移行先を自分の目で確かめる

http://127.0.0.1:4352/cards/ を開き、記事のタイトルと画像を見ます。記事のリンクを押し、本文と関連記事も確認します。下書きは管理画面にはあり、公開用の一覧には出ないことを確認してください。

検証時は、実習で作った分を含めて14件の記事、1枚の画像、5つの入力項目を移しました。書き出し後に元の記事を直した内容は、このファイルには含まれません。自分が何本作ったかによって件数は変わります。

画像を別のタブで開くなどして、画像URLが移行先の4352番を指し、表示できることも確認します。元の4350番から読み込んでいると、移行元を止めたときに見えなくなるためです。検証でも、移行先の画像URLで取得できることを確かめました。

移行ファイルだけではそろわないもの

サイトのコード、サーバー設定、ログイン用の秘密情報は、移行ファイルとは別に用意する必要があります。今回は、同じテーマとプラグインを持つ空の教材を先に起動しました。実サイトでも、移行先で使うコードと設定を準備してから取り込みます。

また、ユーザーをそのまま複製するのではなく、記事の担当者を移行先のユーザーへ対応付けます。日々の障害復旧にはバックアップの考え方も確認してください。

終了とやり直し

2つのサイトをそれぞれ停止します。npm run devを実行した画面が入力待ちに戻っていなければ、その画面でControl + Cを押します。入力待ちへ戻ったあとも動いている場合は、該当するフォルダーでnpx astro dev stopを実行してください。次回は各フォルダーでnpm run devを実行します。停止後も、移行先の記事は残っています。

取り込みを最初から練習し直すなら、教材ZIPを別の新しいフォルダーへ展開します。取り込み済みのDBを手当たり次第に消したり、使用中の移行先へ繰り返し取り込んだりする必要はありません。

公式の参照元

関連ガイド

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

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