dockerfiles

These are Docker images and runtime examples I use for ROS and Gazebo development.

The images are built and published automatically, including multi-platform builds where supported. Images will continue to be supported as long as the underlying ROS or Gazebo release has not reached EOL.

For VS Code development, I now recommend using my ROS 2 Dev Container Feature with the VSCode ROS2 Workspace Template.

Images

The currently maintained image families are available on Docker Hub:

• althack/ros2
• althack/gz

Older ROS, Gazebo Classic, and Ignition images are still available for historical releases.

Running GUI applications

Just running a Docker image is usually not enough to launch GUI applications like RViz or Gazebo. They also need access to things like the display server, networking, and sometimes GPU resources.

This repo includes Docker Compose configurations for running RViz and Gazebo with the required runtime configuration.

See the Docker Compose documentation for setup and usage.

Build from source

You can build all currently supported images directly from source:

./build.py all

Or just build one:

./build.py ros2-jazzy-base

Or build one distro group:

./build.py ros2-jazzy

To see help information and build options:

./build.py --help

Shell completion

Enable tab completion for the current shell session:

eval "$(_BUILD_PY_COMPLETE=bash_source ./build.py)"

Then try:

./build.py <TAB><TAB>

To make completion persistent for bash, add this to your ~/.bashrc:

eval "$(_BUILD_PY_COMPLETE=bash_source /path/to/dockerfiles/build.py)"

Template accessor package

You can install the template accessor package in another repo without publishing it to PyPI.

Install from GitHub:

pip install "git+https://github.com/althack/dockerfiles.git"

Pin to a branch, tag, or commit:

pip install "git+https://github.com/althack/dockerfiles.git@main"

For local development:

pip install -e ".[scripts,dev]"

Example usage:

from dockerfiles_templates import Templates

templates = Templates(templates_path="templates.yml")
for entry in templates.entries(eol=False):
    print(entry["family"], entry["name"])