dockerfiles¶

These are multi-stage docker images I use for developing with VSCode.

See how I develop with vscode and docker.

Instructions on how to duplicate my IDE:

vscode, docker, and ros2

Images will continue to be supported so long as they haven't reached EOL

Ignition/Gazebo https://gazebosim.org/docs/all/releases
Gazebo (classic) https://classic.gazebosim.org/#status
ROS https://wiki.ros.org/Distributions
ROS2 https://docs.ros.org/en/rolling/Releases.html

Quick start¶

Grab the docker image from docker hub. This repo provides the images in:

Then, set up a vscode workspace.

Build from source¶

Alternatively, you can build all the docker 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 to PyPI.

Install from GitHub:

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

Pin to a branch/tag/commit:

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

For local development (editable install):

pip install -e .

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"])