4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

たまーにやり直すことになるので、Windows版 Docker Desktop(WSL 2)の環境構築をまとめた

4
Posted at

image.png

Windowsでの Docker 環境は、一度構築してしまえば安定して使えます。ですが、PCの入れ替え・OS再インストールなどのタイミングで再インストールする必要があります。

そのたびに公式ドキュメントを辿り直すのは少し手間なので、Windowsで Docker Desktop を使えるようにするまでの手順を整理しました。

Docker公式が推奨している WSL 2 バックエンド + Docker Desktop 構成を前提に、
PowerShell(管理者) で進める手順をまとめます。


全体像

  1. 前提確認
  2. 仮想化(Virtualization)が有効か確認
  3. WSL 2 のインストール
  4. WSL 2 を既定に設定・Ubuntu 準備
  5. Docker Desktop のインストールと動作確認

以降、この流れに沿って説明します。


STEP 1:前提確認

Windows 11 または WSL 2 が利用可能な Windows 10


STEP 2:仮想化(Virtualization)が有効か確認

  1. タスクマネージャー を起動
  2. パフォーマンス タブ → CPU
  3. 右下に 「仮想化:有効」 と表示されているか確認

image.png

無効だった場合

BIOS / UEFI 設定で以下を有効にします。

  • Intel CPU:Intel VT-x
  • AMD CPU:AMD-V

BIOS画面はメーカーごとに異なるため、
BIOS virtualization enable + 機種名 で検索するのが確実です。


STEP 3:WSL 2 をインストール(PowerShell 管理者)

PowerShellを「管理者として実行」 し、次を実行します。

wsl --install

実行後、指示が出たら Windowsを再起動します。

このコマンドで、

  • WSL 本体
  • 既定の Linux ディストリビューション(Ubuntu)
  • WSL 2 用設定

がまとめてインストールされます。


STEP 4:WSL を最新化し、WSL 2 を既定にする

再起動後、PowerShell で以下を実行します。

wsl --update
wsl --set-default-version 2
wsl -l -v

確認ポイント

  • wsl -l -v の出力で
    Ubuntu などが Version 2 になっていればOK

もし Version 1 のままの場合は、次で変換できます。

wsl --set-version Ubuntu 2

Ubuntu が入っていない場合

wsl --install -d Ubuntu

初回起動時に、

  • Linux用ユーザー名
  • Linux用パスワード

を求められます。
※ Windows のユーザーとは なので新たに設定してください。


STEP 5:Docker Desktop をインストール

  1. Docker公式ページへアクセス

Install Docker Desktop on Windows

  1. Docker Desktop for Windows をダウンロードして実行
  2. インストール途中で
    「WSL 2 を有効化する」選択肢が出たら有効(推奨)
  3. インストール完了後、Docker Desktop を起動

動作確認

PowerShell または WSL(Ubuntu)で次を実行します。

docker version
docker ps

エラーが出なければ、Docker 環境は正常に動作しています。


注意:Docker Desktop のライセンス

Docker公式では、企業規模によっては Docker Desktop の商用利用が有料(サブスクリプション)対象になる点が明記されています。

image.png


参考リンク

  • Docker Desktop for Windows

  • Docker Desktop WSL 2 backend

  • Docker Desktop Troubleshoot

  • Install WSL (Microsoft)

4
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?