ceph/doc/releases.rst

   1 =============
   2 Ceph Releases
   3 =============
   4
   5 Timeline
   6 --------
   7
   8 +----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
   9 |                            |`Dumpling`_|`Emperor`_ |`Firefly`_ |`Giant`_   |`Hammer`_  |`Infernalis`_ |`Jewel`_   |`Kraken`_  |
  10 |                            |LTS        |Stable     |LTS        |Stable     |LTS        |Stable        |LTS        |Stable     |
  11 +----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  12 |     First release          | August    | November  | May       | October   | April     | November     | April     | January   |
  13 |                            | 2013      | 2013      | 2014      | 2014      | 2015      | 2015         | 2016      | 2017      |
  14 +----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  15 |  Estimated retirement      | March     |           | January   |           | May       |              | November  |           |
  16 |                            | 2015      |           | 2016      |           | 2017      |              | 2017      |           |
  17 +----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  18 |    Actual retirement       | May       | May       | April     | April     |           | April 2016   |           |           |
  19 |                            | 2015      | 2014      | 2016      | 2015      |           |              |           |           |
  20 +----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  21
  22 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  23 |                |Development|`Dumpling`_|`Emperor`_ |`Firefly`_ |`Giant`_   |`Hammer`_  |`Infernalis`_ |`Jewel`_   |`Kraken`   |
  24 |                |Testing    |LTS        |Stable     |LTS        |Stable     |LTS        |Stable        |LTS        |Stable     |
  25 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  26 | February  2017 | `12.0.0`_ |           |           |           |           |`0.94.10`_ |              |           |           |
  27 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  28 | January   2017 |           |           |           |           |           |           |              |           |`11.2.0`_  |
  29 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  30 | December  2016 |           |           |           |           |           |           |              |`10.2.5`_  |           |
  31 +                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  32 |                |           |           |           |           |           |           |              |`10.2.4`_  |           |
  33 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  34 | October   2016 |           |           |           |           |           |           |              |           |`11.0.2`_  |
  35 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  36 | September 2016 |           |           |           |           |           |           |              |`10.2.3`_  |           |
  37 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  38 | August    2016 |           |           |           |           |           |`0.94.9`_  |              |           |           |
  39 +                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  40 |                |           |           |           |           |           |`0.94.8`_  |              |           |           |
  41 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  42 | June      2016 | 11.0.0    |           |           |           |           |           |              |`10.2.2`_  |           |
  43 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  44 | May       2016 |           |           |           |           |           |`0.94.7`_  |              |`10.2.1`_  |           |
  45 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  46 | April     2016 |`10.1.2`_  |           |           |           |           |           |              |`10.2.0`_  |           |
  47 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  48 |                |`10.1.1`_  |           |           |           |           |           |              |           |           |
  49 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  50 | March     2016 |`10.1.0`_  |           |           |           |           |           |              |           |           |
  51 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  52 |                |`10.0.5`_  |           |           |           |           |           |              |           |           |
  53 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  54 | February  2016 |`10.0.3`_  |           |           |           |           |`0.94.6`_  |`9.2.1`_      |           |           |
  55 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  56 | January   2016 |`10.0.2`_  |           |           |           |           |           |              |           |           |
  57 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  58 | December  2015 |`10.0.1`_  |           |           |           |           |           |              |           |           |
  59 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  60 | November  2015 |`10.0.0`_  |           |           |`0.80.11`_ |           |           |`9.2.0`_      |           |           |
  61 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  62 | October   2015 |`9.1.0`_   |           |           |           |           |`0.94.5`_  |              |           |           |
  63 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  64 |                |           |           |           |           |           |`0.94.4`_  |              |           |           |
  65 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  66 | August    2015 |`9.0.3`_   |           |           |           |           |`0.94.3`_  |              |           |           |
  67 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  68 | July      2015 |`9.0.2`_   |           |           |`0.80.10`_ |           |           |              |           |           |
  69 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  70 | June      2015 |`9.0.1`_   |           |           |           |           |`0.94.2`_  |              |           |           |
  71 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  72 | May       2015 |`9.0.0`_   |           |           |           |           |           |              |           |           |
  73 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  74 | April     2015 |           |           |           |           |`0.87.2`_  |`0.94.1`_  |              |           |           |
  75 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  76 |                |           |           |           |           |           |`0.94`_    |              |           |           |
  77 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  78 | March     2015 |           |           |           |`0.80.9`_  |           |           |              |           |           |
  79 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  80 | February  2015 |`0.93`_    |           |           |           |`0.87.1`_  |           |              |           |           |
  81 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  82 |                |`0.92`_    |           |           |           |           |           |              |           |           |
  83 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  84 | January   2015 |`0.91`_    |           |           |`0.80.8`_  |           |           |              |           |           |
  85 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  86 | December  2014 |`0.90`_    |           |           |           |           |           |              |           |           |
  87 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  88 |                |`0.89`_    |           |           |           |           |           |              |           |           |
  89 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  90 | November  2014 |`0.88`_    |           |           |           |           |           |              |           |           |
  91 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  92 | October   2014 |`0.86`_    |           |           |`0.80.7`_  |`0.87`_    |           |              |           |           |
  93 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  94 |                |           |           |           |`0.80.6`_  |           |           |              |           |           |
  95 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  96 | September 2014 |`0.85`_    |`0.67.11`_ |           |           |           |           |              |           |           |
  97 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
  98 | August    2014 |`0.84`_    |`0.67.10`_ |           |           |           |           |              |           |           |
  99 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 100 | July      2014 |`0.83`_    |           |           |`0.80.5`_  |           |           |              |           |           |
 101 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 102 |                |           |           |           |`0.80.4`_  |           |           |              |           |           |
 103 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 104 |                |           |           |           |`0.80.3`_  |           |           |              |           |           |
 105 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 106 |                |           |           |           |`0.80.2`_  |           |           |              |           |           |
 107 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 108 | June      2014 |`0.82`_    |           |           |           |           |           |              |           |           |
 109 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 110 |                |`0.81`_    |           |           |           |           |           |              |           |           |
 111 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 112 | May       2014 |           |`0.67.9`_  |           |`0.80.1`_  |           |           |              |           |           |
 113 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 114 |                |           |`0.67.8`_  |           |`0.80`_    |           |           |              |           |           |
 115 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 116 | April     2014 |`0.79`_    |           |           |           |           |           |              |           |           |
 117 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 118 | March     2014 |`0.78`_    |           |           |           |           |           |              |           |           |
 119 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 120 | February  2014 |`0.77`_    |`0.67.7`_  |           |           |           |           |              |           |           |
 121 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 122 |                |           |`0.67.6`_  |           |           |           |           |              |           |           |
 123 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 124 | January   2014 |`0.76`_    |           |           |           |           |           |              |           |           |
 125 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 126 |                |`0.75`_    |           |           |           |           |           |              |           |           |
 127 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 128 | December  2013 |`0.74`_    |`0.67.5`_  |`0.72.2`_  |           |           |           |              |           |           |
 129 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 130 |                |`0.73`_    |           |           |           |           |           |              |           |           |
 131 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 132 | November  2013 |           |           |`0.72.1`_  |           |           |           |              |           |           |
 133 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 134 |                |           |           |`0.72`_    |           |           |           |              |           |           |
 135 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 136 | October   2013 |`0.71`_    |`0.67.4`_  |           |           |           |           |              |           |           |
 137 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 138 |                |`0.70`_    |           |           |           |           |           |              |           |           |
 139 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 140 | September 2013 |`0.69`_    |           |           |           |           |           |              |           |           |
 141 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 142 |                |`0.68`_    |`0.67.3`_  |           |           |           |           |              |           |           |
 143 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 144 | August    2013 |           |`0.67.2`_  |           |           |           |           |              |           |           |
 145 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 146 |                |           |`0.67.1`_  |           |           |           |           |              |           |           |
 147 |                +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 148 |                |           |`0.67`_    |           |           |           |           |              |           |           |
 149 +----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+
 150
 151
 152 .. _12.0.0: ../release-notes#v12.0.0-luminous-dev
 153
 154 .. _11.2.0: ../release-notes#v11.2.0-kraken
 155 .. _11.0.2: ../release-notes#v11.0.2-kraken
 156 .. _Kraken: ../release-notes#v11.0.2-kraken
 157
 158 .. _10.2.5: ../release-notes#v10.2.5-jewel
 159 .. _10.2.4: ../release-notes#v10.2.4-jewel
 160 .. _10.2.3: ../release-notes#v10.2.3-jewel
 161 .. _10.2.2: ../release-notes#v10.2.2-jewel
 162 .. _10.2.1: ../release-notes#v10.2.1-jewel
 163 .. _10.2.0: ../release-notes#v10.2.0-jewel
 164 .. _Jewel: ../release-notes#v10.2.0-jewel
 165
 166 .. _10.1.2: ../release-notes#v10-1-2-jewel-release-candidate
 167 .. _10.1.1: ../release-notes#v10-1-1-jewel-release-candidate
 168 .. _10.1.0: ../release-notes#v10-1-0-jewel-release-candidate
 169 .. _10.0.5: ../release-notes#v10-0-5
 170 .. _10.0.3: ../release-notes#v10-0-3
 171 .. _10.0.2: ../release-notes#v10-0-2
 172 .. _10.0.1: ../release-notes#v10-0-1
 173 .. _10.0.0: ../release-notes#v10-0-0
 174
 175 .. _9.2.1: ../release-notes#v9-2-1-infernalis
 176 .. _9.2.0: ../release-notes#v9-2-0-infernalis
 177 .. _Infernalis: ../release-notes#v9.2.0-infernalis
 178
 179 .. _9.1.0: ../release-notes#v9-1-0
 180 .. _9.0.3: ../release-notes#v9-0-3
 181 .. _9.0.2: ../release-notes#v9-0-2
 182 .. _9.0.1: ../release-notes#v9-0-1
 183 .. _9.0.0: ../release-notes#v9-0-0
 184
 185 .. _0.94.10: ../release-notes#v0-94-10-hammer
 186 .. _0.94.9: ../release-notes#v0-94-9-hammer
 187 .. _0.94.8: ../release-notes#v0-94-8-hammer
 188 .. _0.94.7: ../release-notes#v0-94-7-hammer
 189 .. _0.94.6: ../release-notes#v0-94-6-hammer
 190 .. _0.94.5: ../release-notes#v0-94-5-hammer
 191 .. _0.94.4: ../release-notes#v0-94-4-hammer
 192 .. _0.94.3: ../release-notes#v0-94-3-hammer
 193 .. _0.94.2: ../release-notes#v0-94-2-hammer
 194 .. _0.94.1: ../release-notes#v0-94-1-hammer
 195 .. _0.94: ../release-notes#v0-94-hammer
 196 .. _Hammer: ../release-notes#v0-94-hammer
 197
 198 .. _0.93: ../release-notes#v0-93
 199 .. _0.92: ../release-notes#v0-92
 200 .. _0.91: ../release-notes#v0-91
 201 .. _0.90: ../release-notes#v0-90
 202 .. _0.89: ../release-notes#v0-89
 203 .. _0.88: ../release-notes#v0-88
 204
 205 .. _0.87.2: ../release-notes#v0-87-2-giant
 206 .. _0.87.1: ../release-notes#v0-87-1-giant
 207 .. _0.87: ../release-notes#v0-87-giant
 208 .. _Giant: ../release-notes#v0-87-giant
 209
 210 .. _0.86: ../release-notes#v0-86
 211 .. _0.85: ../release-notes#v0-85
 212 .. _0.84: ../release-notes#v0-84
 213 .. _0.83: ../release-notes#v0-83
 214 .. _0.82: ../release-notes#v0-82
 215 .. _0.81: ../release-notes#v0-81
 216
 217 .. _0.80.11: ../release-notes#v0-80-11-firefly
 218 .. _0.80.10: ../release-notes#v0-80-10-firefly
 219 .. _0.80.9: ../release-notes#v0-80-9-firefly
 220 .. _0.80.8: ../release-notes#v0-80-8-firefly
 221 .. _0.80.7: ../release-notes#v0-80-7-firefly
 222 .. _0.80.6: ../release-notes#v0-80-6-firefly
 223 .. _0.80.5: ../release-notes#v0-80-5-firefly
 224 .. _0.80.4: ../release-notes#v0-80-4-firefly
 225 .. _0.80.3: ../release-notes#v0-80-3-firefly
 226 .. _0.80.2: ../release-notes#v0-80-2-firefly
 227 .. _0.80.1: ../release-notes#v0-80-1-firefly
 228 .. _0.80: ../release-notes#v0-80-firefly
 229 .. _Firefly: ../release-notes#v0-80-firefly
 230
 231 .. _0.79: ../release-notes#v0-79
 232 .. _0.78: ../release-notes#v0-78
 233 .. _0.77: ../release-notes#v0-77
 234 .. _0.76: ../release-notes#v0-76
 235 .. _0.75: ../release-notes#v0-75
 236 .. _0.74: ../release-notes#v0-74
 237 .. _0.73: ../release-notes#v0-73
 238
 239 .. _0.72.2: ../release-notes#v0-72-2-emperor
 240 .. _0.72.1: ../release-notes#v0-72-1-emperor
 241 .. _0.72: ../release-notes#v0-72-emperor
 242 .. _Emperor: ../release-notes#v0-72-emperor
 243
 244 .. _0.71: ../release-notes#v0-71
 245 .. _0.70: ../release-notes#v0-70
 246 .. _0.69: ../release-notes#v0-69
 247 .. _0.68: ../release-notes#v0-68
 248
 249 .. _0.67.11: ../release-notes#v0-67-11-dumpling
 250 .. _0.67.10: ../release-notes#v0-67-10-dumpling
 251 .. _0.67.9: ../release-notes#v0-67-9-dumpling
 252 .. _0.67.8: ../release-notes#v0-67-8-dumpling
 253 .. _0.67.7: ../release-notes#v0-67-7-dumpling
 254 .. _0.67.6: ../release-notes#v0-67-6-dumpling
 255 .. _0.67.5: ../release-notes#v0-67-5-dumpling
 256 .. _0.67.4: ../release-notes#v0-67-4-dumpling
 257 .. _0.67.3: ../release-notes#v0-67-3-dumpling
 258 .. _0.67.2: ../release-notes#v0-67-2-dumpling
 259 .. _0.67.1: ../release-notes#v0-67-1-dumpling
 260 .. _0.67: ../release-notes#v0-67-dumpling
 261 .. _Dumpling:  ../release-notes#v0-67-dumpling
 262
 263 Understanding the release cycle
 264 -------------------------------
 265
 266 The development release cycle is two to four weeks long.  Each cycle
 267 freezes the master development branch and applies `integration and
 268 upgrade tests <https://github.com/ceph/ceph-qa-suite>`_ for the
 269 duration of one cycle before it is released and the next release's
 270 code is frozen for testing.  Once released, there is no effort to
 271 backport fixes; developer focus in on the next development release
 272 which is usually only a few weeks away.
 273
 274 There are three to four stable releases a year.  Each stable release
 275 will receive a name (e.g., 'Jewel') and bug fix backports at least
 276 until the next stable release is out.
 277
 278 Every other stable releases is a LTS (Long Term Stable) and will
 279 receive updates until two LTS are published. For instance Dumpling is
 280 retired when Hammer is published, Firefly is retired when Jewel is
 281 published etc. The rationale is that backports to a LTS (Firefly for
 282 instance) are expected to happen until the next LTS is published
 283 (Jewel is the LTS following Hammer), to fix bugs and possibly
 284 backport important features. After the next LTS is published,
 285 backports are still expected to fix bugs with a focus on whatever can
 286 prevent upgrades to the next LTS (in our example, fixes to Dumpling
 287 were published after Firefly was released and until Hammer was
 288 published, primarily to ensure Dumpling cluster can smoothly migrate
 289 to Firefly).
 290
 291 * Long Term Stable : until the next two LTS are published
 292 * Stable release : until the next stable release is published
 293 * Development / testing release : no backports
 294
 295 For each stable release:
 296
 297 * `Integration and upgrade tests
 298   <https://github.com/ceph/ceph-qa-suite>`_ are run on a regular basis
 299   and `their results <http://pulpito.ceph.com/>`_ analyzed by Ceph
 300   developers.
 301 * `Issues <http://tracker.ceph.com/projects/ceph/issues?query_id=27>`_
 302   fixed in the development branch (master) are scheduled to be backported.
 303 * When an issue found in the stable release is `reported
 304   <http://tracker.ceph.com/projects/ceph/issues/new>`_, it is
 305   triaged by Ceph developers.
 306 * The `stable releases and backport team <http://tracker.ceph.com/projects/ceph-releases>`_
 307   publishes ``point releases`` including fixes that have been backported to the stable release.
 308
 309 In the timeline, the life time of a LTS is calculated to be
 310 approximately 18 months after the month of the first release. For
 311 instance, Dumpling is published August 2013 and 18 months starting
 312 September 2013 is February 2015, therefore by March 2015 Dumpling
 313 should be retired. The lifetime of a release may vary because it
 314 depend on how quickly the stable releases are published. For instance
 315 although Dumpling theoritical retirement was March 2015, it was
 316 extended to May 2015.
 317
 318 Release numbers conventions
 319 ---------------------------
 320
 321 The first Ceph release back in Jan of 2008 was 0.1.  That made sense at
 322 the time.  The versioning scheme did not change until April 2015,
 323 when 0.94.1 (the first Hammer point release) was published.  To avoid reaching
 324 0.99 (and 0.100 or 1.00?) we have a new strategy.
 325
 326 * x.0.z - development releases (for early testers and the brave at heart)
 327 * x.1.z - release candidates (for test clusters, brave users)
 328 * x.2.z - stable/bugfix releases (for users)
 329
 330 ``x`` will start at 9 for Infernalis (``I`` is the 9th letter), making
 331 our first development release of the 9th release cycle 9.0.0.
 332 Subsequent development releases will be 9.0.1, 9.0.2, etc.
 333
 334 After a couple months we'll have a 9.1.0 (and maybe 9.1.1) release candidate.
 335
 336 A few weeks after that we'll have the Infernalis release 9.2.0, followed
 337 by stable bug fix updates 9.2.1, 9.2.2, etc., and then begin work on the
 338 Jewel (10.y.z) release.