Docker環境
POSIMイメージにはUbuntu、ROS 2 Lyrical、Gazebo Jetty、POSIM、ArduSub、ArduRover、MAVROS、QGroundControlが含まれています。画面表示とドライバの準備は、実行環境の選択から各OSの手順を確認してください。
配布済みイメージを取得する
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 .
OS別のインストール手順では、ioeslab/posim:latestを作成したローカルタグに置き換えます。どちらも手元のソースと固定リビジョンの波浪ライブラリをビルドします。ARM64版にはXFCEデスクトップとRDPサーバーも含まれます。
OSに合った方法で起動する
- 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
更新する場合は作業内容を保存し、コンテナを停止してから新しいイメージを取得します。停止中のコンテナを削除し、OS別の作成コマンドをもう一度実行してください。posim-dataを再利用すれば/workのファイルを引き継げます。
グラフィックスとGPU
LinuxではホストのドライバとNVIDIA Container Toolkitを設定します。WindowsではDocker DesktopとWSL2のGPU設定に従います。CUDAソナーにはイメージ内のライブラリも必要です。ソナーの設定を参照してください。最初の表示確認はソフトウェアレンダリングを使うため、GPU利用時より遅くなることがあります。