Windows: WSL e Docker
Docker Desktop esegue POSIM e WSLg mostra Gazebo sul desktop di Windows. Esegui i comandi Docker di questa pagina nel terminale Ubuntu all'interno di WSL.
1. Preparare WSL e la grafica
Completa i primi due passaggi dell'installazione su Windows: installa Ubuntu 26.04 in WSL2, quindi aggiorna WSL e il driver grafico di Windows. Vale anche per le schede NVIDIA. Non installare un driver video Linux all'interno di WSL.
Installa Docker Desktop con WSL2 e attiva Settings → Resources → WSL Integration → Ubuntu-26.04. Usa il suo motore Docker; non serve un secondo motore in Ubuntu.
Verifica il server e il socket grafico:
docker version --format '{{.Server.Version}}'
test -S /mnt/wslg/.X11-unix/X0
printf '%s\n' "$DISPLAY"
Se il socket non esiste, completa la configurazione di WSLg.
2. Scaricare POSIM
docker pull ioeslab/posim:latest
La pagina Ambiente Docker descrive versioni e compilazione delle immagini. Questa configurazione usa il rendering software. Per una GPU NVIDIA supportata, consulta i requisiti di accesso alla GPU.
3. Creare il container
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'
Salva i tuoi file in /work, nel volume posim-data. Puoi arrestare il container con docker stop posim e riavviarlo con docker start posim.
Per gli esempi successivi, apri due terminali Ubuntu e collegali allo stesso container. Le finestre di Gazebo compaiono direttamente sul desktop di Windows.
4. Avviare il mondo dimostrativo
Entra nel container:
docker exec -it posim bash
Verifica l'installazione:
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 dovrebbe mostrare l'oceano. Lascia aperto il terminale; Ctrl+C arresta la simulazione. Prosegui con il primo robot.
Esegui la versione Linux di QGC nello stesso contenitore POSIM. Non aprire QGC sull’host Windows né in WSL fuori dal contenitore. Segui la configurazione di QGC.