Windows:WSLとDocker
Docker Desktop で POSIM を動かし、WSLg を通じて Windows デスクトップに Gazebo を表示します。このページの Docker コマンドは、すべて WSL 内の Ubuntu ターミナルで実行してください。
1. WSL とグラフィックスを準備する
Windows へのインストールの手順 1、2 に従い、WSL2 に Ubuntu 26.04 をインストールして、WSL と Windows 側のグラフィックスドライバーを更新します。NVIDIA 製 GPU も同様です。WSL 内に Linux 用ディスプレイドライバーをインストールしないでください。
WSL2 バックエンドの Docker Desktop をインストールし、Settings → Resources → WSL Integration → Ubuntu-26.04 を有効にします。Docker Desktop のエンジンを使用するため、Ubuntu 内に別の Docker Engine は不要です。
サーバーと画面表示用ソケットを確認します。
docker version --format '{{.Server.Version}}'
test -S /mnt/wslg/.X11-unix/X0
printf '%s\n' "$DISPLAY"
ソケットが存在しない場合は、先に WSLg の設定を完了してください。
2. POSIM をダウンロードする
docker pull ioeslab/posim:latest
タグとソースからのビルドは Docker 環境で説明しています。以下の設定はソフトウェアレンダリングを使用します。対応する NVIDIA GPU を使う場合は、GPU 利用の前提条件も確認してください。
3. コンテナを作成する
docker run -d --name posim --init --shm-size=1g \
-e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
--mount type=bind,source=/mnt/wslg/.X11-unix,target=/tmp/.X11-unix,readonly \
--mount type=volume,source=posim-data,target=/work \
--entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'
自分のファイルは posim-data ボリュームに対応する /work に保存します。docker stop posim で停止し、docker start posim で再開できます。
続く例では Ubuntu ターミナルを 2 つ開き、両方を同じコンテナに接続します。Gazebo は Windows のウィンドウとして表示されます。
4. デモワールドを起動する
コンテナに入ります。
docker exec -it posim bash
次のコマンドでインストール結果を確認します。
source /opt/ros/lyrical/setup.bash
source /opt/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
world_name:=posim_ocean_waves headless:=false
Gazebo に海のワールドが表示されれば準備完了です。実行中はターミナルを開いたままにし、停止するには Ctrl+C を押します。次は最初のロボットを動かします。
同じPOSIMコンテナー内でLinux版QGCを実行してください。Windowsホストや、コンテナー外のWSLではQGCを起動しないでください。QGCの設定に従ってください。