diff --git a/doc/source/contributor/index.rst b/doc/source/contributor/index.rst index 7ad558c3df..39b93a0a5e 100644 --- a/doc/source/contributor/index.rst +++ b/doc/source/contributor/index.rst @@ -30,4 +30,5 @@ Contents: bug-triage core-reviewers role-services + distributions diff --git a/doc/source/developer-docs/distributions.rst b/doc/source/developer-docs/distributions.rst new file mode 100644 index 0000000000..bd2d9acaf7 --- /dev/null +++ b/doc/source/developer-docs/distributions.rst @@ -0,0 +1,36 @@ +==================== +Distribution support +==================== + +Supported distributions +~~~~~~~~~~~~~~~~~~~~~~~ + +The list of supported distributions can be found in the +:deploy_guide:`Deployment Guide ` + +Minimum requirements for OpenStack-Ansible roles +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Existing and new distributions are expected to meet the following requirements +in order for them to be accepted in the individual OpenStack-Ansible roles: + +* Pass functional tests + +Graduation +~~~~~~~~~~ + +For a distribution to be considered supported by the OpenStack-Ansible +project, it has to meet the following minimum requirements: + +* The necessary steps for bootstrapping the operating system have to be + documented in the :deploy_guide:`Deployment Guide `. +* The integration repository contains at least one job which passes the + Temptest testing framework. + +Voting +~~~~~~ + +Distributions can be promoted to voting jobs on individual roles once they move +to the `Graduation` phase and their stability has been confirmed by the core +OpenStack-Ansible developers. Similar to this, voting can also be enabled in +the integration repository for all the scenarios or a specific one.