Docker环境
POSIM 镜像包含 Ubuntu、ROS 2 Lyrical、Gazebo Jetty、POSIM、ArduSub、ArduRover、MAVROS 和 QGroundControl。请先在选择运行环境中找到对应的安装指南,再配置显示和驱动程序。
下载已发布的镜像
镜像发布在 Docker Hub。Docker 会根据 CPU 自动选择 AMD64 或 ARM64 版本。
docker pull ioeslab/posim:latest
export POSIM_IMAGE=ioeslab/posim:latest
| 标签 | 用途 |
|---|---|
latest |
主分支已发布的构建,包含 AMD64 和 ARM64 版本 |
sha-<12-character-commit> |
指定源码提交;请复制 Docker Hub 上实际存在的标签 |
SHA 标签后缀 -amd64 或 -arm64 |
明确指定架构 |
| 已发布的版本号 | 对应项目发布标签的版本 |
镜像标签记录了完整的源码提交号。若要使用完全相同的镜像复现实验,还应保存镜像摘要。
docker image inspect "$POSIM_IMAGE" \
--format '{{index .Config.Labels "org.opencontainers.image.revision"}}'
docker image inspect "$POSIM_IMAGE" --format '{{json .RepoDigests}}'
请使用与源码版本对应的文档。下载新镜像不会自动更新已有容器。
从源码构建
在宿主机上执行:
git clone https://github.com/IOES-Lab/POSIM.git
cd POSIM
git rev-parse HEAD
构建 AMD64 镜像:
docker build --platform linux/amd64 \
-f .docker/lyrical.amd64.dockerfile -t posim:dev-amd64 .
构建 ARM64 镜像:
docker build --platform linux/arm64 \
-f .docker/lyrical.arm64v8.dockerfile -t posim:dev-arm64-rdp .
在对应的安装指南中,用本地标签替换 ioeslab/posim:latest。两种镜像都会编译当前源码和固定版本的波浪库。ARM64 镜像还包含 XFCE 桌面和 RDP 服务。
按操作系统启动
- Linux 与 Docker:使用 Linux 桌面的显示连接。
- Windows、WSL 与 Docker:通过 WSLg 显示 Linux 窗口。
- macOS、Docker 与 RDP:连接容器内的 Linux 桌面。
这些指南都会创建名为 posim 的容器。准备终端说明了在哪里输入命令以及如何加载工作空间。
保存自己的文件
AMD64 镜像的工作空间位于 /opt/posim_ws,ARM64 镜像则位于 /home/docker/posim_ws。可通过 POSIM_WS 或 POSIM_UNDERLAY 查看路径。
将自己的 SDF 文件和录制数据保存在 /work,它挂载的是 posim-data 数据卷。容器停止后,其他文件也会保留;但删除容器时,这些文件会一起被删除。替换容器前,请将源码修改提交到 Git 或复制到外部。数据卷只有在明确删除时才会消失。
停止、恢复和更新
先在仿真终端中按 Ctrl+C,然后在宿主机上执行:
docker stop posim
docker start posim
更新时,先保存工作、停止容器并下载所需镜像,再删除已停止的容器。重新执行安装指南中的创建命令,并继续使用 posim-data,即可保留 /work 中的数据。
图形与 GPU
Linux 需要配置宿主机驱动和 NVIDIA Container Toolkit。Windows 请参照 Docker Desktop 的 WSL2 GPU 配置。CUDA 声呐还需要镜像内的相关库,详见声呐配置。初次显示验证使用软件渲染,速度可能低于 GPU 渲染。