AI Agent Hub
Back to skills
💻

Docker ROS 2 Development

Development Updated 2026.08.30

Paste the following prompt into your AI chat to install this skill:

Please install @user_3c6cb52e/docker-ros2-development-4wa1 according to https://skillhub.cn/install/skillhub.md.

About this skill

Problem: local ROS 2 environments often work but are hard to reproduce

ROS 2 development depends on a colcon workspace, DDS discovery, node toolchains, and device drivers. Installing dependencies directly on the host can introduce version drift, while multi-robot systems often hit container-to-container communication failures, missing rviz2 displays, unavailable cameras or LiDAR devices, and poor CI build caching. This skill targets the engineering problem of aligning development containers with deployment environments.

How it works: generating Docker and ROS 2 configurations

It breaks the task into concrete outputs:
- Write Dockerfiles for ROS 2 workspaces, focusing on dependency setup and colcon build layer caching.
- Use docker-compose for multi-container robotic systems, covering service names, networks, ports, and environment variables.
- Debug DDS discovery failures between containers with CycloneDDS or FastDDS, rather than only starting nodes.
- Configure NVIDIA Container Toolkit GPU passthrough for perception nodes, and handle X11 / Wayland display forwarding for rviz2 and rqt.
- Plan USB device passthrough for cameras, LiDARs, and serial devices.
- Create Docker-based CI/CD pipelines, test runners, and devcontainer configurations for VS Code.
- Choose official OSRF base images according to their layered hierarchy, preferring the smallest image that satisfies dependencies.

Limits

Best for ROS 2 teams that need reproducible dev containers, multi-node debugging, device passthrough, and CI integration. It does not replace ROS 2 node implementation and cannot guarantee hardware bring-up without GPU, display server, or device permissions.

Use Cases

  • Bring up multiple ROS 2 nodes with docker-compose and debug CycloneDDS discovery failures between containers.
  • Configure NVIDIA container passthrough for perception nodes and forward X11 display so rviz2 can open.
  • Build a cached Docker image for a colcon workspace for CI builds and tests.
  • Create a VS Code devcontainer with ROS 2 extensions and a consistent development environment.

Best For

  • Robotics engineers debugging ROS 2 nodes who need a reproducible containerized environment.
  • DevOps engineers maintaining CI/CD who need colcon builds and tests in Docker.
  • Embedded or perception engineers using rviz2, rqt, and sensors who need display and USB passthrough.
  • ROS 2 software engineers using VS Code who need devcontainers for extensions and a consistent environment.