releases/doc/source/index.rst
Doug Hellmann 4e45a9169f update sphinxcontrib-datatemplates to avoid build warnings
Update the dependency on sphinxcontrib.datatemplates to be
sphinxcontrib-datatemplates>=0.4.0 to ensure the new version
installs (I have no idea why the - works but . does not, thanks pip!)
so we have the new directives and can remove the use of the deprecated
directive form.

Change-Id: Icf3f15111254fc37f0843f84b001f054d7c8fcbf
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2019-06-13 10:24:17 -04:00

142 lines
5.3 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:yaml::
:source: series_status.yaml
:template: series_status_table.tmpl
.. toctree::
:glob:
:maxdepth: 1
:hidden:
train/index
stein/index
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..2018-09-05 (Rocky Cycle key):
`key 0xc31292066be772022438222c184fd3e1edf21a78`_ (details__)
* 2018-09-05..2019-06-11 (Stein Cycle key):
`key 0x27023b1ffccd8e3ae9a5ce95d943d5d270273ada`_ (details__)
* 2019-06-11..present (Train Cycle key):
`key 0xcdc08088c3cb45a9be08332b2354069e5b504663`_ (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
.. _`key 0x27023b1ffccd8e3ae9a5ce95d943d5d270273ada`: _static/0x27023b1ffccd8e3ae9a5ce95d943d5d270273ada.txt
.. __: https://sks-keyservers.net/pks/lookup?op=vindex&search=0x27023b1ffccd8e3ae9a5ce95d943d5d270273ada&fingerprint=on
.. _`key 0xcdc08088c3cb45a9be08332b2354069e5b504663`: _static/0xcdc08088c3cb45a9be08332b2354069e5b504663.txt
.. __: https://sks-keyservers.net/pks/lookup?op=vindex&search=0xcdc08088c3cb45a9be08332b2354069e5b504663&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/using
reference/release_models
reference/deliverable_types
reference/reviewer_guide
reference/process