記事と画像を、もう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-note | 4350 |
| 空の移行先 | weekend-receiver | 4352 |
どちらも教材内の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:4350exercises/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を手当たり次第に消したり、使用中の移行先へ繰り返し取り込んだりする必要はありません。