releases/doc/source/index.rst
Elod Illes dd195342ca Update series statuses
- Train and Ussuri will transition to End of Life
- The last 3 series in Extended Maintenance will transition to
  Unmaintained (Xena, Wallaby, Victoria)
- Yoga is now Unmaintained
- Zed and newer branches will transition to Unmaintained after their
  3rd subsequent series is officially released (~18 months)

This patch also:
- extends the note about the maintenance phases
- refines Zed's planned transition date to Unmaintained to a less busy
  date, ~1 month after the official 2024.1 Caracal release

Change-Id: I860f5056a5563c1e8377dfc7d4f9c31f28912e3c
2024-02-09 12:20:07 +01:00

208 lines
8.0 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:
dalmatian/index
caracal/index
bobcat/index
antelope/index
zed/index
yoga/index
xena/index
wallaby/index
victoria/index
ussuri/index
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
and also during 2024.1 Caracal.
The `old phases`_ were used until Newton.
The last series that transitioned to Extended Maintenance was Xena.
The replacement of Extended Maintenance process to Unmaintained
was formulated in the `2023-07-24 Unmaintained status replaces
Extended Maintenance`_ resolution.
.. _extended-maintenance-note:
.. note::
If a branch is marked as Extended Maintenance, that means individual
projects can be in state *Maintained*, *Unmaintained*, *Last* or
*End of Life* on that branch. Please check specific project about its
actual status on the given branch.
.. _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
.. _2023-07-24 Unmaintained status replaces Extended Maintenance: https://governance.openstack.org/tc/resolutions/20230724-unmaintained-branches.html
Series-Independent Releases
===========================
Some deliverables are released independently from the OpenStack release series.
You can find their releases listed here:
.. toctree::
:maxdepth: 1
independent
.. _slurp:
Releases with Skip Level Upgrade Release Process (SLURP)
========================================================
Releases can be marked as `Skip Level Upgrade Release Process`_ (or
`SLURP`) releases. This practically means, that upgrades will be
supported between these (`SLURP`) releases, in addition to between
adjacent major releases.
.. _Skip Level Upgrade Release Process: https://governance.openstack.org/tc/resolutions/20220210-release-cadence-adjustment.html
Teams
=====
Deliverables are produced by `project teams`_. Here you can find all OpenStack
deliverables, organized by the team that produces them:
.. toctree::
:maxdepth: 1
:glob:
teams/*
.. _project teams: https://governance.openstack.org/tc/reference/projects/index.html
Cryptographic Signatures
========================
Git tags created through our release automation are signed by
`centrally-managed OpenPGP keys`_ maintained by the `OpenStack
TaCT SIG`_. 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.) 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`_
* 2016-11-22..2017-03-24 (Ocata Cycle key):
`key 0xd47bab1b7dc2e262a4f6171e8b1b03fd54e2ac07`_
* 2017-03-24..2017-09-15 (Pike Cycle key):
`key 0xc96bfb160752606daa0de2fa05eb5792c876df9a`_
* 2017-09-15..2018-03-19 (Queens Cycle key):
`key 0x4c8b8b5a694f612544b3b4bac52f01a3fbdb9949`_
* 2018-03-19..2018-09-05 (Rocky Cycle key):
`key 0xc31292066be772022438222c184fd3e1edf21a78`_
* 2018-09-05..2019-06-11 (Stein Cycle key):
`key 0x27023b1ffccd8e3ae9a5ce95d943d5d270273ada`_
* 2019-06-11..2019-10-29 (Train Cycle key):
`key 0xcdc08088c3cb45a9be08332b2354069e5b504663`_
* 2019-10-29..2020-05-21 (Ussuri Cycle key):
`key 0xbba3b1e67a7303dd1769d34595bf2e4d09004514`_
* 2020-05-21..2020-10-30 (Victoria Cycle key):
`key 0x2426b928085a020d8a90d0d879ab7008d0896c8a`_
* 2020-10-30..2021-05-06 (Wallaby Cycle key):
`key 0x5d2d1e4fb8d38e6af76c50d53d4fec30cf5ce3da`_
* 2021-05-06..2021-10-27 (Xena Cycle key):
`key 0x4c29ff0e437f3351fd82bdf47c5a3bc787dc7035`_
* 2021-10-27..2022-04-09 (Yoga Cycle key):
`key 0x01527a34f0d0080f8a5db8d6eb6c5df21b4b6363`_
* 2022-04-09..2022-10-07 (Zed Cycle key):
`key 0xa63ea142678138d1bb15f2e303bdfd64dd164087`_
* 2022-10-07..2023-03-31 (2023.1/Antelope Cycle key):
`key 0xa7475c5f2122fec3f90343223fe3bf5aad1080e4`_
* 2023-03-31..2023-10-09 (2023.2/Bobcat Cycle key):
`key 0x815afec729392386480e076dcc0dfe2d21c023c9`_
* 2023-10-09..present (2024.1/Caracal Cycle key):
`key 0x2ef3fe0ec2b075ab7458b5f8b702b20b13df2318`_
.. Static key files are generated with the following command:
( gpg --fingerprint --keyid-format=0xlong \
--list-options=no-show-uid-validity --list-sigs \
0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28 ; gpg \
--armor --export 0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28 ) > \
doc/source/static/0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28.txt
.. _`key 0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28`: _static/0x80fcce3dc49bd7836fc2464664dbb05acc5e7c28.txt
.. _`key 0xd47bab1b7dc2e262a4f6171e8b1b03fd54e2ac07`: _static/0xd47bab1b7dc2e262a4f6171e8b1b03fd54e2ac07.txt
.. _`key 0xc96bfb160752606daa0de2fa05eb5792c876df9a`: _static/0xc96bfb160752606daa0de2fa05eb5792c876df9a.txt
.. _`key 0x4c8b8b5a694f612544b3b4bac52f01a3fbdb9949`: _static/0x4c8b8b5a694f612544b3b4bac52f01a3fbdb9949.txt
.. _`key 0xc31292066be772022438222c184fd3e1edf21a78`: _static/0xc31292066be772022438222c184fd3e1edf21a78.txt
.. _`key 0x27023b1ffccd8e3ae9a5ce95d943d5d270273ada`: _static/0x27023b1ffccd8e3ae9a5ce95d943d5d270273ada.txt
.. _`key 0xcdc08088c3cb45a9be08332b2354069e5b504663`: _static/0xcdc08088c3cb45a9be08332b2354069e5b504663.txt
.. _`key 0xbba3b1e67a7303dd1769d34595bf2e4d09004514`: _static/0xbba3b1e67a7303dd1769d34595bf2e4d09004514.txt
.. _`key 0x2426b928085a020d8a90d0d879ab7008d0896c8a`: _static/0x2426b928085a020d8a90d0d879ab7008d0896c8a.txt
.. _`key 0x5d2d1e4fb8d38e6af76c50d53d4fec30cf5ce3da`: _static/0x5d2d1e4fb8d38e6af76c50d53d4fec30cf5ce3da.txt
.. _`key 0x4c29ff0e437f3351fd82bdf47c5a3bc787dc7035`: _static/0x4c29ff0e437f3351fd82bdf47c5a3bc787dc7035.txt
.. _`key 0x01527a34f0d0080f8a5db8d6eb6c5df21b4b6363`: _static/0x01527a34f0d0080f8a5db8d6eb6c5df21b4b6363.txt
.. _`key 0xa63ea142678138d1bb15f2e303bdfd64dd164087`: _static/0xa63ea142678138d1bb15f2e303bdfd64dd164087.txt
.. _`key 0xa7475c5f2122fec3f90343223fe3bf5aad1080e4`: _static/0xa7475c5f2122fec3f90343223fe3bf5aad1080e4.txt
.. _`key 0x815afec729392386480e076dcc0dfe2d21c023c9`: _static/0x815afec729392386480e076dcc0dfe2d21c023c9.txt
.. _`key 0x2ef3fe0ec2b075ab7458b5f8b702b20b13df2318`: _static/0x2ef3fe0ec2b075ab7458b5f8b702b20b13df2318.txt
.. _`centrally-managed OpenPGP keys`: https://docs.openstack.org/infra/system-config/signing.html
.. _`OpenStack TaCT SIG`: https://governance.openstack.org/sigs/tact-sig.html
Documentation
=============
Content for this site is automatically generated from the data submitted to
the `openstack/releases`_ git repository. You can learn more about this
repository and the release management team processes in the following
documentation:
.. toctree::
:maxdepth: 2
:glob:
reference/using
reference/release_models
reference/deliverable_types
reference/join_release_team
reference/reviewer_guide
reference/release_infra
reference/process
.. _`openstack/releases`: https://opendev.org/openstack/releases