Porta On Prem WSL 仮想ディスクの復元

このガイドでは、以前に作成したバックアップから Porta On Prem 用の WSL 仮想ディスクを復元する手順を説明します。

ノート

docker-desktop-data のデフォルトの保存場所は通常 %LOCALAPPDATA%\Docker\wsl\data です。

ヒント

これらの手順は、コンテナやボリュームなどのデータが保存される内部の docker ディストリビューション（「ディストロ」）に関するものです。別の仮想ドライブ上にある Ubuntu ディストロには影響しません。

1. バックアップが存在することを確認する

1. バックアップの保存場所に、最新の .tar ファイルが存在することを確認します。
   • デフォルトでは、バックアップ手順 に従っている場合、これはおそらく D:\wsl\backups\docker-desktop-data.tar です。
2. 最新のバックアップがない場合は、バックアップ手順 を実行して作成してから、このステップに戻ってください。
3. 最新のバックアップがある場合は、次のセクションに進みます。

2. ターゲットドライブが NTFS でフォーマットされていることを確認する

注意

WSL が使用する仮想ディスクには、ホストドライブが NTFS でフォーマットされている必要があります。

対象のドライブが exFAT、FAT32、ReFS、またはネットワーク共有としてフォーマットされている場合、復元は失敗します。

1. エクスプローラーで This PC に移動します。
2. 復元先のドライブを右クリックし、コンテキストメニューから properties を選択します。
3. 開いたウィンドウで File system プロパティを確認します。

3. 既存の仮想ディスクの場所を確認する

1. エクスプローラーで %LOCALAPPDATA%\Docker\wsl\data に移動し、ext4.vhdx という名前の既存の仮想ディスクファイルを見つけます。
2. Docker Desktop の Settings > Resources > Advanced で Disk image location を確認することもできます。
3. 後でコピーして使用できるよう、このパスをメモします。

4. Docker Desktop をシャットダウンする

1. システムトレイを使用して Docker Desktop を終了します。
2. PowerShell を開きます。
3. wsl --shutdown を実行して、すべてのディストリビューションを停止します。
4. wsl -l -v を実行し、docker ディストリビューションが停止していることを確認します。成功した出力は次のようになります。

   NAME                   STATE           VERSION
   * Ubuntu-22.04         Stopped         2
   docker-desktop-data    Stopped         2
   docker-desktop         Stopped         2

5. 既存の docker-desktop-data ディストリビューションを登録解除（削除）する

警告

バックアップなしで以下の手順を実行すると、このマシン上のすべての Porta データとファイルが永久に失われます。

1. PowerShell を 管理者として 開きます。

2. 次を実行して、docker-desktop-data が存在し停止していることを確認します。

   wsl -l -v

   成功した出力は次のようになります。

   NAME                   STATE           VERSION
   * Ubuntu-22.04         Stopped         2
   docker-desktop-data    Stopped         2
   docker-desktop         Stopped         2

3. PowerShell で次のコマンドを実行して、docker-desktop-data ディストリビューションを登録解除（削除）します。

   wsl --unregister docker-desktop-data

4. 確認メッセージは表示されませんが、wsl -l -v を再度実行して削除されたことを確認できます。

   • 出力に docker-desktop-data がもう一覧表示されないはずです。

   NAME                   STATE           VERSION
   * Ubuntu-22.04         Stopped         2
   docker-desktop         Stopped         2

5. Windows エクスプローラーでディスクの場所（おそらく %LOCALAPPDATA%\Docker\wsl\data）を確認し、ext4.vhdx ファイルが削除されたことを確認することもできます。

6. 仮想ディスクを復元する

1. データを復元するフォルダがすでに存在することを確認します（例: %LOCALAPPDATA%\Docker\wsl\data または D:\wsl\docker-desktop-data）。

2. バックアップ .tar ファイルからデータをインポートして、docker-desktop-data ディストリビューションを復元します。

   1. PowerShell を開きます。
   2. 次のコマンドを実行してバックアップをインポートします。
      • D:\path\to\backup をバックアップファイルへのパスに置き換えてください。
      • D:\path\to\restore\folder を復元先ディレクトリへのパスに置き換えてください。

      wsl --import docker-desktop-data "D:\path\to\restore\folder" "D:\path\to\backup\docker-desktop-data.tar" --version 2

   3. 次の行に PS C:\Users\username> プロンプトが再び表示されたら、インポートは完了です。

   ノート

   インポートは、仮想ディスクのサイズに応じて最大 15 分かかることがあります。

3. インポートが完了したら、PowerShell を開いて次を実行し、ディストリビューションが WSL で認識されていることを確認します。

   wsl -l -v

   成功した出力は次のようになります。

   NAME                   STATE           VERSION
   * Ubuntu-22.04         Stopped         2
   docker-desktop-data    Stopped         2
   docker-desktop         Stopped         2

4. Docker Desktop を再度起動します。新しくインポートされた docker-desktop-data ディストリビューションを見つけて使用するはずです。

5. Docker の起動後、PowerShell で docker images または docker volume ls コマンドをすばやく実行し、イメージ/ボリュームがまだ存在することを確認します。

6. これで、すべて正常に戻っているはずです。