infrahelpers/cpppython repository overview

⁠Container images to support development with C++ and Python

⁠Introduction

That project⁠ produces container (e.g., Docker) images, hosted on a dedicated public Docker Cloud site⁠. Those container images are intended to bring Linux-based ready-to-use environment for C++ and Python developers. Both programming languages are indeed related, as Python is built on top of C++ (e.g., a few Python modules need to be compiled with C++). Some basic support for R⁠ is also provided.

The supported Linux distributions are Rocky Linux 9⁠, CentOS 10 Stream⁠ (not officially released, as of end 2024; see also CentOS Stream 10 compose artifacts⁠), CentOS 9 Stream⁠, CentOS 8 Stream⁠, Fedora 40⁠, Fedora 39⁠, Ubuntu 24.04 LTS (Noble Numbat)⁠, Ubuntu 22.04 LTS (Jammy Jellyfish)⁠, Ubuntu 20.04 LTS (Focal Fossa)⁠, Debian 12 (Bookworm)⁠, and Debian 11 (Bullseye)⁠.

Every time some changes are committed on the project's GitHub repository⁠, the container images are automatically rebuilt⁠ and pushed onto Docker Cloud.

When some more components are needed, which may be of interest to other C++ and Python developers, the Docker image may be amended so as to add those extra components. The preferred way to propose amendment of the Docker image is through pull requests on the GitHub project⁠. Once the pull request has been merged, i.e., once the Dockerfile amendment has been committed in GitHub⁠, Docker Cloud then rebuilds the corresponding container images, which become available for every one to use.

⁠See also

• Management of Python-related Docker images⁠

⁠Images on Docker Cloud

• Docker Cloud dashboard⁠

⁠Using the pre-built development images

• Start the Docker container featuring the target Linux distribution (<linux-distrib> may be one of rocky9, centos9, centos8, fedora40, fedora39, debian12, debian11, ubuntu2404, ubuntu2204, or ubuntu2004):

$ docker pull infrahelpers/cpppython:<linux-distrib>
$ docker run --rm -v ~/.ssh/id_rsa:/home/build/.ssh/id_rsa -v ~/.ssh/id_rsa.pub:/home/build/.ssh/id_rsa.pub -it infrahelpers/cpppython:<linux-distrib>
[[email protected] dev]$ 

• Setup the user names and email addresses as environment variables for subsequent settings. If you intend to contribute to Fedora/CentOS/RedHat packaging, they should match as much as possible with Pagure, the Fedora Git repository⁠(otherwise, just ignore the RPM packaging part):

[[email protected] dev]$ export FULLNAME="Firstname Lastname"
[[email protected] dev]$ export EMAIL="[email protected]"

• Setup the user name and email address for Git:

[[email protected] dev]$ git config --global user.name "$FULLNAME"
[[email protected] dev]$ git config --global user.email "$EMAIL"

• Setup the user names and email address for the RPM packaging:

[[email protected] dev]$ sed -i -e "s/Firstname Lastname/$FULLNAME/g" ~/.rpmmacros
[[email protected] dev]$ sed -i -e "s/[email protected]/$EMAIL/g" ~/.rpmmacros

• Clone some C++-based project (e.g., OpenTREP⁠ is used as an example here):

[[email protected] dev]$ git clone https://github.com/trep/opentrep.git
Cloning into 'opentrep'...
remote: Enumerating objects: 44, done.
remote: Counting objects: 100% (44/44), done.
remote: Compressing objects: 100% (35/35), done.
Receiving objects: 100% (5813/5813), 61.53 MiB | 211.00 KiB/s, done.
remote: Total 5813 (delta 12), reused 19 (delta 8), pack-reused 5769
Resolving deltas: 100% (3665/3665), done.
[[email protected] dev]$ cd opentrep
[[email protected] opentrep (trunk)]$ 

• Do some development:

[[email protected] opentrep (trunk)]$ export INSTALL_BASEDIR="${HOME}/dev/deliveries" && if [ -d /usr/lib64 ]; then LIBSUFFIX=64; fi && export LIBSUFFIX_4_CMAKE="-DLIB_SUFFIX=${LIBSUFFIX}"
[[email protected] opentrep (trunk)]$ rm -rf build && mkdir build && cd build
[[email protected] build (trunk)]$ cmake3 -DCMAKE_INSTALL_PREFIX=${INSTALL_BASEDIR}/opentrep-latest  -DCMAKE_BUILD_TYPE:STRING=Debug -DINSTALL_DOC:BOOL=OFF -DRUN_GCOV:BOOL=OFF ${LIBSUFFIX_4_CMAKE} ..
[[email protected] build (trunk)]$ make install
[[email protected] build (trunk)]$ ./opentrep/opentrep-indexer -t sqlite
[[email protected] build (trunk)]$ ./opentrep/opentrep-searcher -t sqlite -q "nce sfo"
[[email protected] build (trunk)]$ exit

⁠Customize a Docker Image

The images may be customized, and pushed to Docker Cloud; <linux-distrib> may be one of rocky9, centos9, centos8, fedora40, fedora39, debian12, debian11, ubuntu2404, ubuntu2204, or ubuntu2004:

$ mkdir -p ~/dev
$ cd ~/dev
$ git clone https://github.com/cpp-projects-showcase/docker-images.git cpp-docker-images
$ cd cpp-docker-images
$ vi <linux-distrib>/Dockerfile
$ docker build -t infrahelpers/cpppython:<linux-distrib> <linux-distrib>/
$ docker run --rm -v ~/.ssh/id_rsa:/home/build/.ssh/id_rsa -v ~/.ssh/id_rsa.pub:/home/build/.ssh/id_rsa.pub -it infrahelpers/cpppython:<linux-distrib>
[[email protected] cpp-projects-showcase]$ exit
$ docker push infrahelpers/cpppython:<linux-distrib>

⁠TODO

For any of the following features, an issue may be open on GitHub⁠:

1. Automate regular rebuilds (e.g., once a month for CentOS or Ubuntu)