]>
Commit | Line | Data |
---|---|---|
9f95a23c | 1 | .. _ceph-releases-general: |
11fdf7f2 | 2 | |
9f95a23c TL |
3 | ======================= |
4 | Ceph Releases (general) | |
5 | ======================= | |
6 | ||
7 | .. toctree:: | |
8 | :maxdepth: 1 | |
9 | ||
10 | Active stable releases | |
11 | ---------------------- | |
11fdf7f2 TL |
12 | |
13 | .. ceph_releases:: releases.yml | |
14 | ||
9f95a23c TL |
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` | |
11fdf7f2 | 118 | |
9f95a23c TL |
119 | Release timeline |
120 | ---------------- | |
121 | ||
f67539c2 | 122 | .. ceph_timeline:: releases.yml development octopus nautilus mimic luminous kraken jewel infernalis hammer giant firefly |
9f95a23c TL |
123 | |
124 | .. _Octopus: ../octopus | |
f67539c2 TL |
125 | .. _15.2.7: ../octopus#v15-2-7-octopus |
126 | .. _15.2.6: ../octopus#v15-2-6-octopus | |
127 | .. _15.2.5: ../octopus#v15-2-5-octopus | |
128 | .. _15.2.4: ../octopus#v15-2-4-octopus | |
129 | .. _15.2.3: ../octopus#v15-2-3-octopus | |
130 | .. _15.2.2: ../octopus#v15-2-2-octopus | |
131 | .. _15.2.1: ../octopus#v15-2-1-octopus | |
801d1391 | 132 | .. _15.2.0: ../octopus#v15-2-0-octopus |
9f95a23c TL |
133 | |
134 | .. _Nautilus: ../nautilus | |
f67539c2 TL |
135 | .. _14.2.14: ../nautilus#v14-2-14-nautilus |
136 | .. _14.2.13: ../nautilus#v14-2-13-nautilus | |
137 | .. _14.2.12: ../nautilus#v14-2-12-nautilus | |
138 | .. _14.2.11: ../nautilus#v14-2-11-nautilus | |
139 | .. _14.2.10: ../nautilus#v14-2-10-nautilus | |
140 | .. _14.2.9: ../nautilus#v14-2-9-nautilus | |
9f95a23c TL |
141 | .. _14.2.8: ../nautilus#v14-2-8-nautilus |
142 | .. _14.2.7: ../nautilus#v14-2-7-nautilus | |
143 | .. _14.2.6: ../nautilus#v14-2-6-nautilus | |
144 | .. _14.2.5: ../nautilus#v14-2-5-nautilus | |
145 | .. _14.2.4: ../nautilus#v14-2-4-nautilus | |
146 | .. _14.2.3: ../nautilus#v14-2-3-nautilus | |
147 | .. _14.2.2: ../nautilus#v14-2-2-nautilus | |
148 | .. _14.2.1: ../nautilus#v14-2-1-nautilus | |
149 | .. _14.2.0: ../nautilus#v14-2-0-nautilus | |
11fdf7f2 TL |
150 | |
151 | .. _Mimic: ../mimic | |
f67539c2 TL |
152 | .. _13.2.10: ../mimic#v13-2-10-mimic |
153 | .. _13.2.9: ../mimic#v13-2-9-mimic | |
9f95a23c TL |
154 | .. _13.2.8: ../mimic#v13-2-8-mimic |
155 | .. _13.2.7: ../mimic#v13-2-7-mimic | |
156 | .. _13.2.6: ../mimic#v13-2-6-mimic | |
157 | .. _13.2.5: ../mimic#v13-2-5-mimic | |
11fdf7f2 TL |
158 | .. _13.2.4: ../mimic#v13-2-4-mimic |
159 | .. _13.2.3: ../mimic#v13-2-3-mimic | |
160 | .. _13.2.2: ../mimic#v13-2-2-mimic | |
161 | .. _13.2.1: ../mimic#v13-2-1-mimic | |
162 | .. _13.2.0: ../mimic#v13-2-0-mimic | |
163 | ||
9f95a23c TL |
164 | .. _Luminous: ../luminous |
165 | .. _12.2.13: ../luminous#v12-2-13-luminous | |
166 | .. _12.2.12: ../luminous#v12-2-12-luminous | |
167 | .. _12.2.11: ../luminous#v12-2-11-luminous | |
11fdf7f2 TL |
168 | .. _12.2.10: ../luminous#v12-2-10-luminous |
169 | .. _12.2.9: ../luminous#v12-2-9-luminous | |
170 | .. _12.2.8: ../luminous#v12-2-8-luminous | |
171 | .. _12.2.7: ../luminous#v12-2-7-luminous | |
172 | .. _12.2.6: ../luminous#v12-2-6-luminous | |
173 | .. _12.2.5: ../luminous#v12-2-5-luminous | |
174 | .. _12.2.4: ../luminous#v12-2-4-luminous | |
175 | .. _12.2.3: ../luminous#v12-2-3-luminous | |
176 | .. _12.2.2: ../luminous#v12-2-2-luminous | |
177 | .. _12.2.1: ../luminous#v12-2-1-luminous | |
178 | .. _12.2.0: ../luminous#v12-2-0-luminous | |
179 | ||
180 | .. _11.2.1: ../kraken#v11-2-1-kraken | |
181 | .. _11.2.0: ../kraken#v11-2-0-kraken | |
182 | .. _Kraken: ../kraken#v11-2-0-kraken | |
183 | ||
184 | .. _11.0.2: ../kraken#v11-0-2-kraken | |
185 | ||
186 | .. _10.2.11: ../jewel#v10-2-11-jewel | |
187 | .. _10.2.10: ../jewel#v10-2-10-jewel | |
188 | .. _10.2.9: ../jewel#v10-2-9-jewel | |
189 | .. _10.2.8: ../jewel#v10-2-8-jewel | |
190 | .. _10.2.7: ../jewel#v10-2-7-jewel | |
191 | .. _10.2.6: ../jewel#v10-2-6-jewel | |
192 | .. _10.2.5: ../jewel#v10-2-5-jewel | |
193 | .. _10.2.4: ../jewel#v10-2-4-jewel | |
194 | .. _10.2.3: ../jewel#v10-2-3-jewel | |
195 | .. _10.2.2: ../jewel#v10-2-2-jewel | |
196 | .. _10.2.1: ../jewel#v10-2-1-jewel | |
197 | .. _10.2.0: ../jewel#v10-2-0-jewel | |
198 | .. _Jewel: ../jewel#v10-2-0-jewel | |
199 | ||
200 | .. _10.1.2: ../jewel#v10-1-2-jewel-release-candidate | |
201 | .. _10.1.1: ../jewel#v10-1-1-jewel-release-candidate | |
202 | .. _10.1.0: ../jewel#v10-1-0-jewel-release-candidate | |
203 | .. _10.0.5: ../jewel#v10-0-5 | |
204 | .. _10.0.3: ../jewel#v10-0-3 | |
205 | .. _10.0.2: ../jewel#v10-0-2 | |
206 | .. _10.0.1: ../jewel#v10-0-1 | |
207 | .. _10.0.0: ../jewel#v10-0-0 | |
208 | ||
209 | .. _9.2.1: ../infernalis#v9-2-1-infernalis | |
210 | .. _9.2.0: ../infernalis#v9-2-0-infernalis | |
211 | .. _Infernalis: ../infernalis#v9-2-0-infernalis | |
212 | ||
213 | .. _9.1.0: ../infernalis#v9-1-0 | |
214 | .. _9.0.3: ../infernalis#v9-0-3 | |
215 | .. _9.0.2: ../infernalis#v9-0-2 | |
216 | .. _9.0.1: ../infernalis#v9-0-1 | |
217 | .. _9.0.0: ../infernalis#v9-0-0 | |
218 | ||
219 | .. _0.94.10: ../hammer#v0-94-10-hammer | |
220 | .. _0.94.9: ../hammer#v0-94-9-hammer | |
221 | .. _0.94.8: ../hammer#v0-94-8-hammer | |
222 | .. _0.94.7: ../hammer#v0-94-7-hammer | |
223 | .. _0.94.6: ../hammer#v0-94-6-hammer | |
224 | .. _0.94.5: ../hammer#v0-94-5-hammer | |
225 | .. _0.94.4: ../hammer#v0-94-4-hammer | |
226 | .. _0.94.3: ../hammer#v0-94-3-hammer | |
227 | .. _0.94.2: ../hammer#v0-94-2-hammer | |
228 | .. _0.94.1: ../hammer#v0-94-1-hammer | |
229 | .. _0.94: ../hammer#v0-94-hammer | |
230 | .. _Hammer: ../hammer#v0-94-hammer | |
231 | ||
232 | .. _0.93: ../hammer#v0-93 | |
233 | .. _0.92: ../hammer#v0-92 | |
234 | .. _0.91: ../hammer#v0-91 | |
235 | .. _0.90: ../hammer#v0-90 | |
236 | .. _0.89: ../hammer#v0-89 | |
237 | .. _0.88: ../hammer#v0-88 | |
238 | ||
239 | .. _0.87.2: ../giant#v0-87-2-giant | |
240 | .. _0.87.1: ../giant#v0-87-1-giant | |
241 | .. _0.87: ../giant#v0-87-giant | |
242 | .. _Giant: ../giant#v0-87-giant | |
243 | ||
244 | .. _0.86: ../giant#v0-86 | |
245 | .. _0.85: ../giant#v0-85 | |
246 | .. _0.84: ../giant#v0-84 | |
247 | .. _0.83: ../giant#v0-83 | |
248 | .. _0.82: ../giant#v0-82 | |
249 | .. _0.81: ../giant#v0-81 | |
250 | ||
251 | .. _0.80.11: ../firefly#v0-80-11-firefly | |
252 | .. _0.80.10: ../firefly#v0-80-10-firefly | |
253 | .. _0.80.9: ../firefly#v0-80-9-firefly | |
254 | .. _0.80.8: ../firefly#v0-80-8-firefly | |
255 | .. _0.80.7: ../firefly#v0-80-7-firefly | |
256 | .. _0.80.6: ../firefly#v0-80-6-firefly | |
257 | .. _0.80.5: ../firefly#v0-80-5-firefly | |
258 | .. _0.80.4: ../firefly#v0-80-4-firefly | |
259 | .. _0.80.3: ../firefly#v0-80-3-firefly | |
260 | .. _0.80.2: ../firefly#v0-80-2-firefly | |
261 | .. _0.80.1: ../firefly#v0-80-1-firefly | |
262 | .. _0.80: ../firefly#v0-80-firefly | |
263 | .. _Firefly: ../firefly#v0-80-firefly | |
264 | ||
265 | .. _0.79: ../firefly#v0-79 | |
266 | .. _0.78: ../firefly#v0-78 | |
267 | .. _0.77: ../firefly#v0-77 | |
268 | .. _0.76: ../firefly#v0-76 | |
269 | .. _0.75: ../firefly#v0-75 | |
270 | .. _0.74: ../firefly#v0-74 | |
271 | .. _0.73: ../firefly#v0-73 | |
272 | ||
273 | .. _0.72.2: ../emperor#v0-72-2-emperor | |
274 | .. _0.72.1: ../emperor#v0-72-1-emperor | |
275 | .. _0.72: ../emperor#v0-72-emperor | |
276 | .. _Emperor: ../emperor#v0-72-emperor | |
277 | ||
278 | .. _0.71: ../dumpling#v0-71 | |
279 | .. _0.70: ../dumpling#v0-70 | |
280 | .. _0.69: ../dumpling#v0-69 | |
281 | .. _0.68: ../dumpling#v0-68 | |
282 | ||
283 | .. _0.67.11: ../dumpling#v0-67-11-dumpling | |
284 | .. _0.67.10: ../dumpling#v0-67-10-dumpling | |
285 | .. _0.67.9: ../dumpling#v0-67-9-dumpling | |
286 | .. _0.67.8: ../dumpling#v0-67-8-dumpling | |
287 | .. _0.67.7: ../dumpling#v0-67-7-dumpling | |
288 | .. _0.67.6: ../dumpling#v0-67-6-dumpling | |
289 | .. _0.67.5: ../dumpling#v0-67-5-dumpling | |
290 | .. _0.67.4: ../dumpling#v0-67-4-dumpling | |
291 | .. _0.67.3: ../dumpling#v0-67-3-dumpling | |
292 | .. _0.67.2: ../dumpling#v0-67-2-dumpling | |
293 | .. _0.67.1: ../dumpling#v0-67-1-dumpling | |
294 | .. _0.67: ../dumpling#v0-67-dumpling | |
295 | .. _Dumpling: ../dumpling#v0-67-dumpling |