devel/testing/main.rst

371 was originally written for Docker although we also support Podman as
373 names and scripts are prefixed with "docker" the system will
379 Docker Prerequisites
382 Install "docker" with the system package manager and start the Docker service
384 Docker commands. Typically it means setting up passwordless ``sudo docker``
389   $ sudo yum install docker
390   $ # or `apt-get install docker` for Ubuntu, etc.
391   $ sudo systemctl start docker
392   $ sudo docker ps
397 "docker" group and making the docker daemon socket file (by default
398 ``/var/run/docker.sock``) accessible to the group:
402   $ sudo groupadd docker
403   $ sudo usermod $USER -a -G docker
404   $ sudo chown :docker /var/run/docker.sock
407 exploit the whole host with Docker bind mounting or other privileged
425 From source tree, type ``make docker-help`` to see the help. Testing
432   make docker-test-build@debian
450    make docker-image-debian-arm64-cross NOCACHE=1
456 in ``tests/docker/dockerfiles/``, called ``debian.docker``. ``make docker-help``
459 A ``.pre`` script can be added beside the ``.docker`` file, which will be
465 a new ``.docker`` file under the ``tests/docker/dockerfiles/`` directory.
589 QEMU.  Docker tests are the executables under ``tests/docker`` named
591 library, ``tests/docker/common.rc``, which provides helpers to find the QEMU
594 The full list of tests is printed in the ``make docker-help`` help.
596 Debugging a Docker test failure
599 When CI tasks, maintainers or yourself report a Docker test failure, follow the
603    ``make docker-test-mingw@fedora-win64-cross J=8``.
607    build QEMU and run tests from there, or press Ctrl-D to let the Docker
616 Various options can be used to affect how Docker tests are done. The full
617 list is in the ``make docker`` help text. The frequently used ones are:
624 * ``DEBUG=1``: enables debug. See the previous "Debugging a Docker test
637 Thread Sanitizer in Docker
639 TSan is currently supported in the ubuntu2204 docker.
645   make docker-test-tsan@ubuntu2204
647 TSan warnings under docker are placed in files located at build/tsan/.
649 We recommend using DEBUG=1 to allow launching the test from inside the docker,
656 These steps are normally done automatically in the docker.
754 docker-binfmt-image-debian-% targets
760 simplify setting up a rootfs by using docker to contain the foreign
770 potential complications when copying into the docker image. Modern
780   make docker-binfmt-image-debian-sid-hppa \