blob: 02c53380b51a97a174dc3c310f5c6165ec749436 [file] [log] [blame]
Ghanshyam Mann96800bb2020-05-04 19:51:37 -05001Stable Branch Testing Policy
2============================
3
4Tempest and its plugins need to support the stable branches
5as per :doc:`Stable Branch Support Policy </stable_branch_support_policy>`.
6
7Because of branchless model of Tempest and plugins, all the supported
8stable branches use the Tempest and plugins master version for their
9testing. That is done in devstack by using the `master branch
10<https://opendev.org/openstack/devstack/src/commit/c104afec7dd72edfd909847bee9c14eaf077a28b/stackrc#L314>`_
11for the Tempest installation. To make sure the master version of Tempest or
12plugins (for any changes or adding new tests) is compatible for all
13the supported stable branches testing, Tempest and its plugins need to
14add the stable branches job on the master gate. That way can test the stable
15branches against master code and can avoid breaking supported branches
16accidentally.
17
18Example:
19
20* `Stable jobs on Tempest master
21 <https://opendev.org/openstack/tempest/src/commit/e8f1876aa6772077f85f380677b30251c2454505/.zuul.yaml#L646-L651>`_.
22
23* `Stable job on neutron tempest plugins
24 <https://opendev.org/openstack/neutron-tempest-plugin/src/commit/4bc1b00213cf660648cad1916fe6497ac29b2e78/.zuul.yaml#L1427-L1428>`_
25
26Once any stable branch is moved to the `Extended Maintenance Phases`_
27and devstack start using the Tempest older version for that stable
28branch testing then we can remove that stable branch job from master
29gate.
30
31Example: https://review.opendev.org/#/c/722183/
32
33.. _Extended Maintenance Phases: https://docs.openstack.org/project-team-guide/stable-branches.html#extended-maintenance