jeffersonlab/cxx-devcontainer repository overview

⁠cxx-devcontainer

A C/C++ devcontainer⁠.

⁠Overview

The 1.x version series uses the following:

• G++ 11
• CMake 3.29.x
• Doxygen
• vcpkg
• Ubuntu "jammy"
• Docker outside of Docker⁠ (sibling container). Use a bind mount of the form /var/run/docker.sock:/var/run/docker.sock. We don't use Docker in Docker⁠, because it appears to be the less good option⁠.

⁠Quick Start with Compose

1. Grab project

git clone https://github.com/JeffersonLab/cxx-devcontainer
cd cxx-devcontainer

1. Launch Compose⁠

docker compose up

⁠Install

Add a .devcontainer⁠ directory to your project and launch it with Compose or your favorite devcontainer launcher (GitHub Codespaces⁠, JetBrains Gateway⁠, VSCode devcontainer extension⁠).

⁠Build / Release

Make changes to the Dockerfile, test them, then bump the version in the VERSION file and commit it. The CD GitHub Action should take care of the rest.

⁠See Also

• C/C++ workflows⁠
• Other devcontainers⁠