CI: Makefile/Docker testing

To test the build on various distro, we are using docker containers and a Makefile for orchestration.

pros:

• You are independent of third party CI runner config (e.g. github actions runners).
• You can run it locally on any unix system.
• Most CI provide runner with docker and Makefile installed.

cons:

• Only GNU/Linux distro supported.
• Could take few GiB (~50 GiB for all distro and all languages)
  • ~500MiB OS + C++/CMake tools,
  • ~150 MiB Python, wheel.

Usage

To get the help simply type:

make

note: you can also use from top directory

make --directory=tools/docker

Example

For example to test inside an Alpine container:

make alpine-edge_test

Docker layers

Dockerfile is split in several stages.

Legend:

• <platform>: amd64, arm64, riscv64.
• <distro>: alpine-edge, archlinux, centos, debian, fedora, opensuse, ubuntu.
• <lang>: cpp, dotnet, java, python.

Docker aarch64 on x86_64 machine

You can build and run aarch64 docker container on a x86_64 by enabling qemu support:

docker run --rm --privileged multiarch/qemu-user-static --reset -p yes

To test:

docker run --platform linux/arm64 --rm --init -it ubuntu:latest bash -c "uname -a"

ref:

• https://github.com/docker-library/official-images#architectures-other-than-amd64
• https://github.com/multiarch/qemu-user-static#getting-started