正確に切り替え、ロールバックする

切り替え前後の状態を両方用意する

対応する web Profile の運用では、直接追加した @dsh-themes/* パッケージを 1 つだけ有効にします。切り替え時は、対象パッケージを追加する前に以前のパッケージを削除するため、最初の変更を行う前に復旧手段を用意する必要があります。

1. 01

   現在の状態を確認して特定する

   web Profile から、直接追加されたパッケージ名と正確なバージョンを読み取ります。依存関係が曖昧な場合や、バージョン範囲が使われている場合は中止します。

2. 02

   対象成果物を確認する

   成果物全体の SHA-256、manifest ID、正確な互換性、slug、version と一致する、管理されたダウンロードを確認します。

3. 03

   以前の成果物を確認する

   正確な以前の .tgz と digest を用意します。以前の状態が @dsh-themes/* パッケージを使わない組み込み palette なら、その事実を記録します。

4. 04

   ロールバック記録を作る

   以前の ID と対象 ID、検証済み成果物の絶対パス、成果物全体の digest を記録します。Profile の内容や認証情報は含めません。

5. 05

   変更内容を最終確認する

   何かを削除する前に、現在の状態、切り替え対象、互換性、用意したロールバック情報を確認します。

node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs plugin --profile web remove @dsh-themes/current-theme
node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs plugin --profile web add /absolute/path/to/verified-target.tgz --save-exact
node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs plugin --profile web list --json
node /absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs --profile web --dump-config

記録と現在の状態が一致するときだけロールバックする

1. 01

   記録を検証する

   Profile を変更する前に、不正、不完全、移動済み、不一致の成果物参照を拒否します。

2. 02

   現在の対象がまだ一致するか確認する

   切り替え後に別の変更が加えられた Profile へ、古いロールバック記録を適用してはいけません。

3. 03

   以前の成果物を再検証する

   インストールの直前に、成果物全体のバイト列を再確認します。payload hash で代用してはいけません。

4. 04

   対象を削除し、以前の正確な状態を復元する

   以前の正確なパッケージをインストールします。組み込み palette へ戻す場合は、@dsh-themes/* パッケージを残しません。

5. 05

   再起動して検証する

   想定する直接依存関係が 1 つだけであることを確認し、出力した構成を調べ、DSH を再起動して、実際のランタイム ID を検証します。