Docker-Umgebung
Die POSIM-Images enthalten Ubuntu, ROS 2 Lyrical, Gazebo Jetty, POSIM, ArduSub, ArduRover, MAVROS und QGroundControl. Wählen Sie zunächst die Anleitung für Ihre Umgebung, um Anzeige und Grafiktreiber einzurichten.
Ein veröffentlichtes Image herunterladen
Die Images liegen auf Docker Hub. Docker wählt automatisch die passende Variante für AMD64 oder ARM64.
docker pull ioeslab/posim:latest
export POSIM_IMAGE=ioeslab/posim:latest
| Tag | Verwendung |
|---|---|
latest |
Veröffentlichter Build des Hauptzweigs für beide Architekturen |
sha-<12-character-commit> |
Bestimmter Quellstand; übernehmen Sie einen vorhandenen Tag von Docker Hub |
SHA-Tag mit -amd64 oder -arm64 |
Ausdrückliche Auswahl einer Architektur |
| Veröffentlichte Versionsnummer | Ein mit einem Release-Tag gekennzeichneter Stand |
Das Image-Label enthält die vollständige Quellrevision. Halten Sie zusätzlich den Digest fest, wenn ein Versuch genau dasselbe Image verwenden soll.
docker image inspect "$POSIM_IMAGE" \
--format '{{index .Config.Labels "org.opencontainers.image.revision"}}'
docker image inspect "$POSIM_IMAGE" --format '{{json .RepoDigests}}'
Verwenden Sie die Dokumentation zum gewählten Stand. Ein neu heruntergeladenes Image verändert vorhandene Container nicht.
Ein Image aus dem Quellcode bauen
Führen Sie diese Befehle auf dem Host aus:
git clone https://github.com/IOES-Lab/POSIM.git
cd POSIM
git rev-parse HEAD
Für AMD64:
docker build --platform linux/amd64 \
-f .docker/lyrical.amd64.dockerfile -t posim:dev-amd64 .
Für ARM64:
docker build --platform linux/arm64 \
-f .docker/lyrical.arm64v8.dockerfile -t posim:dev-arm64-rdp .
Ersetzen Sie in der Installationsanleitung ioeslab/posim:latest durch den lokalen Tag. Beide Images bauen den vorhandenen Quellcode und die festgelegte Version der Wellenbibliothek. ARM64 enthält außerdem einen XFCE-Desktop und einen RDP-Server.
Die Umgebung öffnen
- Linux mit Docker: Anzeige auf dem Linux-Desktop.
- Windows mit WSL und Docker: Linux-Fenster über WSLg.
- macOS mit Docker und RDP: Verbindung zum Linux-Desktop im Container.
Alle drei Anleitungen erstellen einen Container namens posim. Unter Terminals vorbereiten erfahren Sie, wo Sie Befehle eingeben und den Arbeitsbereich laden.
Eigene Dateien aufbewahren
Der Arbeitsbereich liegt bei AMD64 unter /opt/posim_ws und bei ARM64 unter /home/docker/posim_ws. Die Variablen POSIM_WS oder POSIM_UNDERLAY geben diesen Pfad an.
Speichern Sie eigene SDF-Dateien und Aufzeichnungen in /work. Dieses Verzeichnis gehört zum Volume posim-data. Andere Dateien bleiben nach einem Stopp erhalten, werden aber zusammen mit dem Container gelöscht. Sichern Sie Quellcodeänderungen in Git oder kopieren Sie sie vor dem Austausch nach außen. Das Volume bleibt bestehen, bis es ausdrücklich entfernt wird.
Stoppen, fortsetzen und aktualisieren
Beenden Sie zuerst die Simulation mit Strg+C. Führen Sie anschließend auf dem Host aus:
docker stop posim
docker start posim
Für ein Update sichern Sie Ihre Arbeit, stoppen den Container, laden das gewünschte Image herunter und entfernen den gestoppten Container. Erstellen Sie ihn mit dem Befehl aus Ihrer Installationsanleitung erneut und verwenden Sie dabei wieder posim-data.
Grafik und GPU
Unter Linux benötigen Sie den Host-Treiber und das NVIDIA Container Toolkit. Unter Windows gilt die GPU-Konfiguration für Docker Desktop mit WSL2. CUDA-Sonar benötigt außerdem Bibliotheken im Image; siehe Sonar konfigurieren. Die ersten Schritte verwenden Software-Rendering, das langsamer sein kann.