ROS2 Navigation Framework and System (Nav2) コンテナ化デプロイの包括的ガイド

ROS2 Navigation Framework and System (Nav2) は、移動ロボット向けの高性能オープンソースナビゲーションフレームワークです。ROS2エコシステムの中核コンポーネントとして、完全自律ナビゲーションソリューションを提供します。本稿では、コンテナ技術を活用し、Nav2ナビゲーションシステムを迅速に構築・実行する実践的なデプロイ手法を詳述します。

コンテナ化によるNav2デプロイの優位性

従来のROS2開発環境は依存関係が複雑で、環境構築に多大な工数を要します。コンテナ化デプロイは以下の利点をもたらします:

• 環境の再現性: 開発、テスト、本番環境の完全な一致
• 高速セットアップ: 数分で完全なナビゲーションシステムを構築
• リソース隔離: システムライブラリの競合を防止し、安定性を向上
• ポータビリティ: 異なるプラットフォーム間での容易な移行と拡張

Nav2システムのアーキテクチャ概要

Nav2はモジュール設計を採用し、主要コンポーネントは以下の通りです:

• タスク実行層: MissionExecutionTask - 高レベルタスクの調整
• ナビゲーション層: NavigateToPoseTask - 位置姿勢ナビゲーション処理
• 経路計画層: ComputePathToPoseTask - A*アルゴリズムによる経路探索
• 制御層: FollowPathTask - DWAアルゴリズムによる経路追従

包括的コンテナ化デプロイ手順

1. 環境準備とDocker設定

Nav2プロジェクトは、ルートディレクトリおよびtoolsディレクトリに複数のDocker設定を用意しています:

• 基本Dockerfile: 完全なビルド環境の提供
• ディストリビューションDockerfile: tools/distro.Dockerfile - ROSディストリビューションに基づく迅速デプロイ
• ソースコードDockerfile: tools/source.Dockerfile - ソースからの完全ビルド制御

2. マルチステージビルド最適化

Docker設定では先進的なマルチステージビルドを採用:

# キャッシュ段階 - ビルド速度最適化
FROM $FROM_IMAGE AS cacher

# ビルド段階 - 依存関係インストールとコンパイルの分離
FROM $FROM_IMAGE AS builder

# テスト段階 - 単体テストの実行
FROM builder AS tester

# 開発段階 - 開発ツールを含む
FROM builder AS dever

# 可視化段階 - 可視化ツールを含む
FROM dever AS visualizer

このアーキテクチャにより:

• 最終イメージサイズの最小化
• ビルドキャッシュの最大活用
• 多様なユースケース（開発、テスト、本番）のサポート

3. ワンコマンドデプロイ

Nav2コンテナのクイック起動:

# 基本イメージのビルド
docker build -t nav2:latest \
  --build-arg FROM_IMAGE=ros:rolling \
  --build-arg UNDERLAY_MIXINS="debug ccache lld" \
  --build-arg OVERLAY_MIXINS="debug ccache coverage-gcc lld" ./

# または、プリセットディストリビューションを使用
docker build -t nav2:rolling \
  --build-arg FROM_IMAGE=ros:rolling \
  --build-arg OVERLAY_MIXINS="release ccache lld" \
  -f tools/distro.Dockerfile ../

4. コンテナオーケストレーションとコンポーネント管理

単一コンテナデプロイ:

# 完全なNav2ナビゲーションスタックの起動
docker run -it --rm \
  --network host \
  --privileged \
  -v /dev:/dev \
  nav2:latest \
  ros2 launch nav2_bringup bringup_launch.py

マルチコンテナマイクロサービスアーキテクチャ:

# docker-compose.yml例
version: '3'
services:
  nav2-core:
    image: nav2:latest
    command: ros2 launch nav2_bringup bringup_launch.py
    network_mode: host
    privileged: true
    
  rviz:
    image: ros:rolling-desktop
    command: rviz2
    network_mode: host
    
  simulation:
    image: gazebo:gzserver11
    network_mode: host

主要コンポーネントのコンテナ設定

衝突モニターのコンテナ化

Nav2の衝突モニター(Collision Monitor)は安全ナビゲーションに不可欠であり、コンテナ設定は以下の通り:

# nav2_collision_monitor/launch/collision_monitor_node.launch.py
container_name = LaunchConfiguration('container_name')
container_name_full = (namespace, '/', container_name)
declare_container_name_cmd = DeclareLaunchArgument(
    'container_name',
    default_value='nav2_container',
    description='the name of container that nodes will load in if use composition',
)

ビヘイビアツリーナビゲーターのコンテナ化

複雑な復旧メカニズムをサポートするビヘイビアツリーナビゲーターのコンテナ起動:

docker run -it --rm \
  -v $(pwd)/nav2_bt_navigator/behavior_trees:/opt/overlay_ws/install/nav2_bt_navigator/share/nav2_bt_navigator/behavior_trees \
  nav2:latest \
  ros2 launch nav2_bt_navigator bt_navigator_launch.py

MPPIコントローラーのコンテナ化

モデル予測経路積分(MPPI)コントローラーによる高度な経路計画:

# コンテナ設定例
nav2_mppi_controller:
  image: nav2:latest
  command: ros2 launch nav2_mppi_controller mppi_controller_launch.py
  environment:
    - USE_SIM_TIME=true
    - MPPI_ITERATIONS=1000
    - MPPI_TIME_STEPS=30

自律ドッキングシステムのコンテナ化

精密な位置制御とセンサー統合が必要なドッキングシステム:

# ドッキングサービスの起動
docker run -it --rm \
  --device=/dev/video0:/dev/video0 \
  -v $(pwd)/docking_config:/opt/docking_config \
  nav2:latest \
  ros2 launch opennav_docking docking_server.launch.py

本番環境でのベストプラクティス

リソース最適化設定

メモリとCPU制限:

docker run -it --rm \
  --cpus="2.0" \
  --memory="2g" \
  --memory-swap="4g" \
  nav2:latest

GPUアクセラレーション:

docker run -it --rm \
  --gpus all \
  -e NVIDIA_VISIBLE_DEVICES=all \
  nav2:latest

ネットワーク設定最適化

ROS2 DDS設定:

docker run -it --rm \
  -e RMW_IMPLEMENTATION=rmw_fastrtps_cpp \
  -e FASTRTPS_DEFAULT_PROFILES_FILE=/opt/overlay_ws/src/navigation2/fastrtps_profile.xml \
  nav2:latest

マルチコンテナ通信:

# 専用ネットワークの作成
docker network create nav2-network

# コンテナをネットワークに参加
docker run -it --rm \
  --network nav2-network \
  --name nav2-core \
  nav2:latest

データ永続化戦略

地図データの永続化:

docker run -it --rm \
  -v $(pwd)/maps:/opt/overlay_ws/install/nav2_map_server/share/nav2_map_server/maps \
  -v $(pwd)/params:/opt/overlay_ws/install/nav2_bringup/share/nav2_bringup/params \
  nav2:latest

ログとモニタリング:

docker run -it --rm \
  -v $(pwd)/logs:/root/.ros/log \
  -v $(pwd)/metrics:/var/log/nav2 \
  nav2:latest

トラブルシューティングとデバッグガイド

一般的な問題の解決

コンテナ起動失敗:

# 依存関係の確認
docker run -it --rm nav2:latest rosdep check

# ROS2環境の検証
docker run -it --rm nav2:latest ros2 doctor

ネットワーク通信問題:

# DDS設定の確認
docker run -it --rm nav2:latest ros2 topic list

# ノード通信の検証
docker run -it --rm nav2:latest ros2 node list

パフォーマンスモニタリング

# コンテナリソース監視
docker stats nav2-container

# ROS2システムモニタリング
docker exec -it nav2-container ros2 run rqt_graph rqt_graph
docker exec -it nav2-container ros2 run rqt_console rqt_console

拡張とカスタマイズ

カスタムプラグイン開発:

# ベースイメージの拡張
FROM nav2:latest

# カスタムプラグインの追加
COPY ./custom_plugins /opt/overlay_ws/src/navigation2/custom_plugins
RUN . /opt/ros/$ROS_DISTRO/setup.sh && \
    cd /opt/overlay_ws && \
    colcon build --packages-select custom_plugins

マルチロボットデプロイ:

# docker-compose-multi-robot.yml
version: '3'
services:
  robot1-nav2:
    image: nav2:latest
    container_name: robot1-nav2
    command: ros2 launch nav2_bringup bringup_launch.py robot_name:=robot1
    
  robot2-nav2:
    image: nav2:latest  
    container_name: robot2-nav2
    command: ros2 launch nav2_bringup bringup_launch.py robot_name:=robot2