devel/testing/main.rst

344 was originally written for Docker although we also support Podman as
346 names and scripts are prefixed with "docker" the system will
352 Docker Prerequisites
355 Install "docker" with the system package manager and start the Docker service
357 Docker commands. Typically it means setting up passwordless ``sudo docker``
362   $ sudo yum install docker
363   $ # or `apt-get install docker` for Ubuntu, etc.
364   $ sudo systemctl start docker
365   $ sudo docker ps
370 "docker" group and making the docker daemon socket file (by default
371 ``/var/run/docker.sock``) accessible to the group:
375   $ sudo groupadd docker
376   $ sudo usermod $USER -a -G docker
377   $ sudo chown :docker /var/run/docker.sock
380 exploit the whole host with Docker bind mounting or other privileged
398 From source tree, type ``make docker-help`` to see the help. Testing
405   make docker-test-build@debian
423    make docker-image-debian-arm64-cross NOCACHE=1
429 in ``tests/docker/dockerfiles/``, called ``debian.docker``. ``make docker-help``
432 A ``.pre`` script can be added beside the ``.docker`` file, which will be
438 a new ``.docker`` file under the ``tests/docker/dockerfiles/`` directory.
562 QEMU.  Docker tests are the executables under ``tests/docker`` named
564 library, ``tests/docker/common.rc``, which provides helpers to find the QEMU
567 The full list of tests is printed in the ``make docker-help`` help.
569 Debugging a Docker test failure
572 When CI tasks, maintainers or yourself report a Docker test failure, follow the
576    ``make docker-test-mingw@fedora-win64-cross J=8``.
580    build QEMU and run tests from there, or press Ctrl-D to let the Docker
589 Various options can be used to affect how Docker tests are done. The full
590 list is in the ``make docker`` help text. The frequently used ones are:
597 * ``DEBUG=1``: enables debug. See the previous "Debugging a Docker test
610 Thread Sanitizer in Docker
612 TSan is currently supported in the ubuntu2204 docker.
618   make docker-test-tsan@ubuntu2204
620 TSan warnings under docker are placed in files located at build/tsan/.
622 We recommend using DEBUG=1 to allow launching the test from inside the docker,
629 These steps are normally done automatically in the docker.
725 docker-binfmt-image-debian-% targets
731 simplify setting up a rootfs by using docker to contain the foreign
741 potential complications when copying into the docker image. Modern
751   make docker-binfmt-image-debian-sid-hppa \