summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatt Clay <matt@mystile.com>2022-12-08 13:22:22 -0800
committerGitHub <noreply@github.com>2022-12-08 16:22:22 -0500
commit0f4afd7e6d584c19b7e95fe6682cb159c89925bc (patch)
treee82f055596d47b5c733e7d9b555d68932457a33d
parent932a32153a4166d4efc3564f89177aa22935acf5 (diff)
downloadansible-0f4afd7e6d584c19b7e95fe6682cb159c89925bc.tar.gz
Remove obsolete legacy integration test docs. (#79563)
-rw-r--r--docs/docsite/rst/dev_guide/testing_integration.rst7
-rw-r--r--docs/docsite/rst/dev_guide/testing_integration_legacy.rst114
2 files changed, 0 insertions, 121 deletions
diff --git a/docs/docsite/rst/dev_guide/testing_integration.rst b/docs/docsite/rst/dev_guide/testing_integration.rst
index b335826119..915281d02c 100644
--- a/docs/docsite/rst/dev_guide/testing_integration.rst
+++ b/docs/docsite/rst/dev_guide/testing_integration.rst
@@ -187,13 +187,6 @@ Container images are updated regularly. To see the current list of container ima
The list is under the **target docker images and supported python version** heading.
-Legacy Cloud Tests
-==================
-
-Some of the cloud tests run as normal integration tests, and others run as legacy tests; see the
-:ref:`testing_integration_legacy` page for more information.
-
-
Other configuration for Cloud Tests
===================================
diff --git a/docs/docsite/rst/dev_guide/testing_integration_legacy.rst b/docs/docsite/rst/dev_guide/testing_integration_legacy.rst
deleted file mode 100644
index 115fde6c93..0000000000
--- a/docs/docsite/rst/dev_guide/testing_integration_legacy.rst
+++ /dev/null
@@ -1,114 +0,0 @@
-:orphan:
-
-.. _testing_integration_legacy:
-
-*******************************************
-Testing using the Legacy Integration system
-*******************************************
-
-.. contents:: Topics
-
-This page details how to run the integration tests that haven't been ported to the new ``ansible-test`` framework.
-
-The following areas are still tested using the legacy ``make tests`` command:
-
-* amazon (some)
-* azure
-* cloudflare
-* cloudscale
-* cloudstack
-* consul
-* exoscale
-* gce
-* jenkins
-* rackspace
-
-Over time the above list will be reduced as tests are ported to the ``ansible-test`` framework.
-
-
-Running Cloud Tests
-====================
-
-Cloud tests exercise capabilities of cloud modules (for example, ec2_key). These are
-not 'tests run in the cloud' so much as tests that use the cloud modules
-and are organized by cloud provider.
-
-Some AWS tests may use environment variables. It is recommended to either unset any AWS environment variables( such as ``AWS_DEFAULT_PROFILE``, ``AWS_SECRET_ACCESS_KEY``, and so on) or be sure that the environment variables match the credentials provided in ``credentials.yml`` to ensure the tests run with consistency to their full capability on the expected account. See `AWS CLI docs <https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html>`_ for information on creating a profile.
-
-Subsets of tests may be run by ``#commenting`` out unnecessary roles in the appropriate playbook, such as ``test/integration/amazon.yml``.
-
-In order to run cloud tests, you must provide access credentials in a file
-named ``credentials.yml``. A sample credentials file named
-``credentials.template`` is available for syntax help.
-
-Provide cloud credentials:
-
-.. code-block:: shell-session
-
- cp credentials.template credentials.yml
- ${EDITOR:-vi} credentials.yml
-
-
-Other configuration
-===================
-
-In order to run some tests, you must provide access credentials in a file named
-``credentials.yml``. A sample credentials file named ``credentials.template`` is available
-for syntax help.
-
-IAM policies for AWS
-====================
-
-In order to run the tests in an AWS account ansible needs fairly wide ranging powers which
-can be provided to a dedicated user or temporary credentials using a specific policy
-configured in the AWS account.
-
-testing-iam-policy.json.j2
---------------------------
-
-The testing-iam-policy.json.j2 file contains a policy which can be given to the user
-running the tests to give close to minimum rights required to run the tests. Please note
-that this does not fully restrict the user; The user has wide privileges for viewing
-account definitions and is also able to manage some resources that are not related to
-testing (for example, AWS lambdas with different names) primarily due to the limitations of the
-Amazon ARN notation. At the very least the policy limits the user to one region, however
-tests should not be run in a primary production account in any case.
-
-Other Definitions required
---------------------------
-
-Apart from installing the policy and giving it to the user identity running
-the tests, a lambda role `ansible_integration_tests` has to be created which
-has lambda basic execution privileges.
-
-
-Running Tests
-=============
-
-The tests are invoked through the ``Makefile``.
-
-If you haven't already got Ansible available use the local checkout by doing:
-
-.. code-block:: shell-session
-
- source hacking/env-setup
-
-Run the tests by doing:
-
-.. code-block:: shell-session
-
- cd test/integration/
- # TARGET is the name of the test from the list at the top of this page
- #make TARGET
- # for example
- make amazon
- # To run all cloud tests you can do:
- make cloud
-
-.. warning:: Possible cost of running cloud tests
-
- Running cloud integration tests will create and destroy cloud
- resources. Running these tests may result in additional fees associated with
- your cloud account. Care is taken to ensure that created resources are
- removed. However, it is advisable to inspect your AWS console to ensure no
- unexpected resources are running.