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 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. 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 Run as follows for all POSIX platform tests executed by our CI system in a Fedora 34 container:
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:
.. code-block:: shell-session .. 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: 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 .. code-block:: shell-session
ansible-test integration destructive/ --docker fedora32 ansible-test integration destructive/ --docker fedora34
Windows Tests Windows Tests
============= =============
@ -145,12 +141,17 @@ Run the Windows tests executed by our CI system:
ansible-test windows-integration -v shippable/ 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. 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 .. note:: Docker on non-Linux
Using Docker Engine to run Docker on a non-Linux host (such as macOS) is not recommended. 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 Container Images
---------------- ----------------
Python 2
^^^^^^^^
Most container images are for testing with Python 2:
- centos6
- centos7
- opensuse15py2
Python 3 Python 3
^^^^^^^^ ^^^^^^^^
To test with Python 3 use the following images: Most container images are for testing with Python 3:
- alpine3 - alpine3
- centos8 - centos8
- fedora32
- fedora33 - fedora33
- fedora34
- opensuse15 - opensuse15
- ubuntu1804 - ubuntu1804
- ubuntu2004 - ubuntu2004
Python 2
^^^^^^^^
To test with Python 2 use the following images:
- centos7
- opensuse15py2
Legacy Cloud Tests Legacy Cloud Tests
================== ==================

Loading…
Cancel
Save