=========
Genealogy
=========

- `Releases Summary`_
- `Supermarket Releases`_
- `How to release Chef cookbooks`_

Releases Summary
================

+----------------------------+------------------------------+------------------------+
| Module Version             | OpenStack Version Codename   | Community Supported    |
+============================+==============================+========================+
| 7.y.z                      | Grizzly                      | no - EOL (2014-03-29)  |
+----------------------------+------------------------------+------------------------+
| 8.y.z                      | Havana                       | no - EOL (2014-09-30)  |
+----------------------------+------------------------------+------------------------+
| 9.y.z                      | Icehouse                     | no - EOL (2015-07-02)  |
+----------------------------+------------------------------+------------------------+
| 10.y.z                     | Juno                         | no - EOL (2015-12-07)  |
+----------------------------+------------------------------+------------------------+
| 11.y.z                     | Kilo                         | no - EOL (2016-05-02)  |
+----------------------------+------------------------------+------------------------+
| 12.y.z                     | Liberty                      | no - EOL (2016-11-17)  |
+----------------------------+------------------------------+------------------------+
| 13.y.z                     | Mitaka                       | no - EOL (2017-04-10)  |
+----------------------------+------------------------------+------------------------+
| 14.y.z                     | Newton                       | no - EOL (2017-10-11)  |
+----------------------------+------------------------------+------------------------+
| 15.y.z                     | Ocata                        | no - EOL (2019-12-12)  |
+----------------------------+------------------------------+------------------------+
| 16.y.z                     | Pike                         | no - EOL (2019-12-12)  |
+----------------------------+------------------------------+------------------------+
| 17.y.z                     | Queens                       | yes                    |
+----------------------------+------------------------------+------------------------+
| 18.y.z                     | Rocky                        | yes                    |
+----------------------------+------------------------------+------------------------+
| 19.y.z                     | Stein                        | yes                    |
+----------------------------+------------------------------+------------------------+
| 20.y.z                     | Train                        | yes (current master)   |
+----------------------------+------------------------------+------------------------+
| 21.y.z                     | Ussuri                       | Future                 |
+----------------------------+------------------------------+------------------------+
| 22.y.z                     | Victoria                     | Future                 |
+----------------------------+------------------------------+------------------------+
| 23.y.z                     | Wallaby                      | Future                 |
+----------------------------+------------------------------+------------------------+
| 24.y.z                     | Xena                         | Future                 |
+----------------------------+------------------------------+------------------------+
| 25.y.z                     | Yoga                         | Future                 |
+----------------------------+------------------------------+------------------------+

Supermarket releases
====================

- From Ocata on, the cookbooks are released on the Chef Supermarket_.

.. _Supermarket: https://supermarket.chef.io/users/openstack

How to release Chef cookbooks
=============================

- A core member will create the new branch based on the desired SHA.
  Example: https://review.openstack.org/#/admin/projects/openstack/cookbook-openstack-compute,branches
- For all cookbooks to be released: update .gitreview and Berksfile
  to stable/<release>
  Example: https://review.openstack.org/547505
- Create a review with the above and propose it against the stable/<release> branch.
- Solicit for reviews and approval.