Project

General

Profile

HOWTO » History » Version 187

Loïc Dachary, 04/21/2021 01:36 PM

1 15 Loïc Dachary
h3. Introduction
2 1 Loïc Dachary
3 179 Loïc Dachary
Backporting and the maintenance of a stable release begins when a new "stable Ceph release":https://docs.ceph.com/en/latest/releases/general/ is published. Commits from the master branch are cherry-picked to the stable branch and run through integration and upgrade tests. After a few weeks a "point release":https://docs.ceph.com/en/latest/releases/general/#stable-releases-x-2-z is published. This repeats until the "the stable release is retired":https://docs.ceph.com/en/latest/releases/general/#lifetime-of-stable-releases. Backporting is focused on fixing bugs and development on the master branch is expected to add new features. Both share a "the same workflow":https://docs.ceph.com/en/latest/dev/developer_guide/basic-workflow/ with additional "tools and methods":https://github.com/ceph/ceph/blob/master/SubmittingPatches-backports.rst dedicated to help with backports.
4 16 Loïc Dachary
5 24 Loïc Dachary
h3. Overview of the backports in progress
6 24 Loïc Dachary
7 181 Nathan Cutler
* *pacific*
8 181 Nathan Cutler
** "backports": https://tracker.ceph.com/projects/ceph/issues?query_id=223
9 181 Nathan Cutler
** "pull requests": https://github.com/ceph/ceph/milestone/14
10 175 Nathan Cutler
* *octopus*
11 175 Nathan Cutler
** "backports": http://tracker.ceph.com/projects/ceph/issues?query_id=199
12 175 Nathan Cutler
** "pending issues": http://tracker.ceph.com/projects/ceph/issues?query_id=215
13 175 Nathan Cutler
** "pull requests": https://github.com/ceph/ceph/milestone/13
14 174 Loïc Dachary
* *nautilus*
15 175 Nathan Cutler
** "backports": http://tracker.ceph.com/projects/ceph/issues?query_id=171
16 175 Nathan Cutler
** "pending issues": http://tracker.ceph.com/projects/ceph/issues?query_id=172
17 175 Nathan Cutler
** "pull requests": https://github.com/ceph/ceph/milestone/12
18 175 Nathan Cutler
19 175 Nathan Cutler
h3. Who's who
20 96 Loïc Dachary
21 184 Loïc Dachary
Members of the "stable releases team":http://tracker.ceph.com/projects/ceph-releases as of March, 2021.
22 76 Loïc Dachary
 
23 76 Loïc Dachary
| Name                | IRC nick       |
24 165 Nathan Cutler
| David Galloway      | dgalloway      |
25 178 David Galloway
| Yuri Weinstein      | yuriw          |
26 26 Loïc Dachary
| Adam Kraitman       | akraitman      |
27 180 Loïc Dachary
| Nathan Cutler       | smithfarm      |
28 179 Loïc Dachary
| Loïc Dachary        | loicd          |
29 1 Loïc Dachary
30 1 Loïc Dachary
h3. HOWTO
31 23 Loïc Dachary
32 19 Loïc Dachary
The following describes in detail and in chronological order, the steps to follow for backporting and maintaining stable releases.
33 1 Loïc Dachary
34 15 Loïc Dachary
h4. Add a new stable release
35 23 Loïc Dachary
36 1 Loïc Dachary
* [[HOWTO start backporting a stable release]]
37 19 Loïc Dachary
38 15 Loïc Dachary
h4. Add a new point release
39 23 Loïc Dachary
40 9 Loïc Dachary
* [[HOWTO start working on a new point release]]
41 43 Loïc Dachary
42 22 Loïc Dachary
h4. Prepare a new point release
43 30 Loïc Dachary
44 1 Loïc Dachary
# [[HOWTO monitor the automated tests AKA nightlies]]
45 142 Nathan Cutler
# [[HOWTO schedule an issue for backporting]]
46 19 Loïc Dachary
# [[HOWTO document user visible changes]]
47 182 Loïc Dachary
# "HOWTO backport commits":https://github.com/ceph/ceph/blob/master/SubmittingPatches-backports.rst
48 112 Loïc Dachary
# [[HOWTO populate the integration branch]]
49 25 Loïc Dachary
# [[HOWTO run integration and upgrade tests]]
50 1 Loïc Dachary
# [[HOWTO forensic analysis of integration and upgrade tests]]
51 27 Loïc Dachary
# [[HOWTO describe a test result]]
52 34 Loïc Dachary
# [[HOWTO merge commits from the integration branch]]
53 31 Loïc Dachary
# [[HOWTO synchronize pull requests from different repositories]]
54 33 Loïc Dachary
# [[HOWTO resolve issues that are Pending Backport]]
55 157 Loïc Dachary
# [[HOWTO get the Ceph lead to decide if it is time for a point release]]
56 154 Abhishek Lekshmanan
# [[HOWTO get the leads to sign-off on a release]]
57 23 Loïc Dachary
# [[HOWTO write the release notes]]
58 15 Loïc Dachary
# [[HOWTO keep backporting while the release branch is frozen]]
59 1 Loïc Dachary
60 1 Loïc Dachary
h4. Retire a stable release
61 1 Loïc Dachary
62 154 Abhishek Lekshmanan
* [[HOWTO retire a stable release]]
63 173 Nathan Cutler
64 172 Nathan Cutler
h4. Release management
65 156 Abhishek Lekshmanan
66 41 Loïc Dachary
* [[HOWTO cut a release]] (DEPRECATED)
67 177 David Galloway
* [[HOWTO announce a release]] (DEPRECATED.  See https://tracker.ceph.com/projects/ceph-releases/wiki/HOWTO_write_the_release_notes#E-mail-Release-Notes)
68 52 Cron Tab
* [[HOWTO do dev checkpoint releases]]
69 185 Loïc Dachary
* "HOWTO make a hotfix release":https://pad.ceph.com/p/hotfix-process
70 187 Loïc Dachary
* HOWTO publish a release attachment:release.pdf (this is a copy dated 21 April 2021, the source "is here.":https://docs.google.com/document/d/1VivEEKDbYiWu2gJEcFe37w6AtalmuKNJSq6T1ZlZva0 (requires permission))
71 92 Loïc Dachary
72 58 Nathan Cutler
h4. Recurring duties expected from backporters
73 52 Cron Tab
74 56 Cron Tab
* [[HOWTO triage incoming backport pull requests]]
75 41 Loïc Dachary
* [[HOWTO triage incoming Pending backport issues]]
76 41 Loïc Dachary
* "fill in the missing releases":http://tracker.ceph.com/projects/ceph/issues?query_id=84
77 41 Loïc Dachary
78 41 Loïc Dachary
h4. Organize the stable releases and backports team
79 1 Loïc Dachary
80 1 Loïc Dachary
* [[HOWTO become a new team member]]
81 1 Loïc Dachary
* [[HOWTO retire from the team]]