README.md
1## Makefile/Docker testing
2To test the build on various distro, we are using docker containers and a Makefile for orchestration.
3
4pros:
5* You are independent of third party CI runner config
6 (e.g. [github action virtual-environnments](https://github.com/actions/virtual-environments)).
7* You can run it locally on your linux system.
8* Most CI provide runners with docker and Makefile installed.
9
10cons:
11* Only GNU/Linux distro supported.
12
13### Usage
14To get the help simply type:
15```sh
16make
17```
18
19note: you can also use from top directory
20```sh
21make --directory=cmake/ci
22```
23
24### Example
25For example to test mips32 inside an container:
26```sh
27make mips32_test
28```
29
30### Docker layers
31Dockerfile is splitted in several stages.
32
33
34
35
36## Makefile/Vagrant testing
37To test build for FreeBSD we are using Vagrant and VirtualBox box.
38
39This is similar to the docker stuff but use `vagrant` as `docker` cli and
40VirtuaBox to replace the docker engine daemon.
41