Docs: fedora32 is no longer supported (for integration tests) (#76159)

pull/76178/head
Matthew Donoughe 3 years ago committed by GitHub
parent e0e6464873
commit d17f9a523d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -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 <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/completion/docker.txt>`_ 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 <https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/completion/docker.txt>`_ 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
==================

Loading…
Cancel
Save