From d17f9a523d415dda19ae389172a2576dd618e424 Mon Sep 17 00:00:00 2001 From: Matthew Donoughe Date: Fri, 29 Oct 2021 11:29:32 -0400 Subject: [PATCH] Docs: fedora32 is no longer supported (for integration tests) (#76159) --- .../rst/dev_guide/testing_integration.rst | 44 +++++++++---------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/docsite/rst/dev_guide/testing_integration.rst b/docs/docsite/rst/dev_guide/testing_integration.rst index 366ca68172b..6597428cd74 100644 --- a/docs/docsite/rst/dev_guide/testing_integration.rst +++ b/docs/docsite/rst/dev_guide/testing_integration.rst @@ -70,19 +70,15 @@ Non-destructive Tests These tests will modify files in subdirectories, but will not do things that install or remove packages or things outside of those test subdirectories. They will also not reconfigure or bounce system services. -.. note:: Running integration tests within Docker +.. note:: Running integration tests within containers - To protect your system from any potential changes caused by integration tests, and to ensure a sensible set of dependencies are available we recommend that you always run integration tests with the ``--docker`` option, for example ``--docker centos8``. See the `list of supported docker images `_ for options (the ``default`` image is used for sanity and unit tests, as well as for platform independent integration tests such as those for cloud modules). + To protect your system from any potential changes caused by integration tests, and to ensure a sensible set of dependencies are available we recommend that you always run integration tests with the ``--docker`` option, for example ``--docker centos8``. See the `list of supported container images `_ for options (the ``default`` image is used for sanity and unit tests, as well as for platform independent integration tests such as those for cloud modules). -.. note:: Avoiding pulling new Docker images - - Use the ``--docker-no-pull`` option to avoid pulling the latest container image. This is required when using custom local images that are not available for download. - -Run as follows for all POSIX platform tests executed by our CI system in a fedora32 docker container: +Run as follows for all POSIX platform tests executed by our CI system in a Fedora 34 container: .. code-block:: shell-session - ansible-test integration shippable/ --docker fedora32 + ansible-test integration shippable/ --docker fedora34 You can target a specific tests as well, such as for individual modules: @@ -114,7 +110,7 @@ to a virtual environment, such as Docker. They won't reformat your filesystem: .. code-block:: shell-session - ansible-test integration destructive/ --docker fedora32 + ansible-test integration destructive/ --docker fedora34 Windows Tests ============= @@ -145,12 +141,17 @@ Run the Windows tests executed by our CI system: ansible-test windows-integration -v shippable/ -Tests in Docker containers +Tests in containers ========================== -If you have a Linux system with Docker installed, running integration tests using the same Docker containers used by +If you have a Linux system with Docker or Podman installed, running integration tests using the same containers used by the Ansible continuous integration (CI) system is recommended. +.. note:: Podman + + By default, Podman will only be used if the Docker CLI is not installed. If you have Docker installed but want to use + Podman, you can change this behavior by setting the environment variable ``ANSIBLE_TEST_PREFER_PODMAN``. + .. note:: Docker on non-Linux Using Docker Engine to run Docker on a non-Linux host (such as macOS) is not recommended. @@ -176,28 +177,27 @@ For example, to run tests for the ``ping`` module on a Ubuntu 18.04 container: Container Images ---------------- -Python 2 -^^^^^^^^ - -Most container images are for testing with Python 2: - - - centos6 - - centos7 - - opensuse15py2 - Python 3 ^^^^^^^^ -To test with Python 3 use the following images: +Most container images are for testing with Python 3: - alpine3 - centos8 - - fedora32 - fedora33 + - fedora34 - opensuse15 - ubuntu1804 - ubuntu2004 +Python 2 +^^^^^^^^ + +To test with Python 2 use the following images: + + - centos7 + - opensuse15py2 + Legacy Cloud Tests ==================