From 96800bb8337350b64286af17a44761ca473b9a88 Mon Sep 17 00:00:00 2001 From: Ghanshyam Mann Date: Mon, 4 May 2020 19:51:37 -0500 Subject: [PATCH] Add document for stable branch testing for tempest plugins As Tempest and plugins master version is used to test the supported stable branches, we need to test them on master gate. Adding document for that so that we can test the stable branches more consistently on plugins side too. Change-Id: Ied3c6bb4032fd3740ae0d6d185e4a138fd335b02 --- doc/source/index.rst | 8 +++++ doc/source/stable_branch_testing_policy.rst | 33 +++++++++++++++++++++ 2 files changed, 41 insertions(+) create mode 100644 doc/source/stable_branch_testing_policy.rst diff --git a/doc/source/index.rst b/doc/source/index.rst index 93fcc3a043..b590380b7a 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -98,6 +98,14 @@ Tempest & Plugins Compatible Version Policy tempest_and_plugins_compatible_version_policy +Stable Branch Testing Policy +---------------------------- + +.. toctree:: + :maxdepth: 2 + + stable_branch_testing_policy + Library ------- diff --git a/doc/source/stable_branch_testing_policy.rst b/doc/source/stable_branch_testing_policy.rst new file mode 100644 index 0000000000..02c53380b5 --- /dev/null +++ b/doc/source/stable_branch_testing_policy.rst @@ -0,0 +1,33 @@ +Stable Branch Testing Policy +============================ + +Tempest and its plugins need to support the stable branches +as per :doc:`Stable Branch Support Policy `. + +Because of branchless model of Tempest and plugins, all the supported +stable branches use the Tempest and plugins master version for their +testing. That is done in devstack by using the `master branch +`_ +for the Tempest installation. To make sure the master version of Tempest or +plugins (for any changes or adding new tests) is compatible for all +the supported stable branches testing, Tempest and its plugins need to +add the stable branches job on the master gate. That way can test the stable +branches against master code and can avoid breaking supported branches +accidentally. + +Example: + +* `Stable jobs on Tempest master + `_. + +* `Stable job on neutron tempest plugins + `_ + +Once any stable branch is moved to the `Extended Maintenance Phases`_ +and devstack start using the Tempest older version for that stable +branch testing then we can remove that stable branch job from master +gate. + +Example: https://review.opendev.org/#/c/722183/ + +.. _Extended Maintenance Phases: https://docs.openstack.org/project-team-guide/stable-branches.html#extended-maintenance