😃

WSLでDockerの環境構築しようとしたらハマるポイント3選

に公開

はじめに

WSLでDockerの環境構築しようとしたらハマるポイントをまとめました。どんなエラー文が出て、どうやって問題を切り分けて解決するかも記載したので、これからWSLでDockerの環境構築しようとする方は必読です。

tl;dv

クソでかい問題としてRancher DesktopのkubeconfigとWSLのdockerのとで競合していた。(自分の場合)

環境

  • Windows 11
  • WSL2 上の Ubuntu 24.04
  • Rancher Desktop
    コンテナエンジンは dockerd (moby) を利用

その1:パーミッションの問題

ワイ「なんやこのエラー」

ワイ「/var/run/docker.sockにパーミッションの問題でアクセスできてない、、、?」

docker compose up -d

unable to get image 'postgres:15.0-alpine': permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.51/images/postgres:15.0-alpine/json": dial unix /var/run/docker.sock: connect: permission denied

ワイ「ほんまや、/var/run/docker.sockはrootかdockerグループのユーザしかアクセスできないよ設定になっとる」

ls -l /var/run/docker.sock
id
srw-rw---- 1 root docker 0 Nov 25 19:51 /var/run/docker.sock
uid=1000(ninkanman) gid=1000(ninkanman) groups=1000(ninkanman),4(adm),...,107(netdev)

ワイ「こんなんdockerのグループを作ってあげて、、、」

sudo groupadd docker 2>/dev/null || true

ワイ 「自分を docker グループに追加すれば終わりや!」

sudo usermod -aG docker $USER

その2:kubeconfigそのものの競合

ワイ「権限周り直してあげたらそもそもアクセスできないって出てきたで」

ワイ「しかもRauncher Desktop側に変なエラーでとる」

docker ps

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

さらに Rancher Desktop 側の UI では、WSL Integration の画面に次のようなエラーが表示されていた。

Error managing distribution Ubuntu-24.04: kubeconfig: C:\WINDOWS\system32\wsl.exe exited with code 1

Rancher Desktop cannot automatically convert the provided kubeconfig file to a symlink due to existing configurations within that file. To resolve this issue, you will need to manually create the symlink to ensure existing configurations are preserved and to prevent any loss of configuration.

Rauncher Desktop「Rancher Desktop は、提供された kubeconfig ファイル内に既存の設定が含まれているため、シンボリックリンクへの自動変換ができません。この問題を解決するには、既存の設定が保持され、設定の損失を防ぐために、シンボリックリンクを手動で作成する必要があります。」

ワイ「既存のkubeconfigと競合してる?なんやねんそれ」

ワイ「WSLのUbuntuのdocker.serviceとRauncher DesktopのDockerでごちゃごちゃになってるんかな」

ワイ「WSL内で docker.service の状態を確認するか」

sudo systemctl status docker
× docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
    Drop-In: /etc/systemd/system/docker.service.d
             └─http-proxy.conf
     Active: failed (Result: exit-code) ...
...
Failed to start docker.service - Docker Application Container Engine.

WSL の Ubuntu にも Docker Engine を入れていたため、systemd 管理の docker.service が存在していたが、これは失敗している。
一方で、実際に使いたいのは Rancher Desktop 側の dockerdなので、WSL 内の docker.serviceを以下のように無効化した。

ワイ「これで完璧や!」

sudo systemctl disable --now docker.service docker.socket

ワイ「よし、Rauncher Desktopを再起動して確認するで〜」

ワイ「あかんやん」

Error managing distribution Ubuntu-24.04: kubeconfig: C:\WINDOWS\system32\wsl.exe exited with code 1

Rancher Desktop cannot automatically convert the provided kubeconfig file to a symlink due to existing configurations within that file. To resolve this issue, you will need to manually create the symlink to ensure existing configurations are preserved and to prevent any loss of configuration.

このあたりの設定を揃えても、まだ WSL側からはdockerに繋がらない状態だった。

その3:kubeconfigを作り直させる!

エラーメッセージを見ると、Rancher DesktopがWSL連携の中でkubeconfigをsymlinkに変換しようとして、既存設定が邪魔して失敗していることがわかる。
つまりUbuntu側のkubeconfigに何かしらの既存設定が入っていて、それをどう扱うか判断できず変換処理が止まっている構図になっている。

ワイ「なるほど…既存のkubeconfigがあるせいでRancher Desktopがシンボリックリンクにできずにコケとるんやな」
ワイ「ほなkubeconfigをいったん退避して、Rancher Desktopに作り直させればええやろ」

そこで、WSL の kubeconfig をいったん退避して空にした。

まず kubeconfig避難所を用意する。

mkdir -p ~/.kube

ワイ「念のためバックアップ取っとこ。戻せんと詰むしな」

if [ -f ~/.kube/config ]; then
  cp ~/.kube/config ~/.kube/config.bak-$(date +%Y%m%d-%H%M)
fi

if [ -f ~/.kube/.config ]; then
  cp ~/.kube/.config ~/.kube/dot-config.bak-$(date +%Y%m%d-%H%M)
fi

ワイ「よし、いったんまっさらにするで」

rm -f ~/.kube/config ~/.kube/.config

その後、WSL を完全に落としてから Rancher Desktop を再起動する。
WSL ではなく PowerShell で以下を実行。

wsl --shutdown

Rancher Desktop を一度 Quit

Rancher Desktop を起動

その後 WSL (Ubuntu) を起動

ワイ「さて、これで WSL 側から docker が繋がるようになったか確認や。docker ps 叩くで」

docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

ワイ「空でもええ。エラーが出てないのが大事や」

結論

docker.serviceとRancher Desktopが競合する環境をまず作るなというハナシ。
知らぬ間に競合する環境を作る可能性がある人はご参考までに!

Discussion