前のコードへ戻して、データと画像が戻らないことを確かめる
v1からv2へ更新した練習用Workerを切り戻します。コード・データベース・画像を別々に確認し、戻る範囲を理解します。
目次
前のコードへ戻しても、保存済みの記事や画像は元の状態に戻りません。プログラムと、その外に保存したデータは別々だからです。この実習で、実際に違いを確かめます。
前の版へ戻す操作を「ロールバック」や「切り戻し」と呼びます。今回は教材のコードを v1 → v2 → v1 と切り替えます。EmDash本体のバージョンを下げる実習ではありません。
保存先の実習と秘密情報の実習が済んだ emdash-cloudflare-labs を使います。Node.js 24.22.1 / Wrangler 4.158.0、macOSで実行確認しました。WindowsはVS Codeのコマンド入力欄でコマンドプロンプトを使います。
1. 戻り先になるv1を公開して控える
src/release.js を開き、次の内容になっていることを確認します。
export const RELEASE = 'v1';wrangler.jsonc の検証用 DEMO_FAILURE は off に戻しておきます。教材フォルダーで公開します。
npx wrangler deploy --env staging出力の末尾にある Current Version ID の英数字を控えます。 これが今回の「v1のバージョンID」です。画面に出す v1 という短い文字と、Cloudflareが付ける長いIDは別です。
戻り先には、D1・R2の接続とsecretの登録が済んだ今の版を使います。最初に公開した、まだ保存先のない版は選びません。
ブラウザーで検証用URLの /status、/notes、/image を開き、次を確認します。
| 確認するもの | 更新前 |
|---|---|
/status の release | v1 |
/notes のメモ | 検証用のメモ |
/image | 緑色の IMAGE v1 |
2. コードとデータをv2へ変える
src/release.js 全体を次に変えて保存します。
export const RELEASE = 'v2';続いて、検証用のメモを書き換え、同じ名前の画像を差し替え、コードを公開します。
npx wrangler d1 execute DB --env staging --remote --file sql/update-staging.sql
npx wrangler r2 object put weekend-cf-lab-staging-media/sample.svg --env staging --remote --file fixtures/sample-v2.svg --content-type image/svg+xml
npx wrangler deploy --env staging最初の命令は、練習用の表にあるIDが1のメモだけを書き換えます。2つ目はR2の sample.svg を上書きします。この一連の実習で保存先の名前を変えた場合は、命令に含まれる名前も自分の設定に合わせてください。
同じ3つのURLを再読み込みします。
| 確認するもの | 更新後 |
|---|---|
/status の release | v2 |
/notes のメモ | v2で更新したメモ |
/image | オレンジ色の IMAGE v2 |
ここまで変わったことを見てから、切り戻しに進みます。
3. 控えたv1へ戻す
次の「控えたv1のバージョンID」を、手順1の長いIDに置き換えます。入力するのは v1 という文字ではなく、控えた長いIDです。
npx wrangler rollback 控えたv1のバージョンID --env staging --message "practice rollback"確認画面で、対象が weekend-cf-lab-staging と控えたIDであることを読んでから承認します。本番役の production-demo は操作しません。
IDを控え忘れた場合は、次で履歴を確認できます。
npx wrangler versions list --env staging日時や内容から戻り先を特定できない場合は、切り戻しを実行せず、手順1の作業記録を確認してください。この時点ではデータや画像もv2になっているため、手順1へ戻るだけでは初期状態になりません。
初めから練習し直す場合は、このページ末尾の片付けを済ませ、教材ZIPを新しいフォルダーへ展開して、最初のCloudflare実習から順に進めます。公式の切り戻しの説明(別タブで開く)には、戻せる版や接続先に関する制限も載っています。
4. 戻ったものと、残ったものを見る
切り戻しが成功したら、3つのURLをもう一度開きます。成功表示の直後に、まだ v2 が返ることも実行確認中にありました。少し待って再読み込みし、v1 へ変わったことを見届けます。命令の成功表示だけで、画面も戻ったと判断しないようにします。
| 確認するもの | 切り戻し後 | 理由 |
|---|---|---|
| コードの表示 | v1 | 選んだWorkerの版へ戻った |
| D1のメモ | v2で更新したメモ | D1のデータは巻き戻していない |
| R2の画像 | IMAGE v2 | R2のファイルは巻き戻していない |
これが今回、実際に確認する結果です。本番役の /notes は「本番役のメモ」、/image は画像なしのままであることも確認します。
教材はキャッシュを使わず、毎回保存先を読む設定です。実際のサイトではキャッシュもあるため、古い表示を見て「データが戻った」と判断しないようにします。
5. 手元のコードもv1へそろえる
Cloudflare上を戻しても、VS Codeで編集したファイルは自動では戻りません。src/release.js を v1 に戻して保存してください。
手元が v2 のまま deploy すると、再び v2 が公開されます。実際の開発では、Gitの履歴と公開中の版もそろえて管理します。変更履歴の残し方も参照してください。
戻した直後、secretの変更が10215で止まったら
切り戻し後の再検証では、secret put や secret delete に関する操作が、エラー 10215 で止まる状態も確認しました。Cloudflareへ最後にアップロードした版と、現在公開中の版が違うときの制限です。
この教材で秘密情報の実習をやり直す場合は、手元の src/release.js が v1、検証用の DEMO_FAILURE が off で、公開したい内容になっていることを確認します。そのうえで npx wrangler deploy --env staging で新しい版として公開し、secretの操作を再開します。
実サイトでは、エラーを消すために未確認のコードを公開しないでください。Cloudflareの10215の説明(別タブで開く)に沿って、今公開する版と秘密情報を更新する方法を選びます。
EmDashの更新で、同じことをする前に
EmDashの更新に失敗した場合は、Workerを戻すだけでは復旧できないことがあります。 更新時にデータベース内部の構造も変わると、古いコードでは新しいデータを読めない場合があるためです。
| 変えたもの | 戻す前に確かめること |
|---|---|
| テーマやプラグイン | 古いコードで、現在の記事を表示できるか |
| データベースの構造 | 古いEmDashが今の構造に対応するか |
| 記事・画像 | どの時点のデータを復元し、以後の更新をどう扱うか |
| 秘密情報・外部連携 | 戻り先の設定で、現在の鍵や接続先を使えるか |
今回確認したのは、データベースの表の構造や鍵を変えずに、Workerのコードを戻す操作です。表の構造や鍵を変更した場合の復旧は、この実習では確認していません。実サイトではバックアップと復旧と公開作業の順序を合わせて準備します。
実習が終わったら片付ける
次の命令は、今回作った練習用のデータを削除します。 他のサイトでも使っている保存先には実行しません。残したいメモがあれば、先に別の場所へ保存してください。命令の確認画面でも、削除対象の名前を読みます。
まず、起動中のローカルサーバーや tail を Control + C で止めます。次に、公開した教材のWorkerを消します。
npx wrangler delete --env staging
npx wrangler delete --env production-demo続けて、教材で入れたR2の画像を消してから、2つのバケットを消します。
npx wrangler r2 object delete weekend-cf-lab-staging-media/sample.svg --remote
npx wrangler r2 bucket delete weekend-cf-lab-staging-media
npx wrangler r2 bucket delete weekend-cf-lab-production-demo-media本番役のバケットにも自分で画像を入れた場合は、その画像も先に取り除く必要があります。最後にD1を消します。
npx wrangler d1 delete weekend-cf-lab-staging-db
npx wrangler d1 delete weekend-cf-lab-production-demo-dbWorkerを削除した後も、D1とR2は別に削除する必要があります。Cloudflareの一覧でも、今回の2つのWorker・2つのD1・2つのR2がなくなったことを確認します。
手元には教材フォルダー、.state のデータ、.dev.vars.staging の練習値が残ります。不要なら、VS Codeを閉じて教材フォルダーごと削除できます。もう一度最初から試す場合は、ZIPを新しいフォルダーへ展開し直してください。