releases/doc/source/index.rst
Doug Hellmann a817e3a6ab show per-deliverable stable status on releases.o.o
Add an API to Deliverable to let the sphinxext inject the series status
information, since the build conditions and working directory are
different under sphinx.

Change-Id: Id2bbdc4815564d28a5f4989bf7c74aed93e8c129
Story: #2001852
Task: #12620
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-04-20 15:58:57 -04:00

128 lines
4.5 KiB
ReStructuredText

====================
OpenStack Releases
====================
Release Series
==============
OpenStack is developed and released around 6-month cycles. After the initial
release, additional stable point releases will be released in each release
series. You can find the detail of the various release series here on their
series page. Subscribe to the `combined release calendar`_ for continual
updates.
.. _combined release calendar: schedule.ics
.. datatemplate::
:source: series_status.yaml
:template: series_status_table.tmpl
.. toctree::
:glob:
:maxdepth: 1
:hidden:
rocky/index
queens/index
pike/index
ocata/index
newton/index
mitaka/index
liberty/index
kilo/index
juno/index
icehouse/index
havana/index
grizzly/index
folsom/index
essex/index
diablo/index
cactus/index
bexar/index
austin/index
releases/*
Note: The schedule of `Maintenance phases`_ changed during Ocata.
The `old phases`_ were used until Newton.
.. _Maintenance phases: https://docs.openstack.org/project-team-guide/stable-branches.html#maintenance-phases
.. _old phases: https://github.com/openstack/project-team-guide/blob/1c837bf0~/doc/source/stable-branches.rst
Series-Independent Releases
===========================
Some projects are released independently from the OpenStack release series.
You can find their releases listed here:
.. toctree::
:maxdepth: 1
independent
Teams
=====
Deliverables organized by the team that produces them.
.. toctree::
:maxdepth: 1
:glob:
teams/*
Cryptographic Signatures
========================
Git tags created through our release automation are signed by
`centrally-managed OpenPGP keys`_ maintained by the `OpenStack
Infrastructure team`_. Detached signatures of many separate release
artifacts are also provided using the same keys. A new key is
created corresponding to each development cycle and rotated
relatively early in the cycle. (Implementation completed late in the
Newton cycle, so many early Newton artifacts have no corresponding
signatures.)
OpenStack Infrastructure root sysadmins and Release Managers publish
their own signatures of these keys into the global keyserver
network. Copies of the public keys can be found below along with the
date ranges during which each key was in general use.
* 2016-08-03..2016-11-22 (Newton Cycle key):
`key 0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28`_ (details__)
* 2016-11-22..2017-03-24 (Ocata Cycle key):
`key 0xd47bab1b7dc2e262a4f6171e8b1b03fd54e2ac07`_ (details__)
* 2017-03-24..2017-09-15 (Pike Cycle key):
`key 0xc96bfb160752606daa0de2fa05eb5792c876df9a`_ (details__)
* 2017-09-15..2018-03-19 (Queens Cycle key):
`key 0x4c8b8b5a694f612544b3b4bac52f01a3fbdb9949`_ (details__)
* 2018-03-19..present (Rocky Cycle key):
`key 0xc31292066be772022438222c184fd3e1edf21a78`_ (details__)
.. Static key files are generated with the following command:
( gpg2 --fingerprint 0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28
gpg2 --armor --export-options export-clean,export-minimal \
--export 0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28 ) > \
doc/source/static/0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28.txt
.. _`key 0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28`: _static/0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28.txt
.. __: https://sks-keyservers.net/pks/lookup?op=vindex&search=0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28&fingerprint=on
.. _`key 0xd47bab1b7dc2e262a4f6171e8b1b03fd54e2ac07`: _static/0xd47bab1b7dc2e262a4f6171e8b1b03fd54e2ac07.txt
.. __: https://sks-keyservers.net/pks/lookup?op=vindex&search=0xd47bab1b7dc2e262a4f6171e8b1b03fd54e2ac07&fingerprint=on
.. _`key 0xc96bfb160752606daa0de2fa05eb5792c876df9a`: _static/0xc96bfb160752606daa0de2fa05eb5792c876df9a.txt
.. __: https://sks-keyservers.net/pks/lookup?op=vindex&search=0xc96bfb160752606daa0de2fa05eb5792c876df9a&fingerprint=on
.. _`key 0x4c8b8b5a694f612544b3b4bac52f01a3fbdb9949`: _static/0x4c8b8b5a694f612544b3b4bac52f01a3fbdb9949.txt
.. __: https://sks-keyservers.net/pks/lookup?op=vindex&search=0x4c8b8b5a694f612544b3b4bac52f01a3fbdb9949&fingerprint=on
.. _`key 0xc31292066be772022438222c184fd3e1edf21a78`: _static/0xc31292066be772022438222c184fd3e1edf21a78.txt
.. __: https://sks-keyservers.net/pks/lookup?op=vindex&search=0xc31292066be772022438222c184fd3e1edf21a78&fingerprint=on
.. _`centrally-managed OpenPGP keys`: https://docs.openstack.org/infra/system-config/signing.html
.. _`OpenStack Infrastructure team`: https://governance.openstack.org/tc/reference/projects/infrastructure.html
References
==========
.. toctree::
:maxdepth: 2
:glob:
reference/*