hejia-zhang / ros2-humble-docker-dev

ROS2 Humble - docker dev template

This repo is based on this repo.

This repo provides a template for a quick start with a ROS2 Humble development in Docker.

ros2-docker.mp4

Setup

git clone https://github.com/sskorol/ros2-humble-docker-dev-template.git && cd ros2-humble-docker-dev-template
./run.sh -h

Building

./run.sh -w dev_ws -i [YOUR_IMAGE_NAME:TAG] -b

Running

• Update .tmux.conf if you need to enable additional tmux features
• Update .session.yml to customize Tmuxinator UI

Note that the above configs are mapped as volumes to docker image.

./run.sh -w dev_ws -i [YOUR_IMAGE_NAME:TAG] -r

Development

• Follow this guide to prepare VSCode for remote development in a container.
• Start the docker container via the command from the Running section.
• Open VSCode and attach to the running container.
• Open your ROS2 workspace and enjoy.

Notes

• Mouse is enabled by default
• Use pageup/pagedown keys to switch between tmux windows (mouse click also works)
• Press shift key to select the text via mouse
• tmux ctrl+b prefix is remapped to ctrl+a
• ctrl+a -> x -> y series closes the tmux and docker session