]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/releases: access main releases page from top-level TOC 30598/head
authorNathan Cutler <ncutler@suse.com>
Thu, 26 Sep 2019 15:42:56 +0000 (17:42 +0200)
committerNathan Cutler <ncutler@suse.com>
Fri, 27 Sep 2019 10:49:43 +0000 (12:49 +0200)
Before this commit, one had to go through the releases index to get to the main
releases page. This should be the other way around.

Also, the main releases page should not be called "schedule.rst" - while it
contains a release timeline, that's not its principal purpose. Rename the page
to "general.rst" and move the "Understanding the release cycle" section before
the timeline.

Signed-off-by: Nathan Cutler <ncutler@suse.com>
doc/dev/repo-access.rst
doc/index.rst
doc/install/get-packages.rst
doc/releases/archived-index.rst
doc/releases/general.rst [new file with mode: 0644]
doc/releases/index.rst
doc/releases/schedule.rst [deleted file]

index 8cc1761087ef30b8b3fc872307a64b9f31c61e7c..6a8570a8f7bf1a10112906940fa8425d048e4275 100644 (file)
@@ -6,7 +6,7 @@ Special branches
 
 * ``master``: current tip (integration branch)
 * Release branches (for example ``luminous``) corresponding to the releases
-  listed at :ref:`ceph-releases`
+  listed at :ref:`ceph-releases-index`
 
 Rules
 -----
index 560e8fce8434d0f4e16784e4739e1f7cc08ea79d..09cb6f6a61abbbc6ff2704c4f953ab24427306f0 100644 (file)
@@ -107,5 +107,6 @@ about Ceph, see our `Architecture`_ section.
    dev/internals
    governance
    ceph-volume/index
+   releases/general
    releases/index
    Glossary <glossary>
index c3694dbb8bef81e7572017d7da38a9cc264b79dc..532560d3e3685cf0d3bd321d85116c69ce1507be 100644 (file)
@@ -83,7 +83,7 @@ You may find releases for CentOS/RHEL and others (installed with YUM) at::
 
        https://download.ceph.com/rpm-{release-name}
 
-The major releases of Ceph are summarized at: :ref:`ceph-releases`
+The major releases of Ceph are summarized at: :ref:`ceph-releases-general`
 
 Every second major release is considered Long Term Stable (LTS). Critical
 bugfixes are backported to LTS releases until their retirement. Since retired
index 091481f9d3e6e1d3f862a7005b9c83b590867f0a..0784efa91a785d8dfa7c2746092b90fc0d45f6a5 100644 (file)
@@ -5,6 +5,7 @@ Archived Releases
 .. toctree::
    :maxdepth: 1
 
+   Jewel <jewel>
    Kraken <kraken>
    Infernalis <infernalis>
    Hammer <hammer>
diff --git a/doc/releases/general.rst b/doc/releases/general.rst
new file mode 100644 (file)
index 0000000..3260eda
--- /dev/null
@@ -0,0 +1,270 @@
+.. _ceph-releases-general:
+
+=======================
+Ceph Releases (general)
+=======================
+
+.. toctree::
+    :maxdepth: 1
+
+Active stable releases
+----------------------
+
+.. ceph_releases:: releases.yml
+
+Understanding the release cycle
+-------------------------------
+
+Starting with the Nautilus release (14.2.0), there is a new stable release cycle
+every year, targeting March 1st. Each stable release series will receive a name
+(e.g., 'Mimic') and a major release number (e.g., 13 for Mimic because 'M' is
+the 13th letter of the alphabet).
+
+Releases are named after a species of cephalopod (usually the common
+name, since the latin names are harder to remember or pronounce).
+
+Version numbers have three components, *x.y.z*.  *x* identifies the release
+cycle (e.g., 13 for Mimic).  *y* identifies the release type:
+
+* x.0.z - development releases (for early testers and the brave at heart)
+* x.1.z - release candidates (for test clusters, brave users)
+* x.2.z - stable/bugfix releases (for users)
+
+This versioning convention started with the 9.y.z Infernalis cycle.  Prior to
+that, versions looked with 0.y for development releases and 0.y.z for stable
+series.
+
+Development releases (x.0.z)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Each development release (x.0.z) freezes the master development branch
+and applies `integration and upgrade tests
+<https://github.com/ceph/ceph/tree/master/qa/suites/>`_ before it is released.  Once
+released, there is no effort to backport fixes; developer focus is on
+the next development release which is usually only a few weeks away.
+
+* Development release every 8 to 12 weeks
+* Intended for testing, not production deployments
+* Full integration testing
+* Upgrade testing from the last stable release(s)
+* Every effort is made to allow *offline* upgrades from previous
+  development releases (meaning you can stop all daemons, upgrade, and
+  restart).  No attempt is made to support online rolling upgrades
+  between development releases.  This facilitates deployment of
+  development releases on non-production test clusters without
+  repopulating them with data.
+
+Release candidates (x.1.z)
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+There is a feature release roughly eight (8) weeks prior to the planned
+initial stable release, after which focus shifts to stabilization and
+bug fixes only.
+
+* Release candidate release every 1-2 weeks
+* Intended for final testing and validation of the upcoming stable release
+
+Stable releases (x.2.z)
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Once the initial stable release is made (x.2.0), there are
+semi-regular bug-fix point releases with bug fixes and (occasionally)
+small feature backports.  Bug fixes are accumulated and included in
+the next point release.
+
+* Stable point release every 4 to 6 weeks
+* Intended for production deployments
+* Bug fix backports for two full release cycles.
+* Online, rolling upgrade support and testing from the last two (2)
+  stable release(s) (starting from Luminous).
+* Online, rolling upgrade support and testing from prior stable point
+  releases
+
+For each stable release:
+
+* `Integration and upgrade tests
+  <https://github.com/ceph/ceph/tree/master/qa/suites/>`_ are run on a regular basis
+  and `their results <http://pulpito.ceph.com/>`_ analyzed by Ceph
+  developers.
+* `Issues <http://tracker.ceph.com/projects/ceph/issues?query_id=27>`_
+  fixed in the development branch (master) are scheduled to be backported.
+* When an issue found in the stable release is `reported
+  <http://tracker.ceph.com/projects/ceph/issues/new>`_, it is
+  triaged by Ceph developers.
+* The `stable releases and backport team <http://tracker.ceph.com/projects/ceph-releases/wiki>`_
+  publishes ``point releases`` including fixes that have been backported to the stable release.
+
+Lifetime of stable releases
+---------------------------
+
+The lifetime of a stable release series is calculated to be approximately 24
+months (i.e., two 12 month release cycles) after the month of the first release.
+For example, Mimic (13.2.z) will reach end of life (EOL) shortly after Octopus
+(15.2.0) is released. The lifetime of a release may vary because it depends on
+how quickly the stable releases are published.
+
+In the case of Jewel and Kraken, the lifetime was slightly different than
+described above. Prior to Luminous, only every other stable release was an "LTS"
+release. Therefore,
+
+* Upgrade scenarios "Jewel -> Kraken -> Luminous" and "Jewel -> Luminous" were
+  expected to work.
+* Upgrades from Jewel or Kraken must upgrade to Luminous first before proceeding
+  further (e.g., Kraken -> Luminous -> Mimic but not Kraken -> Mimic).
+* Jewel was maintained until Mimic was released (June 2018).
+* Kraken is no longer maintained.
+
+Detailed information on all releases, past and present, can be found at :ref:`ceph-releases-index`
+
+Release timeline
+----------------
+
+.. ceph_timeline:: releases.yml development nautilus mimic luminous kraken jewel infernalis hammer giant firefly emperor
+
+.. _Nautilus: ../nautilus
+.. _14.2.4: ../nautilus#v14-2-4-nautilus
+.. _14.2.3: ../nautilus#v14-2-3-nautilus
+.. _14.2.2: ../nautilus#v14-2-2-nautilus
+.. _14.2.1: ../nautilus#v14-2-1-nautilus
+.. _14.2.0: ../nautilus#v14-2-0-nautilus
+
+.. _Mimic: ../mimic
+.. _13.2.6: ../mimic#v13-2-6-mimic
+.. _13.2.5: ../mimic#v13-2-5-mimic
+.. _13.2.4: ../mimic#v13-2-4-mimic
+.. _13.2.3: ../mimic#v13-2-3-mimic
+.. _13.2.2: ../mimic#v13-2-2-mimic
+.. _13.2.1: ../mimic#v13-2-1-mimic
+.. _13.2.0: ../mimic#v13-2-0-mimic
+
+.. _Luminous: ../luminous
+.. _12.2.12: ../luminous#v12-2-12-luminous
+.. _12.2.11: ../luminous#v12-2-11-luminous
+.. _12.2.10: ../luminous#v12-2-10-luminous
+.. _12.2.9: ../luminous#v12-2-9-luminous
+.. _12.2.8: ../luminous#v12-2-8-luminous
+.. _12.2.7: ../luminous#v12-2-7-luminous
+.. _12.2.6: ../luminous#v12-2-6-luminous
+.. _12.2.5: ../luminous#v12-2-5-luminous
+.. _12.2.4: ../luminous#v12-2-4-luminous
+.. _12.2.3: ../luminous#v12-2-3-luminous
+.. _12.2.2: ../luminous#v12-2-2-luminous
+.. _12.2.1: ../luminous#v12-2-1-luminous
+.. _12.2.0: ../luminous#v12-2-0-luminous
+
+.. _11.2.1: ../kraken#v11-2-1-kraken
+.. _11.2.0: ../kraken#v11-2-0-kraken
+.. _Kraken: ../kraken#v11-2-0-kraken
+
+.. _11.0.2: ../kraken#v11-0-2-kraken
+
+.. _10.2.11: ../jewel#v10-2-11-jewel
+.. _10.2.10: ../jewel#v10-2-10-jewel
+.. _10.2.9: ../jewel#v10-2-9-jewel
+.. _10.2.8: ../jewel#v10-2-8-jewel
+.. _10.2.7: ../jewel#v10-2-7-jewel
+.. _10.2.6: ../jewel#v10-2-6-jewel
+.. _10.2.5: ../jewel#v10-2-5-jewel
+.. _10.2.4: ../jewel#v10-2-4-jewel
+.. _10.2.3: ../jewel#v10-2-3-jewel
+.. _10.2.2: ../jewel#v10-2-2-jewel
+.. _10.2.1: ../jewel#v10-2-1-jewel
+.. _10.2.0: ../jewel#v10-2-0-jewel
+.. _Jewel: ../jewel#v10-2-0-jewel
+
+.. _10.1.2: ../jewel#v10-1-2-jewel-release-candidate
+.. _10.1.1: ../jewel#v10-1-1-jewel-release-candidate
+.. _10.1.0: ../jewel#v10-1-0-jewel-release-candidate
+.. _10.0.5: ../jewel#v10-0-5
+.. _10.0.3: ../jewel#v10-0-3
+.. _10.0.2: ../jewel#v10-0-2
+.. _10.0.1: ../jewel#v10-0-1
+.. _10.0.0: ../jewel#v10-0-0
+
+.. _9.2.1: ../infernalis#v9-2-1-infernalis
+.. _9.2.0: ../infernalis#v9-2-0-infernalis
+.. _Infernalis: ../infernalis#v9-2-0-infernalis
+
+.. _9.1.0: ../infernalis#v9-1-0
+.. _9.0.3: ../infernalis#v9-0-3
+.. _9.0.2: ../infernalis#v9-0-2
+.. _9.0.1: ../infernalis#v9-0-1
+.. _9.0.0: ../infernalis#v9-0-0
+
+.. _0.94.10: ../hammer#v0-94-10-hammer
+.. _0.94.9: ../hammer#v0-94-9-hammer
+.. _0.94.8: ../hammer#v0-94-8-hammer
+.. _0.94.7: ../hammer#v0-94-7-hammer
+.. _0.94.6: ../hammer#v0-94-6-hammer
+.. _0.94.5: ../hammer#v0-94-5-hammer
+.. _0.94.4: ../hammer#v0-94-4-hammer
+.. _0.94.3: ../hammer#v0-94-3-hammer
+.. _0.94.2: ../hammer#v0-94-2-hammer
+.. _0.94.1: ../hammer#v0-94-1-hammer
+.. _0.94: ../hammer#v0-94-hammer
+.. _Hammer: ../hammer#v0-94-hammer
+
+.. _0.93: ../hammer#v0-93
+.. _0.92: ../hammer#v0-92
+.. _0.91: ../hammer#v0-91
+.. _0.90: ../hammer#v0-90
+.. _0.89: ../hammer#v0-89
+.. _0.88: ../hammer#v0-88
+
+.. _0.87.2: ../giant#v0-87-2-giant
+.. _0.87.1: ../giant#v0-87-1-giant
+.. _0.87: ../giant#v0-87-giant
+.. _Giant: ../giant#v0-87-giant
+
+.. _0.86: ../giant#v0-86
+.. _0.85: ../giant#v0-85
+.. _0.84: ../giant#v0-84
+.. _0.83: ../giant#v0-83
+.. _0.82: ../giant#v0-82
+.. _0.81: ../giant#v0-81
+
+.. _0.80.11: ../firefly#v0-80-11-firefly
+.. _0.80.10: ../firefly#v0-80-10-firefly
+.. _0.80.9: ../firefly#v0-80-9-firefly
+.. _0.80.8: ../firefly#v0-80-8-firefly
+.. _0.80.7: ../firefly#v0-80-7-firefly
+.. _0.80.6: ../firefly#v0-80-6-firefly
+.. _0.80.5: ../firefly#v0-80-5-firefly
+.. _0.80.4: ../firefly#v0-80-4-firefly
+.. _0.80.3: ../firefly#v0-80-3-firefly
+.. _0.80.2: ../firefly#v0-80-2-firefly
+.. _0.80.1: ../firefly#v0-80-1-firefly
+.. _0.80: ../firefly#v0-80-firefly
+.. _Firefly: ../firefly#v0-80-firefly
+
+.. _0.79: ../firefly#v0-79
+.. _0.78: ../firefly#v0-78
+.. _0.77: ../firefly#v0-77
+.. _0.76: ../firefly#v0-76
+.. _0.75: ../firefly#v0-75
+.. _0.74: ../firefly#v0-74
+.. _0.73: ../firefly#v0-73
+
+.. _0.72.2: ../emperor#v0-72-2-emperor
+.. _0.72.1: ../emperor#v0-72-1-emperor
+.. _0.72: ../emperor#v0-72-emperor
+.. _Emperor: ../emperor#v0-72-emperor
+
+.. _0.71: ../dumpling#v0-71
+.. _0.70: ../dumpling#v0-70
+.. _0.69: ../dumpling#v0-69
+.. _0.68: ../dumpling#v0-68
+
+.. _0.67.11: ../dumpling#v0-67-11-dumpling
+.. _0.67.10: ../dumpling#v0-67-10-dumpling
+.. _0.67.9: ../dumpling#v0-67-9-dumpling
+.. _0.67.8: ../dumpling#v0-67-8-dumpling
+.. _0.67.7: ../dumpling#v0-67-7-dumpling
+.. _0.67.6: ../dumpling#v0-67-6-dumpling
+.. _0.67.5: ../dumpling#v0-67-5-dumpling
+.. _0.67.4: ../dumpling#v0-67-4-dumpling
+.. _0.67.3: ../dumpling#v0-67-3-dumpling
+.. _0.67.2: ../dumpling#v0-67-2-dumpling
+.. _0.67.1: ../dumpling#v0-67-1-dumpling
+.. _0.67: ../dumpling#v0-67-dumpling
+.. _Dumpling:  ../dumpling#v0-67-dumpling
index 3cedf838ef2544e12f84e8b579c2cfec30f7940e..374dc0a23210816c328a5db4f98866678632c7ac 100644 (file)
@@ -1,20 +1,14 @@
-=============
-Ceph Releases
-=============
+.. _ceph-releases-index:
 
-.. _ceph-releases:
-
-Release Index
--------------
+=====================
+Ceph Releases (index)
+=====================
 
 .. toctree::
    :maxdepth: 1
 
-   Release Schedule <schedule>
-
-
 Active Releases
-~~~~~~~~~~~~~~~
+---------------
 
 .. toctree::
    :maxdepth: 1
@@ -22,10 +16,9 @@ Active Releases
    Nautilus <nautilus>
    Mimic <mimic>
    Luminous <luminous>
-   Jewel <jewel>
 
 Archived Releases
-~~~~~~~~~~~~~~~~~
+-----------------
 
 .. toctree::
    :maxdepth: 1 
diff --git a/doc/releases/schedule.rst b/doc/releases/schedule.rst
deleted file mode 100644 (file)
index ec19c4d..0000000
+++ /dev/null
@@ -1,259 +0,0 @@
-=============
-Ceph Releases
-=============
-
-Current
--------
-
-.. ceph_releases:: releases.yml
-
-Timeline
---------
-
-.. ceph_timeline:: releases.yml development nautilus mimic luminous kraken jewel infernalis hammer giant firefly emperor
-
-.. _Nautilus: ../nautilus
-.. _14.2.4: ../nautilus#v14-2-4-nautilus
-.. _14.2.3: ../nautilus#v14-2-3-nautilus
-.. _14.2.2: ../nautilus#v14-2-2-nautilus
-.. _14.2.1: ../nautilus#v14-2-1-nautilus
-.. _14.2.0: ../nautilus#v14-2-0-nautilus
-
-.. _Mimic: ../mimic
-.. _13.2.6: ../mimic#v13-2-6-mimic
-.. _13.2.5: ../mimic#v13-2-5-mimic
-.. _13.2.4: ../mimic#v13-2-4-mimic
-.. _13.2.3: ../mimic#v13-2-3-mimic
-.. _13.2.2: ../mimic#v13-2-2-mimic
-.. _13.2.1: ../mimic#v13-2-1-mimic
-.. _13.2.0: ../mimic#v13-2-0-mimic
-
-.. _Luminous: ../luminous
-.. _12.2.12: ../luminous#v12-2-12-luminous
-.. _12.2.11: ../luminous#v12-2-11-luminous
-.. _12.2.10: ../luminous#v12-2-10-luminous
-.. _12.2.9: ../luminous#v12-2-9-luminous
-.. _12.2.8: ../luminous#v12-2-8-luminous
-.. _12.2.7: ../luminous#v12-2-7-luminous
-.. _12.2.6: ../luminous#v12-2-6-luminous
-.. _12.2.5: ../luminous#v12-2-5-luminous
-.. _12.2.4: ../luminous#v12-2-4-luminous
-.. _12.2.3: ../luminous#v12-2-3-luminous
-.. _12.2.2: ../luminous#v12-2-2-luminous
-.. _12.2.1: ../luminous#v12-2-1-luminous
-.. _12.2.0: ../luminous#v12-2-0-luminous
-
-.. _11.2.1: ../kraken#v11-2-1-kraken
-.. _11.2.0: ../kraken#v11-2-0-kraken
-.. _Kraken: ../kraken#v11-2-0-kraken
-
-.. _11.0.2: ../kraken#v11-0-2-kraken
-
-.. _10.2.11: ../jewel#v10-2-11-jewel
-.. _10.2.10: ../jewel#v10-2-10-jewel
-.. _10.2.9: ../jewel#v10-2-9-jewel
-.. _10.2.8: ../jewel#v10-2-8-jewel
-.. _10.2.7: ../jewel#v10-2-7-jewel
-.. _10.2.6: ../jewel#v10-2-6-jewel
-.. _10.2.5: ../jewel#v10-2-5-jewel
-.. _10.2.4: ../jewel#v10-2-4-jewel
-.. _10.2.3: ../jewel#v10-2-3-jewel
-.. _10.2.2: ../jewel#v10-2-2-jewel
-.. _10.2.1: ../jewel#v10-2-1-jewel
-.. _10.2.0: ../jewel#v10-2-0-jewel
-.. _Jewel: ../jewel#v10-2-0-jewel
-
-.. _10.1.2: ../jewel#v10-1-2-jewel-release-candidate
-.. _10.1.1: ../jewel#v10-1-1-jewel-release-candidate
-.. _10.1.0: ../jewel#v10-1-0-jewel-release-candidate
-.. _10.0.5: ../jewel#v10-0-5
-.. _10.0.3: ../jewel#v10-0-3
-.. _10.0.2: ../jewel#v10-0-2
-.. _10.0.1: ../jewel#v10-0-1
-.. _10.0.0: ../jewel#v10-0-0
-
-.. _9.2.1: ../infernalis#v9-2-1-infernalis
-.. _9.2.0: ../infernalis#v9-2-0-infernalis
-.. _Infernalis: ../infernalis#v9-2-0-infernalis
-
-.. _9.1.0: ../infernalis#v9-1-0
-.. _9.0.3: ../infernalis#v9-0-3
-.. _9.0.2: ../infernalis#v9-0-2
-.. _9.0.1: ../infernalis#v9-0-1
-.. _9.0.0: ../infernalis#v9-0-0
-
-.. _0.94.10: ../hammer#v0-94-10-hammer
-.. _0.94.9: ../hammer#v0-94-9-hammer
-.. _0.94.8: ../hammer#v0-94-8-hammer
-.. _0.94.7: ../hammer#v0-94-7-hammer
-.. _0.94.6: ../hammer#v0-94-6-hammer
-.. _0.94.5: ../hammer#v0-94-5-hammer
-.. _0.94.4: ../hammer#v0-94-4-hammer
-.. _0.94.3: ../hammer#v0-94-3-hammer
-.. _0.94.2: ../hammer#v0-94-2-hammer
-.. _0.94.1: ../hammer#v0-94-1-hammer
-.. _0.94: ../hammer#v0-94-hammer
-.. _Hammer: ../hammer#v0-94-hammer
-
-.. _0.93: ../hammer#v0-93
-.. _0.92: ../hammer#v0-92
-.. _0.91: ../hammer#v0-91
-.. _0.90: ../hammer#v0-90
-.. _0.89: ../hammer#v0-89
-.. _0.88: ../hammer#v0-88
-
-.. _0.87.2: ../giant#v0-87-2-giant
-.. _0.87.1: ../giant#v0-87-1-giant
-.. _0.87: ../giant#v0-87-giant
-.. _Giant: ../giant#v0-87-giant
-
-.. _0.86: ../giant#v0-86
-.. _0.85: ../giant#v0-85
-.. _0.84: ../giant#v0-84
-.. _0.83: ../giant#v0-83
-.. _0.82: ../giant#v0-82
-.. _0.81: ../giant#v0-81
-
-.. _0.80.11: ../firefly#v0-80-11-firefly
-.. _0.80.10: ../firefly#v0-80-10-firefly
-.. _0.80.9: ../firefly#v0-80-9-firefly
-.. _0.80.8: ../firefly#v0-80-8-firefly
-.. _0.80.7: ../firefly#v0-80-7-firefly
-.. _0.80.6: ../firefly#v0-80-6-firefly
-.. _0.80.5: ../firefly#v0-80-5-firefly
-.. _0.80.4: ../firefly#v0-80-4-firefly
-.. _0.80.3: ../firefly#v0-80-3-firefly
-.. _0.80.2: ../firefly#v0-80-2-firefly
-.. _0.80.1: ../firefly#v0-80-1-firefly
-.. _0.80: ../firefly#v0-80-firefly
-.. _Firefly: ../firefly#v0-80-firefly
-
-.. _0.79: ../firefly#v0-79
-.. _0.78: ../firefly#v0-78
-.. _0.77: ../firefly#v0-77
-.. _0.76: ../firefly#v0-76
-.. _0.75: ../firefly#v0-75
-.. _0.74: ../firefly#v0-74
-.. _0.73: ../firefly#v0-73
-
-.. _0.72.2: ../emperor#v0-72-2-emperor
-.. _0.72.1: ../emperor#v0-72-1-emperor
-.. _0.72: ../emperor#v0-72-emperor
-.. _Emperor: ../emperor#v0-72-emperor
-
-.. _0.71: ../dumpling#v0-71
-.. _0.70: ../dumpling#v0-70
-.. _0.69: ../dumpling#v0-69
-.. _0.68: ../dumpling#v0-68
-
-.. _0.67.11: ../dumpling#v0-67-11-dumpling
-.. _0.67.10: ../dumpling#v0-67-10-dumpling
-.. _0.67.9: ../dumpling#v0-67-9-dumpling
-.. _0.67.8: ../dumpling#v0-67-8-dumpling
-.. _0.67.7: ../dumpling#v0-67-7-dumpling
-.. _0.67.6: ../dumpling#v0-67-6-dumpling
-.. _0.67.5: ../dumpling#v0-67-5-dumpling
-.. _0.67.4: ../dumpling#v0-67-4-dumpling
-.. _0.67.3: ../dumpling#v0-67-3-dumpling
-.. _0.67.2: ../dumpling#v0-67-2-dumpling
-.. _0.67.1: ../dumpling#v0-67-1-dumpling
-.. _0.67: ../dumpling#v0-67-dumpling
-.. _Dumpling:  ../dumpling#v0-67-dumpling
-
-Understanding the release cycle
--------------------------------
-
-There is a new stable release cycle every year, targetting March 1st, starting
-with the Nautilus release (14.2.0).  Each stable release series will
-receive a name (e.g., 'Mimic') and a major release number (e.g., 13
-for Mimic because 'M' is the 13th letter of the alphabet).
-
-Releases are named after a species of cephalopod (usually the common
-name, since the latin names are harder to remember or pronounce).
-
-Version numbers have three components, *x.y.z*.  *x* identifies the release
-cycle (e.g., 13 for Mimic).  *y* identifies the release type:
-
-* x.0.z - development releases (for early testers and the brave at heart)
-* x.1.z - release candidates (for test clusters, brave users)
-* x.2.z - stable/bugfix releases (for users)
-
-This versioning convention started with the 9.y.z Infernalis cycle.  Prior to
-that, versions looked with 0.y for development releases and 0.y.z for stable
-series.
-
-Development releases (x.0.z)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Each development release (x.0.z) freezes the master development branch
-and applies `integration and upgrade tests
-<https://github.com/ceph/ceph/tree/master/qa/suites/>`_ before it is released.  Once
-released, there is no effort to backport fixes; developer focus is on
-the next development release which is usually only a few weeks away.
-
-* Development release every 8 to 12 weeks
-* Intended for testing, not production deployments
-* Full integration testing
-* Upgrade testing from the last stable release(s)
-* Every effort is made to allow *offline* upgrades from previous
-  development releases (meaning you can stop all daemons, upgrade, and
-  restart).  No attempt is made to support online rolling upgrades
-  between development releases.  This facilitates deployment of
-  development releases on non-production test clusters without
-  repopulating them with data.
-
-Release candidates (x.1.z)
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-There is a feature release roughly eight (8) weeks prior to the planned
-initial stable release, after which focus shifts to stabilization and
-bug fixes only.
-
-* Release candidate release every 1-2 weeks
-* Intended for final testing and validation of the upcoming stable release
-
-Stable releases (x.2.z)
-^^^^^^^^^^^^^^^^^^^^^^^
-
-Once the initial stable release is made (x.2.0), there are
-semi-regular bug-fix point releases with bug fixes and (occasionally)
-small feature backports.  Bug fixes are accumulated and included in
-the next point release.
-
-* Stable point release every 4 to 6 weeks
-* Intended for production deployments
-* Bug fix backports for two full release cycles.
-* Online, rolling upgrade support and testing from the last two (2)
-  stable release(s) (starting from Luminous).
-* Online, rolling upgrade support and testing from prior stable point
-  releases
-
-For each stable release:
-
-* `Integration and upgrade tests
-  <https://github.com/ceph/ceph/tree/master/qa/suites/>`_ are run on a regular basis
-  and `their results <http://pulpito.ceph.com/>`_ analyzed by Ceph
-  developers.
-* `Issues <http://tracker.ceph.com/projects/ceph/issues?query_id=27>`_
-  fixed in the development branch (master) are scheduled to be backported.
-* When an issue found in the stable release is `reported
-  <http://tracker.ceph.com/projects/ceph/issues/new>`_, it is
-  triaged by Ceph developers.
-* The `stable releases and backport team <http://tracker.ceph.com/projects/ceph-releases/wiki>`_
-  publishes ``point releases`` including fixes that have been backported to the stable release.
-
-In the timeline above, the life time of a stable release series is
-calculated to be approximately 24 months (i.e., two 12 month release
-cycles) after the month of the first release.  For example, Mimic
-(13.2.z) will reach end of life (EOL) shortly after Octopus (15.2.0) is
-released.  The lifetime of a release may vary because it depends on how
-quickly the stable releases are published.
-
-The life time for Jewel and Kraken are slightly different.  Prior to
-Luminous, only every other stable release was an "LTS" release.
-Therefore,
-
-* Upgrades are supported from Jewel -> Kraken -> Luminous and Jewel -> Luminous.
-* Upgrades from Jewel or Kraken must upgrade to Luminous first before proceeding further (e.g., Kraken -> Luminous -> Mimic but not Kraken -> Mimic).
-* Jewel will be maintained until Mimic is released in the spring of 2018.
-* Kraken is no longer maintained.