X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;f=src%2Fceph%2Fdoc%2Freleases.rst;fp=src%2Fceph%2Fdoc%2Freleases.rst;h=5249d5644016cb7b786afa546da41e8db8d07507;hb=812ff6ca9fcd3e629e49d4328905f33eee8ca3f5;hp=0000000000000000000000000000000000000000;hpb=15280273faafb77777eab341909a3f495cf248d9;p=stor4nfv.git diff --git a/src/ceph/doc/releases.rst b/src/ceph/doc/releases.rst new file mode 100644 index 0000000..5249d56 --- /dev/null +++ b/src/ceph/doc/releases.rst @@ -0,0 +1,361 @@ +============= +Ceph Releases +============= + +Timeline +-------- + ++----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`Dumpling`_|`Emperor`_ |`Firefly`_ |`Giant`_ |`Hammer`_ |`Infernalis`_ |`Jewel`_ |`Kraken`_ | +| |LTS |Stable |LTS |Stable |LTS |Stable |LTS |Stable | ++----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| First release | August | November | May | October | April | November | April | January | +| | 2013 | 2013 | 2014 | 2014 | 2015 | 2015 | 2016 | 2017 | ++----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| Estimated retirement | March | | January | | May | | November | | +| | 2015 | | 2016 | | 2017 | | 2017 | | ++----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| Actual retirement | May | May | April | April | | April 2016 | | | +| | 2015 | 2014 | 2016 | 2015 | | | | | ++----------------------------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ + ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |Development|`Dumpling`_|`Emperor`_ |`Firefly`_ |`Giant`_ |`Hammer`_ |`Infernalis`_ |`Jewel`_ |`Kraken`_ | +| |Testing |LTS |Stable |LTS |Stable |LTS |Stable |LTS |Stable | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| July 2017 | 12.1.1 | | | | | | |`10.2.9`_ | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | | | | | |`10.2.8`_ | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| June 2017 |`12.1.0`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| May 2017 |`12.0.3`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| April 2017 |`12.0.2`_ | | | | | | |`10.2.7`_ | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| March 2017 |`12.0.1`_ | | | | | | |`10.2.6`_ | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| February 2017 |`12.0.0`_ | | | | |`0.94.10`_ | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| January 2017 | 11.1.1 | | | | | | | |`11.2.0`_ | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| December 2016 | 11.1.0 | | | | | | |`10.2.5`_ | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | | | | | |`10.2.4`_ | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| October 2016 |`11.0.2`_ | | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | 11.0.1 | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| September 2016 | | | | | | | |`10.2.3`_ | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| August 2016 | | | | | |`0.94.9`_ | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | | | |`0.94.8`_ | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| June 2016 | 11.0.0 | | | | | | |`10.2.2`_ | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| May 2016 | | | | | |`0.94.7`_ | |`10.2.1`_ | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| April 2016 |`10.1.2`_ | | | | | | |`10.2.0`_ | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`10.1.1`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| March 2016 |`10.1.0`_ | | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`10.0.5`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| February 2016 |`10.0.3`_ | | | | |`0.94.6`_ |`9.2.1`_ | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| January 2016 |`10.0.2`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| December 2015 |`10.0.1`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| November 2015 |`10.0.0`_ | | |`0.80.11`_ | | |`9.2.0`_ | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| October 2015 |`9.1.0`_ | | | | |`0.94.5`_ | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | | | |`0.94.4`_ | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| August 2015 |`9.0.3`_ | | | | |`0.94.3`_ | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| July 2015 |`9.0.2`_ | | |`0.80.10`_ | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| June 2015 |`9.0.1`_ | | | | |`0.94.2`_ | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| May 2015 |`9.0.0`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| April 2015 | | | | |`0.87.2`_ |`0.94.1`_ | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | | | |`0.94`_ | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| March 2015 | | | |`0.80.9`_ | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| February 2015 |`0.93`_ | | | |`0.87.1`_ | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`0.92`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| January 2015 |`0.91`_ | | |`0.80.8`_ | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| December 2014 |`0.90`_ | | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`0.89`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| November 2014 |`0.88`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| October 2014 |`0.86`_ | | |`0.80.7`_ |`0.87`_ | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | |`0.80.6`_ | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| September 2014 |`0.85`_ |`0.67.11`_ | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| August 2014 |`0.84`_ |`0.67.10`_ | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| July 2014 |`0.83`_ | | |`0.80.5`_ | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | |`0.80.4`_ | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | |`0.80.3`_ | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | | |`0.80.2`_ | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| June 2014 |`0.82`_ | | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`0.81`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| May 2014 | |`0.67.9`_ | |`0.80.1`_ | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | |`0.67.8`_ | |`0.80`_ | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| April 2014 |`0.79`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| March 2014 |`0.78`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| February 2014 |`0.77`_ |`0.67.7`_ | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | |`0.67.6`_ | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| January 2014 |`0.76`_ | | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`0.75`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| December 2013 |`0.74`_ |`0.67.5`_ |`0.72.2`_ | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`0.73`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| November 2013 | | |`0.72.1`_ | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | | |`0.72`_ | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| October 2013 |`0.71`_ |`0.67.4`_ | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`0.70`_ | | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| September 2013 |`0.69`_ | | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| |`0.68`_ |`0.67.3`_ | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| August 2013 | |`0.67.2`_ | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | |`0.67.1`_ | | | | | | | | +| +-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ +| | |`0.67`_ | | | | | | | | ++----------------+-----------+-----------+-----------+-----------+-----------+-----------+--------------+-----------+-----------+ + + +.. _12.1.0: ../release-notes#v12-1-0-luminous-rc +.. _12.0.3: ../release-notes#v12-0-3-luminous-dev +.. _12.0.2: ../release-notes#v12-0-2-luminous-dev +.. _12.0.1: ../release-notes#v12-0-1-luminous-dev +.. _12.0.0: ../release-notes#v12-0-0-luminous-dev + +.. _11.2.0: ../release-notes#v11-2-0-kraken +.. _Kraken: ../release-notes#v11-2-0-kraken + +.. _11.0.2: ../release-notes#v11-0-2-kraken + +.. _10.2.9: ../release-notes#v10-2-9-jewel +.. _10.2.8: ../release-notes#v10-2-8-jewel +.. _10.2.7: ../release-notes#v10-2-7-jewel +.. _10.2.6: ../release-notes#v10-2-6-jewel +.. _10.2.5: ../release-notes#v10-2-5-jewel +.. _10.2.4: ../release-notes#v10-2-4-jewel +.. _10.2.3: ../release-notes#v10-2-3-jewel +.. _10.2.2: ../release-notes#v10-2-2-jewel +.. _10.2.1: ../release-notes#v10-2-1-jewel +.. _10.2.0: ../release-notes#v10-2-0-jewel +.. _Jewel: ../release-notes#v10-2-0-jewel + +.. _10.1.2: ../release-notes#v10-1-2-jewel-release-candidate +.. _10.1.1: ../release-notes#v10-1-1-jewel-release-candidate +.. _10.1.0: ../release-notes#v10-1-0-jewel-release-candidate +.. _10.0.5: ../release-notes#v10-0-5 +.. _10.0.3: ../release-notes#v10-0-3 +.. _10.0.2: ../release-notes#v10-0-2 +.. _10.0.1: ../release-notes#v10-0-1 +.. _10.0.0: ../release-notes#v10-0-0 + +.. _9.2.1: ../release-notes#v9-2-1-infernalis +.. _9.2.0: ../release-notes#v9-2-0-infernalis +.. _Infernalis: ../release-notes#v9-2-0-infernalis + +.. _9.1.0: ../release-notes#v9-1-0 +.. _9.0.3: ../release-notes#v9-0-3 +.. _9.0.2: ../release-notes#v9-0-2 +.. _9.0.1: ../release-notes#v9-0-1 +.. _9.0.0: ../release-notes#v9-0-0 + +.. _0.94.10: ../release-notes#v0-94-10-hammer +.. _0.94.9: ../release-notes#v0-94-9-hammer +.. _0.94.8: ../release-notes#v0-94-8-hammer +.. _0.94.7: ../release-notes#v0-94-7-hammer +.. _0.94.6: ../release-notes#v0-94-6-hammer +.. _0.94.5: ../release-notes#v0-94-5-hammer +.. _0.94.4: ../release-notes#v0-94-4-hammer +.. _0.94.3: ../release-notes#v0-94-3-hammer +.. _0.94.2: ../release-notes#v0-94-2-hammer +.. _0.94.1: ../release-notes#v0-94-1-hammer +.. _0.94: ../release-notes#v0-94-hammer +.. _Hammer: ../release-notes#v0-94-hammer + +.. _0.93: ../release-notes#v0-93 +.. _0.92: ../release-notes#v0-92 +.. _0.91: ../release-notes#v0-91 +.. _0.90: ../release-notes#v0-90 +.. _0.89: ../release-notes#v0-89 +.. _0.88: ../release-notes#v0-88 + +.. _0.87.2: ../release-notes#v0-87-2-giant +.. _0.87.1: ../release-notes#v0-87-1-giant +.. _0.87: ../release-notes#v0-87-giant +.. _Giant: ../release-notes#v0-87-giant + +.. _0.86: ../release-notes#v0-86 +.. _0.85: ../release-notes#v0-85 +.. _0.84: ../release-notes#v0-84 +.. _0.83: ../release-notes#v0-83 +.. _0.82: ../release-notes#v0-82 +.. _0.81: ../release-notes#v0-81 + +.. _0.80.11: ../release-notes#v0-80-11-firefly +.. _0.80.10: ../release-notes#v0-80-10-firefly +.. _0.80.9: ../release-notes#v0-80-9-firefly +.. _0.80.8: ../release-notes#v0-80-8-firefly +.. _0.80.7: ../release-notes#v0-80-7-firefly +.. _0.80.6: ../release-notes#v0-80-6-firefly +.. _0.80.5: ../release-notes#v0-80-5-firefly +.. _0.80.4: ../release-notes#v0-80-4-firefly +.. _0.80.3: ../release-notes#v0-80-3-firefly +.. _0.80.2: ../release-notes#v0-80-2-firefly +.. _0.80.1: ../release-notes#v0-80-1-firefly +.. _0.80: ../release-notes#v0-80-firefly +.. _Firefly: ../release-notes#v0-80-firefly + +.. _0.79: ../release-notes#v0-79 +.. _0.78: ../release-notes#v0-78 +.. _0.77: ../release-notes#v0-77 +.. _0.76: ../release-notes#v0-76 +.. _0.75: ../release-notes#v0-75 +.. _0.74: ../release-notes#v0-74 +.. _0.73: ../release-notes#v0-73 + +.. _0.72.2: ../release-notes#v0-72-2-emperor +.. _0.72.1: ../release-notes#v0-72-1-emperor +.. _0.72: ../release-notes#v0-72-emperor +.. _Emperor: ../release-notes#v0-72-emperor + +.. _0.71: ../release-notes#v0-71 +.. _0.70: ../release-notes#v0-70 +.. _0.69: ../release-notes#v0-69 +.. _0.68: ../release-notes#v0-68 + +.. _0.67.11: ../release-notes#v0-67-11-dumpling +.. _0.67.10: ../release-notes#v0-67-10-dumpling +.. _0.67.9: ../release-notes#v0-67-9-dumpling +.. _0.67.8: ../release-notes#v0-67-8-dumpling +.. _0.67.7: ../release-notes#v0-67-7-dumpling +.. _0.67.6: ../release-notes#v0-67-6-dumpling +.. _0.67.5: ../release-notes#v0-67-5-dumpling +.. _0.67.4: ../release-notes#v0-67-4-dumpling +.. _0.67.3: ../release-notes#v0-67-3-dumpling +.. _0.67.2: ../release-notes#v0-67-2-dumpling +.. _0.67.1: ../release-notes#v0-67-1-dumpling +.. _0.67: ../release-notes#v0-67-dumpling +.. _Dumpling: ../release-notes#v0-67-dumpling + +Understanding the release cycle +------------------------------- + +The development release cycle is two to four weeks long. Each cycle +freezes the master development branch and applies `integration and +upgrade tests `_ for the +duration of one cycle before it is released and the next release's +code is frozen for testing. Once released, there is no effort to +backport fixes; developer focus in on the next development release +which is usually only a few weeks away. + +There are three to four stable releases a year. Each stable release +will receive a name (e.g., 'Jewel') and bug fix backports at least +until the next stable release is out. + +Every other stable releases is a LTS (Long Term Stable) and will +receive updates until two LTS are published. For instance Dumpling is +retired when Hammer is published, Firefly is retired when Jewel is +published etc. The rationale is that backports to a LTS (Firefly for +instance) are expected to happen until the next LTS is published +(Jewel is the LTS following Hammer), to fix bugs and possibly +backport important features. After the next LTS is published, +backports are still expected to fix bugs with a focus on whatever can +prevent upgrades to the next LTS (in our example, fixes to Dumpling +were published after Firefly was released and until Hammer was +published, primarily to ensure Dumpling cluster can smoothly migrate +to Firefly). + +* Long Term Stable : until the next two LTS are published +* Stable release : until the next stable release is published +* Development / testing release : no backports + +For each stable release: + +* `Integration and upgrade tests + `_ are run on a regular basis + and `their results `_ analyzed by Ceph + developers. +* `Issues `_ + fixed in the development branch (master) are scheduled to be backported. +* When an issue found in the stable release is `reported + `_, it is + triaged by Ceph developers. +* The `stable releases and backport team `_ + publishes ``point releases`` including fixes that have been backported to the stable release. + +In the timeline, the life time of a LTS is calculated to be +approximately 18 months after the month of the first release. For +instance, Dumpling is published August 2013 and 18 months starting +September 2013 is February 2015, therefore by March 2015 Dumpling +should be retired. The lifetime of a release may vary because it +depend on how quickly the stable releases are published. For instance +although Dumpling theoritical retirement was March 2015, it was +extended to May 2015. + +Release numbers conventions +--------------------------- + +The first Ceph release back in Jan of 2008 was 0.1. That made sense at +the time. The versioning scheme did not change until April 2015, +when 0.94.1 (the first Hammer point release) was published. To avoid reaching +0.99 (and 0.100 or 1.00?) we have a new strategy. + +* 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) + +``x`` will start at 9 for Infernalis (``I`` is the 9th letter), making +our first development release of the 9th release cycle 9.0.0. +Subsequent development releases will be 9.0.1, 9.0.2, etc. + +After a couple months we'll have a 9.1.0 (and maybe 9.1.1) release candidate. + +A few weeks after that we'll have the Infernalis release 9.2.0, followed +by stable bug fix updates 9.2.1, 9.2.2, etc., and then begin work on the +Jewel (10.y.z) release.