Dockerman Docs
プラットフォーム

Windows

Docker Desktop または内蔵 WSL2 Docker Engine で、Windows 上の Dockerman を動かす。

Windows で使える Docker パスは 2 つです。Docker Desktop か、内蔵 WSL2 Docker Engine です。

クイック比較

項目Docker DesktopWSL2 Docker Engine
サブスクリプションほとんどの企業で必要不要
フットプリントインストールサイズが大きい小さなAlpineベースのWSLディストリビューション
リソース使用量VMとサービスを実行するため高いWSL2内で実行されるため低い
セットアップ作業標準インストーラーDockermanが自動化
サポート完全サポート完全サポート、v4.3.0 で追加されました

オプションA:Docker Desktop

Docker Desktopをインストール

docker.comからDocker Desktopをダウンロードし、インストーラーを実行してください。

Docker Desktopが実行中であることを確認

クジラアイコンが表示され、Docker Desktopが実行中であることを確認してください。

Dockermanを起動

DockermanはDocker Desktopを自動検出し、接続します。

オプションB:WSL2 Docker Engine

v4.3.0 で追加されました。

Dockerman は WSL2 パスを同梱しているので、Docker Desktop や手動の WSL セットアップは不要です。

前提条件

  • Windows 10 バージョン2004以降、またはWindows 11
  • 管理者権限のPowerShellセッションからwsl --installでインストールされたWSL2
  • BIOSまたはUEFIで仮想化が有効になっていること

セットアップウィザード

セットアップウィザードは、Docker Desktopが検出されない場合、初回起動時に自動的に実行されます。

WSL2 Docker Engineを選択

ウェルカムダイアログが表示されたら、内蔵WSL2 Docker Engineパスを選択してください。

Alpineをインポート

DockermanはDocker Engine用の最小限のAlpine WSLディストリビューションをインポートします。

Alpine内にDockerをインストール

DockermanはDockerをインストールし、ログイン時にデーモンが起動するように設定します。

接続を確認

Dockermanはヘルスチェックを実行し、新しいデーモンに接続します。

ウィザードの実行中はDockermanを閉じないでください。初回セットアップには数分かかり、アプリが使用可能になる前に完了する必要があります。

ウィザードの処理内容

ウィザードは、Dockerman が Docker を動かすために使う Alpine ディストリビューションのファイルを作ります。

/etc/docker/daemon.json

daemon.jsonの編集

設定 → Daemon 設定パネルで /etc/docker/daemon.json を編集してください。よく使うフィールドはフォーム、それ以外は raw JSON ビューです。保存すると Alpine ディストリビューション内の Docker が再起動します。

デーモンクラッシュからの復旧

Dockerデーモンがクラッシュした場合、Dockermanは再起動ボタン付きのバナーを表示し、クラッシュログをストリーミングして障害を診断できるようにします。

WSL2 ディストロの再インストール

v5.3.0 で追加。Alpine ディストロが不安定な状態になった場合は、WSL ページからセットアップウィザードを開き、Reinstall をクリックして既存の dockerman-backend ディストロを登録解除し、新しい Alpine イメージを再インポートできます。

再インストールでは、Docker イメージ、コンテナ、ボリューム、その他ディストロ内のすべてのデータが削除されます。続行前に必要なデータをエクスポートまたはバックアップしてください。Dockerman はこの操作でボリュームを保持しません。

エンジンソースの切り替え

v5.3.0 で追加。Windows の WSL ページには Engine source セレクタがあり、OS ネイティブの Docker ソケット(Docker Desktop または OS にインストールされた任意の Docker)と、同梱の Dockerman WSL2 Docker Engine の 2 枚のカードが表示されます。カードを選択すると、トーストや手動保存なしに、ローカルホストを新しいソースへ再接続します。以前の Docker 接続タイプ(socket、tcp、npipe)は記憶されているため、OS ネイティブ Docker に戻すと前回の設定が復元されます。

旧来のフローを使いたい場合は、設定 → Docker 設定 から接続タイプを切り替えて手動で再接続することもできます。

WSL2のリソース監視

Stats で、WSL2 Engine を他の Docker デーモンと同じように監視してください。Windows のメモリ使用量が多く見えるときは、タスクマネージャーで WSL2 VM のバルーニングを確認してください。

トラブルシューティング