Porta On Prem WSL データの新しい場所への移行

このガイドでは、Porta On Prem 用の WSL 仮想ディスクをシステム上の新しい場所へ移行する手順を説明します。

ノート

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

ヒント

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

1. 仮想ディスクをバックアップする

まず、問題が発生した場合に備えて復元ポイントを確保するため、データベースのバックアップを作成します。

1. システムトレイを使用して Docker Desktop をシャットダウンします。
2. Docker のシャットダウンが完了したら、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 ディストリビューションを .tar ファイルにエクスポートします。

   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 ディストリビューションを .tar ファイルにエクスポートします。

      • コマンド内で、D:\path\to\backup を希望のバックアップディレクトリに置き換えてください。
        • このディレクトリはエクスポート前にすでに存在している必要があります。必要に応じて新しいディレクトリを作成してください。
      • エクスポート先に十分な空きディスク容量があることを確認してください。
      • 仮想ディスクが大きい場合、エクスポートには時間がかかることがあります（5〜15 分程度）。

      • wsl --export docker-desktop-data D:\path\to\backup\docker-desktop-data.tar

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

6. バックアップファイルが正常に作成されたことを確認します。
   1. ステップ 2 で指定したバックアップディレクトリに移動します。
   2. docker-desktop-data.tar ファイルが存在することを確認します。
   3. ファイルサイズが 0 バイトより大きいことを確認します。

ヒント

作成されたバックアップファイルの名前を控えておいてください。次のステップで必要になります。

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. これで、すべて正常に戻っているはずです。