This repository is a template for creating ROS2 packages with a CI workflow and devcontainer configuration.
- Use this repository as a template (top-right corner → Use this template) and specify your owner and package name.
- Open the cloned repository in VSCode — it will prompt you to Reopen in Container.
- You will be asked to select which version you want to run, use the instructions below to determine which version you need.
- The devcontainer will install all workspace dependencies and build the workspace automatically.
- Open the ports section to see which port noVNC is listening on.
| Version | When |
|---|---|
| Default (CPU-safe) | Recommended first choice. Uses no GPU passthrough and works across laptops, VMs, macOS, and Windows hosts. |
Generic GPU (/dev/dri) |
Use when your host exposes /dev/dri and you want hardware acceleration without NVIDIA runtime requirements. |
| NVIDIA GPU | Use when you have an NVIDIA GPU and NVIDIA Container Toolkit installed. This profile layers generic GPU and NVIDIA-specific overrides. |
- Add ROS2 packages to the
src/folder usingros2 pkg create ... - The devcontainer runs as
rootusinglcas.lincoln.ac.uk/ros:humbleas the base image - Dependencies listed in
package.xmlfiles are installed automatically viarosdep