新しいバージョンが出たら、今すぐ更新する?
版番号の違いと更新内容を確認し、自分のサイトに必要な対応を判断します。
目次
新しい版が出るたびに、すぐ本番を更新する必要はありません。 まず変更内容を確認します。自分のサイトに関係する安全性の修正なら、検証と更新を早めます。使っていない機能の追加なら、必要性を見て更新時期を決められます。
ここでは更新するかを判断するところまで進めます。実際にファイルを変更する作業は、アップデート手順で扱います。
まず、自分が使っている版を知る
この確認は、サイトのファイルを管理している人が行います。記事の執筆だけを担当している場合は、制作担当者に「現在公開しているEmDashの版」を聞いて、次の節へ進んで構いません。
自分で確認する場合は、npmで準備したプロジェクトがパソコンにあることが前提です。npmは必要なプログラムを揃える道具です。操作がわからない場合は、先にパソコンの準備を確認します。
- VS Codeなどのコードエディターで、サイトのプロジェクトフォルダーを開く。
- ファイル一覧に
package.jsonがあることを確認する。使う部品を記録しているファイルです。 - VS Codeなら、ターミナル → 新しいターミナルを開く。Windowsではコマンドプロンプトを選ぶ。入力画面の開き方
- 次の1行を貼り付け、Enterキーを押す。
npm ls emdash @emdash-cms/cloudflareこれは、インストール済みの版を確認する命令です。たとえばemdash@1.4.0と表示されたら、1.4.0が版番号です。このemdash@1.4.0は表示される結果の例です。コマンド入力欄へ貼り付けるのは、上のnpm lsで始まる行だけです。Node.js構成では、Cloudflare用パッケージが入っていないこともあります。
npmが見つからない、または一覧にemdashが出ない場合は、道具の準備や開いたフォルダーを確認します。結果がわからないまま、更新コマンドへ進む必要はありません。
手元と公開先で別の版が動いている場合があります。公開先の版は、最後に配置したコードとそのときの記録でも確認しましょう。
3つの数字には、変更の目安がある
公式は、版番号にセマンティックバージョニングという規則を使っています。たとえば1.4.0は、左からメジャー・マイナー・パッチです。
| 架空の変更例 | 呼び方 | 読むときの目安 |
|---|---|---|
| 1.4.0 → 1.4.1 | パッチ更新 | 互換性を保つ修正や小さな改善 |
| 1.4.0 → 1.5.0 | マイナー更新 | 互換性を保つ機能追加 |
| 1.4.0 → 2.0.0 | メジャー更新 | 既存のサイトに修正が必要な場合がある |
この数字は説明用です。実在する最新版の案内ではありません。また、数字だけで自分のサイトの確認を省略せず、公式の更新説明(別タブで開く)とリリース情報を読みます。
自分に関係する変更を、3つに分ける
先ほどの表の「互換性を保つ」は、これまでの使い方を続けられることを目指した変更という意味です。自分のテーマや追加機能も問題なく動くかは、更新後に確認します。
安全性に関する修正があるなら、対象となる版や機能、公式が示す対応を優先して確認します。関係がある場合は、検証と更新の予定を早めます。
今困っている不具合の修正なら、その不具合を再現できる練習用データを用意します。更新前後で同じ操作を比べると、直ったか判断できます。
使っていない機能の追加なら、今すぐ使う必要があるかを考えられます。更新を先に延ばす場合も、次に確認する日を決めておきましょう。
更新すると決める前に、戻れる状態を用意する
確認用のサイトで試せるか、更新後に何を確かめるか、データを変更する場合の復旧方法があるかを整理します。公開中の記事が増え続けているサイトでは、更新や復旧中の編集を誰が止めるかも決めます。
公式の更新ツールは、サイトを構成するプログラムの部品(パッケージ)を更新します。サイト独自のテーマや設定は、制作担当者が必要な修正を確認して反映します。また、データベースの変更が入る場合は、以前のコードだけ戻しても元通りになるとは限りません。
判断を1行残す
「変更内容を確認し、使っている機能への修正があるので、確認用サイトで試してから更新する」。この程度で十分です。版番号、判断した日、次の作業も添えます。
次は変更内容の読み方で、英語のリリース情報から必要な対応を拾ってみましょう。