Skip to content

cpp-projects-showcase/docker-images

Repository files navigation

Container images to support development with C++ and Python

Docker Cloud build status Container repository on Quay

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 9 Stream, CentOS 8 Stream, CentOS 7, Fedora 39, Fedora 38, (TBC) Ubuntu 24.04 LTS (Noble Numbat), Ubuntu 22.04 LTS (Jammy Jellyfish), Ubuntu 20.04 LTS (Focal Fossa), Ubuntu 18.04 LTS (Bionic Beaver), 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

Images on Docker Cloud

Using the pre-built development images

  • Start the Docker container featuring the target Linux distribution (<linux-distrib> may be one of rocky9, centos9, centos8, centos7, fedora39, fedora38, debian12, debian11, ubuntu2204, ubuntu2004 or ubuntu1804):
$ 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, centos7, fedora39, fedora38, debian12, debian11, ubuntu2204, ubuntu2004 or ubuntu1804:

$ 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)

About

Docker images for applications relying on C++ stacks

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published