はじめに

本記事では、CodeX CLI を WSL 上の Ubuntu で利用し、Podman を用いてコンテナ動作検証を行う環境の構築手順をまとめます。

前提条件

Windows 11 + WSL2 環境が利用可能であること
WSL 側のディストリビューションは Ubuntu 22.04 以降 を推奨
CodeX CLI サンドボックスは full-access モード で起動すること
- restricted モードでは Podman が利用できないため注意

Ubuntu 環境に Podman をインストールします。

sudo apt update
sudo apt install -y podman uidmap crun runc podman-compose

rootless Podman 用にユーザ ID マッピングを設定します。

sudo sh -c "echo $USER:100000:65536 >> /etc/subuid"
sudo sh -c "echo $USER:100000:65536 >> /etc/subgid"

確認:

cat /etc/subuid /etc/subgid

/etc/wsl.conf を編集:

[boot]
systemd=true

[user]
default=devuser

WSL を再起動:

wsl --shutdown
wsl -d Ubuntu-22.04

ユーザ systemd を有効化:

sudo loginctl enable-linger $USER

ユーザサービスとして Podman ソケットを起動します。

systemctl --user enable --now podman.socket

Podman が正しく動作するか確認します。

podman --version
podman info
podman run --rm -it alpine echo "hello from podman"

CodeX CLI の Docker/Podman 連携テストを実行します。

make test-docker-unit
make test-docker-all