Skip to content

README.md

Latest commit

 

History

History
54 lines (33 loc) · 1.77 KB

README.md

File metadata and controls

54 lines (33 loc) · 1.77 KB

Docker Instructions

This container provides a reproducible environment for the "ROS 2 Testing: A Practical Survival Guide" workshop, based on the ros:jazzy-ros-core image.

It includes development tools, linters, Google Test/Mock, and all the necessary utilities to follow the exercises (using rosdep to install all the dependencies).

🚀 Building the Image and Running the Container

You can either build the image locally or pull it directly from DockerHub.

Pull from DockerHub (recommended)

The prebuilt image is available at:

docker pull ekumenlabs/ros2-testing-workshop-roscon-es-25:jazzy

This is the easiest and fastest option.

Build the Image Locally

To build the image, use the build.sh script provided in this repository:

./docker/build.sh

Or, if the user wants to build the image and run the container directly, the run.sh script can be used with the corresponding flag:

./docker/run.sh --build

It's possible to get information about the available flags for both scripts using the --help or -h option:

./docker/build.sh --help
./docker/run.sh --help

📦 Container Usage

Once the container is started, the entrypoint is located at the root of the ROS 2 workspace (~/ws).

After exiting the container, the user will be asked whether to save the changes back to the image (internally performing a docker commit).

To open another terminal connected to the same container, use the helper script join.sh:

./docker/join.sh

By default, the script opens an interactive bash session inside the running container named ros2-testing-workshop-roscon-es-25-container. A different container name or command can be specified; use the -h flag for details.