ceph/doc/releases/general.rst

   1 .. _ceph-releases-general:
   2
   3 =======================
   4 Ceph Releases (general)
   5 =======================
   6
   7 .. toctree::
   8     :maxdepth: 1
   9
  10 Active stable releases
  11 ----------------------
  12
  13 .. ceph_releases:: releases.yml
  14
  15 Understanding the release cycle
  16 -------------------------------
  17
  18 Starting with the Nautilus release (14.2.0), there is a new stable release cycle
  19 every year, targeting March 1st. Each stable release series will receive a name
  20 (e.g., 'Mimic') and a major release number (e.g., 13 for Mimic because 'M' is
  21 the 13th letter of the alphabet).
  22
  23 Releases are named after a species of cephalopod (usually the common
  24 name, since the latin names are harder to remember or pronounce).
  25
  26 Version numbers have three components, *x.y.z*.  *x* identifies the release
  27 cycle (e.g., 13 for Mimic).  *y* identifies the release type:
  28
  29 * x.0.z - development releases (for early testers and the brave at heart)
  30 * x.1.z - release candidates (for test clusters, brave users)
  31 * x.2.z - stable/bugfix releases (for users)
  32
  33 This versioning convention started with the 9.y.z Infernalis cycle.  Prior to
  34 that, versions looked with 0.y for development releases and 0.y.z for stable
  35 series.
  36
  37 Development releases (x.0.z)
  38 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  39
  40 Each development release (x.0.z) freezes the master development branch
  41 and applies `integration and upgrade tests
  42 <https://github.com/ceph/ceph/tree/master/qa/suites/>`_ before it is released.  Once
  43 released, there is no effort to backport fixes; developer focus is on
  44 the next development release which is usually only a few weeks away.
  45
  46 * Development release every 8 to 12 weeks
  47 * Intended for testing, not production deployments
  48 * Full integration testing
  49 * Upgrade testing from the last stable release(s)
  50 * Every effort is made to allow *offline* upgrades from previous
  51   development releases (meaning you can stop all daemons, upgrade, and
  52   restart).  No attempt is made to support online rolling upgrades
  53   between development releases.  This facilitates deployment of
  54   development releases on non-production test clusters without
  55   repopulating them with data.
  56
  57 Release candidates (x.1.z)
  58 ^^^^^^^^^^^^^^^^^^^^^^^^^^
  59
  60 There is a feature release roughly eight (8) weeks prior to the planned
  61 initial stable release, after which focus shifts to stabilization and
  62 bug fixes only.
  63
  64 * Release candidate release every 1-2 weeks
  65 * Intended for final testing and validation of the upcoming stable release
  66
  67 Stable releases (x.2.z)
  68 ^^^^^^^^^^^^^^^^^^^^^^^
  69
  70 Once the initial stable release is made (x.2.0), there are
  71 semi-regular bug-fix point releases with bug fixes and (occasionally)
  72 small feature backports.  Bug fixes are accumulated and included in
  73 the next point release.
  74
  75 * Stable point release every 4 to 6 weeks
  76 * Intended for production deployments
  77 * Bug fix backports for two full release cycles.
  78 * Online, rolling upgrade support and testing from the last two (2)
  79   stable release(s) (starting from Luminous).
  80 * Online, rolling upgrade support and testing from prior stable point
  81   releases
  82
  83 For each stable release:
  84
  85 * `Integration and upgrade tests
  86   <https://github.com/ceph/ceph/tree/master/qa/suites/>`_ are run on a regular basis
  87   and `their results <http://pulpito.ceph.com/>`_ analyzed by Ceph
  88   developers.
  89 * `Issues <http://tracker.ceph.com/projects/ceph/issues?query_id=27>`_
  90   fixed in the development branch (master) are scheduled to be backported.
  91 * When an issue found in the stable release is `reported
  92   <http://tracker.ceph.com/projects/ceph/issues/new>`_, it is
  93   triaged by Ceph developers.
  94 * The `stable releases and backport team <http://tracker.ceph.com/projects/ceph-releases/wiki>`_
  95   publishes ``point releases`` including fixes that have been backported to the stable release.
  96
  97 Lifetime of stable releases
  98 ---------------------------
  99
 100 The lifetime of a stable release series is calculated to be approximately 24
 101 months (i.e., two 12 month release cycles) after the month of the first release.
 102 For example, Mimic (13.2.z) will reach end of life (EOL) shortly after Octopus
 103 (15.2.0) is released. The lifetime of a release may vary because it depends on
 104 how quickly the stable releases are published.
 105
 106 In the case of Jewel and Kraken, the lifetime was slightly different than
 107 described above. Prior to Luminous, only every other stable release was an "LTS"
 108 release. Therefore,
 109
 110 * Upgrade scenarios "Jewel -> Kraken -> Luminous" and "Jewel -> Luminous" were
 111   expected to work.
 112 * Upgrades from Jewel or Kraken must upgrade to Luminous first before proceeding
 113   further (e.g., Kraken -> Luminous -> Mimic but not Kraken -> Mimic).
 114 * Jewel was maintained until Mimic was released (June 2018).
 115 * Kraken is no longer maintained.
 116
 117 Detailed information on all releases, past and present, can be found at :ref:`ceph-releases-index`
 118
 119 Release timeline
 120 ----------------
 121
 122 .. ceph_timeline:: releases.yml development nautilus mimic luminous kraken jewel infernalis hammer giant firefly emperor
 123
 124 .. _Octopus: ../octopus
 125 .. _15.1.0: ../octopus#v15-1-0-octopus
 126
 127 .. _Nautilus: ../nautilus
 128 .. _14.2.8: ../nautilus#v14-2-8-nautilus
 129 .. _14.2.7: ../nautilus#v14-2-7-nautilus
 130 .. _14.2.6: ../nautilus#v14-2-6-nautilus
 131 .. _14.2.5: ../nautilus#v14-2-5-nautilus
 132 .. _14.2.4: ../nautilus#v14-2-4-nautilus
 133 .. _14.2.3: ../nautilus#v14-2-3-nautilus
 134 .. _14.2.2: ../nautilus#v14-2-2-nautilus
 135 .. _14.2.1: ../nautilus#v14-2-1-nautilus
 136 .. _14.2.0: ../nautilus#v14-2-0-nautilus
 137
 138 .. _Mimic: ../mimic
 139 .. _13.2.8: ../mimic#v13-2-8-mimic
 140 .. _13.2.7: ../mimic#v13-2-7-mimic
 141 .. _13.2.6: ../mimic#v13-2-6-mimic
 142 .. _13.2.5: ../mimic#v13-2-5-mimic
 143 .. _13.2.4: ../mimic#v13-2-4-mimic
 144 .. _13.2.3: ../mimic#v13-2-3-mimic
 145 .. _13.2.2: ../mimic#v13-2-2-mimic
 146 .. _13.2.1: ../mimic#v13-2-1-mimic
 147 .. _13.2.0: ../mimic#v13-2-0-mimic
 148
 149 .. _Luminous: ../luminous
 150 .. _12.2.13: ../luminous#v12-2-13-luminous
 151 .. _12.2.12: ../luminous#v12-2-12-luminous
 152 .. _12.2.11: ../luminous#v12-2-11-luminous
 153 .. _12.2.10: ../luminous#v12-2-10-luminous
 154 .. _12.2.9: ../luminous#v12-2-9-luminous
 155 .. _12.2.8: ../luminous#v12-2-8-luminous
 156 .. _12.2.7: ../luminous#v12-2-7-luminous
 157 .. _12.2.6: ../luminous#v12-2-6-luminous
 158 .. _12.2.5: ../luminous#v12-2-5-luminous
 159 .. _12.2.4: ../luminous#v12-2-4-luminous
 160 .. _12.2.3: ../luminous#v12-2-3-luminous
 161 .. _12.2.2: ../luminous#v12-2-2-luminous
 162 .. _12.2.1: ../luminous#v12-2-1-luminous
 163 .. _12.2.0: ../luminous#v12-2-0-luminous
 164
 165 .. _11.2.1: ../kraken#v11-2-1-kraken
 166 .. _11.2.0: ../kraken#v11-2-0-kraken
 167 .. _Kraken: ../kraken#v11-2-0-kraken
 168
 169 .. _11.0.2: ../kraken#v11-0-2-kraken
 170
 171 .. _10.2.11: ../jewel#v10-2-11-jewel
 172 .. _10.2.10: ../jewel#v10-2-10-jewel
 173 .. _10.2.9: ../jewel#v10-2-9-jewel
 174 .. _10.2.8: ../jewel#v10-2-8-jewel
 175 .. _10.2.7: ../jewel#v10-2-7-jewel
 176 .. _10.2.6: ../jewel#v10-2-6-jewel
 177 .. _10.2.5: ../jewel#v10-2-5-jewel
 178 .. _10.2.4: ../jewel#v10-2-4-jewel
 179 .. _10.2.3: ../jewel#v10-2-3-jewel
 180 .. _10.2.2: ../jewel#v10-2-2-jewel
 181 .. _10.2.1: ../jewel#v10-2-1-jewel
 182 .. _10.2.0: ../jewel#v10-2-0-jewel
 183 .. _Jewel: ../jewel#v10-2-0-jewel
 184
 185 .. _10.1.2: ../jewel#v10-1-2-jewel-release-candidate
 186 .. _10.1.1: ../jewel#v10-1-1-jewel-release-candidate
 187 .. _10.1.0: ../jewel#v10-1-0-jewel-release-candidate
 188 .. _10.0.5: ../jewel#v10-0-5
 189 .. _10.0.3: ../jewel#v10-0-3
 190 .. _10.0.2: ../jewel#v10-0-2
 191 .. _10.0.1: ../jewel#v10-0-1
 192 .. _10.0.0: ../jewel#v10-0-0
 193
 194 .. _9.2.1: ../infernalis#v9-2-1-infernalis
 195 .. _9.2.0: ../infernalis#v9-2-0-infernalis
 196 .. _Infernalis: ../infernalis#v9-2-0-infernalis
 197
 198 .. _9.1.0: ../infernalis#v9-1-0
 199 .. _9.0.3: ../infernalis#v9-0-3
 200 .. _9.0.2: ../infernalis#v9-0-2
 201 .. _9.0.1: ../infernalis#v9-0-1
 202 .. _9.0.0: ../infernalis#v9-0-0
 203
 204 .. _0.94.10: ../hammer#v0-94-10-hammer
 205 .. _0.94.9: ../hammer#v0-94-9-hammer
 206 .. _0.94.8: ../hammer#v0-94-8-hammer
 207 .. _0.94.7: ../hammer#v0-94-7-hammer
 208 .. _0.94.6: ../hammer#v0-94-6-hammer
 209 .. _0.94.5: ../hammer#v0-94-5-hammer
 210 .. _0.94.4: ../hammer#v0-94-4-hammer
 211 .. _0.94.3: ../hammer#v0-94-3-hammer
 212 .. _0.94.2: ../hammer#v0-94-2-hammer
 213 .. _0.94.1: ../hammer#v0-94-1-hammer
 214 .. _0.94: ../hammer#v0-94-hammer
 215 .. _Hammer: ../hammer#v0-94-hammer
 216
 217 .. _0.93: ../hammer#v0-93
 218 .. _0.92: ../hammer#v0-92
 219 .. _0.91: ../hammer#v0-91
 220 .. _0.90: ../hammer#v0-90
 221 .. _0.89: ../hammer#v0-89
 222 .. _0.88: ../hammer#v0-88
 223
 224 .. _0.87.2: ../giant#v0-87-2-giant
 225 .. _0.87.1: ../giant#v0-87-1-giant
 226 .. _0.87: ../giant#v0-87-giant
 227 .. _Giant: ../giant#v0-87-giant
 228
 229 .. _0.86: ../giant#v0-86
 230 .. _0.85: ../giant#v0-85
 231 .. _0.84: ../giant#v0-84
 232 .. _0.83: ../giant#v0-83
 233 .. _0.82: ../giant#v0-82
 234 .. _0.81: ../giant#v0-81
 235
 236 .. _0.80.11: ../firefly#v0-80-11-firefly
 237 .. _0.80.10: ../firefly#v0-80-10-firefly
 238 .. _0.80.9: ../firefly#v0-80-9-firefly
 239 .. _0.80.8: ../firefly#v0-80-8-firefly
 240 .. _0.80.7: ../firefly#v0-80-7-firefly
 241 .. _0.80.6: ../firefly#v0-80-6-firefly
 242 .. _0.80.5: ../firefly#v0-80-5-firefly
 243 .. _0.80.4: ../firefly#v0-80-4-firefly
 244 .. _0.80.3: ../firefly#v0-80-3-firefly
 245 .. _0.80.2: ../firefly#v0-80-2-firefly
 246 .. _0.80.1: ../firefly#v0-80-1-firefly
 247 .. _0.80: ../firefly#v0-80-firefly
 248 .. _Firefly: ../firefly#v0-80-firefly
 249
 250 .. _0.79: ../firefly#v0-79
 251 .. _0.78: ../firefly#v0-78
 252 .. _0.77: ../firefly#v0-77
 253 .. _0.76: ../firefly#v0-76
 254 .. _0.75: ../firefly#v0-75
 255 .. _0.74: ../firefly#v0-74
 256 .. _0.73: ../firefly#v0-73
 257
 258 .. _0.72.2: ../emperor#v0-72-2-emperor
 259 .. _0.72.1: ../emperor#v0-72-1-emperor
 260 .. _0.72: ../emperor#v0-72-emperor
 261 .. _Emperor: ../emperor#v0-72-emperor
 262
 263 .. _0.71: ../dumpling#v0-71
 264 .. _0.70: ../dumpling#v0-70
 265 .. _0.69: ../dumpling#v0-69
 266 .. _0.68: ../dumpling#v0-68
 267
 268 .. _0.67.11: ../dumpling#v0-67-11-dumpling
 269 .. _0.67.10: ../dumpling#v0-67-10-dumpling
 270 .. _0.67.9: ../dumpling#v0-67-9-dumpling
 271 .. _0.67.8: ../dumpling#v0-67-8-dumpling
 272 .. _0.67.7: ../dumpling#v0-67-7-dumpling
 273 .. _0.67.6: ../dumpling#v0-67-6-dumpling
 274 .. _0.67.5: ../dumpling#v0-67-5-dumpling
 275 .. _0.67.4: ../dumpling#v0-67-4-dumpling
 276 .. _0.67.3: ../dumpling#v0-67-3-dumpling
 277 .. _0.67.2: ../dumpling#v0-67-2-dumpling
 278 .. _0.67.1: ../dumpling#v0-67-1-dumpling
 279 .. _0.67: ../dumpling#v0-67-dumpling
 280 .. _Dumpling:  ../dumpling#v0-67-dumpling