Project

General

Profile

HOWTO » History » Version 180

Loïc Dachary, 03/05/2021 10:36 AM

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 175 Nathan Cutler
* *octopus*
8 175 Nathan Cutler
** "backports": http://tracker.ceph.com/projects/ceph/issues?query_id=199
9 175 Nathan Cutler
** "pending issues": http://tracker.ceph.com/projects/ceph/issues?query_id=215
10 175 Nathan Cutler
** "pull requests": https://github.com/ceph/ceph/milestone/13
11 174 Loïc Dachary
* *nautilus*
12 175 Nathan Cutler
** "backports": http://tracker.ceph.com/projects/ceph/issues?query_id=171
13 175 Nathan Cutler
** "pending issues": http://tracker.ceph.com/projects/ceph/issues?query_id=172
14 175 Nathan Cutler
** "pull requests": https://github.com/ceph/ceph/milestone/12
15 175 Nathan Cutler
16 175 Nathan Cutler
h3. Who's who
17 96 Loïc Dachary
18 179 Loïc Dachary
Members of the "stable releases team":http://tracker.ceph.com/projects/ceph-releases are assigned the following roles as of March, 2021.
19 76 Loïc Dachary
 
20 76 Loïc Dachary
| Name                | IRC nick       |
21 165 Nathan Cutler
| David Galloway      | dgalloway      |
22 178 David Galloway
| Yuri Weinstein      | yuriw          |
23 26 Loïc Dachary
| Adam Kraitman       | akraitman      |
24 180 Loïc Dachary
| Nathan Cutler       | smithfarm      |
25 179 Loïc Dachary
| Loïc Dachary        | loicd          |
26 1 Loïc Dachary
27 1 Loïc Dachary
h3. HOWTO
28 23 Loïc Dachary
29 19 Loïc Dachary
The following describes in detail and in chronological order, the steps to follow for backporting and maintaining stable releases.
30 1 Loïc Dachary
31 15 Loïc Dachary
h4. Add a new stable release
32 23 Loïc Dachary
33 1 Loïc Dachary
* [[HOWTO start backporting a stable release]]
34 19 Loïc Dachary
35 15 Loïc Dachary
h4. Add a new point release
36 23 Loïc Dachary
37 9 Loïc Dachary
* [[HOWTO start working on a new point release]]
38 43 Loïc Dachary
39 22 Loïc Dachary
h4. Prepare a new point release
40 30 Loïc Dachary
41 1 Loïc Dachary
# [[HOWTO monitor the automated tests AKA nightlies]]
42 142 Nathan Cutler
# [[HOWTO schedule an issue for backporting]]
43 19 Loïc Dachary
# [[HOWTO document user visible changes]]
44 1 Loïc Dachary
# [[HOWTO backport commits]]
45 46 Loïc Dachary
# [[HOWTO review backport PRs]]
46 112 Loïc Dachary
# [[HOWTO populate the integration branch]]
47 25 Loïc Dachary
# [[HOWTO run integration and upgrade tests]]
48 1 Loïc Dachary
# [[HOWTO forensic analysis of integration and upgrade tests]]
49 27 Loïc Dachary
# [[HOWTO describe a test result]]
50 34 Loïc Dachary
# [[HOWTO merge commits from the integration branch]]
51 31 Loïc Dachary
# [[HOWTO synchronize pull requests from different repositories]]
52 33 Loïc Dachary
# [[HOWTO resolve issues that are Pending Backport]]
53 157 Loïc Dachary
# [[HOWTO get the Ceph lead to decide if it is time for a point release]]
54 154 Abhishek Lekshmanan
# [[HOWTO get the leads to sign-off on a release]]
55 23 Loïc Dachary
# [[HOWTO write the release notes]]
56 15 Loïc Dachary
# [[HOWTO keep backporting while the release branch is frozen]]
57 1 Loïc Dachary
58 1 Loïc Dachary
h4. Retire a stable release
59 1 Loïc Dachary
60 154 Abhishek Lekshmanan
* [[HOWTO retire a stable release]]
61 173 Nathan Cutler
62 172 Nathan Cutler
h4. Release management
63 156 Abhishek Lekshmanan
64 41 Loïc Dachary
* [[HOWTO cut a release]] (DEPRECATED)
65 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)
66 52 Cron Tab
* [[HOWTO do dev checkpoint releases]]
67 92 Loïc Dachary
68 58 Nathan Cutler
h4. Recurring duties expected from backporters
69 52 Cron Tab
70 56 Cron Tab
* [[HOWTO triage incoming backport pull requests]]
71 41 Loïc Dachary
* [[HOWTO triage incoming Pending backport issues]]
72 41 Loïc Dachary
* "fill in the missing releases":http://tracker.ceph.com/projects/ceph/issues?query_id=84
73 41 Loïc Dachary
74 41 Loïc Dachary
h4. Organize the stable releases and backports team
75 1 Loïc Dachary
76 1 Loïc Dachary
* [[HOWTO become a new team member]]
77 1 Loïc Dachary
* [[HOWTO retire from the team]]