Project

General

Profile

HOWTO » History » Version 168

Nathan Cutler, 04/05/2018 07:30 PM

1 15 Loïc Dachary
h3. Introduction
2 1 Loïc Dachary
3 51 Loïc Dachary
Backporting and the maintenance of a stable release begins when a new "stable Ceph release":http://ceph.com/docs/master/releases 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":http://ceph.com/docs/master/releases is published. This repeats until the "the stable release is retired":http://ceph.com/docs/master/releases. Backporting is focused on fixing bugs and development on the master branch is expected to add new features but both share the "same workflow":http://ceph.com/docs/master/dev/development-workflow/.
4 16 Loïc Dachary
5 24 Loïc Dachary
h3. Overview of the backports in progress
6 24 Loïc Dachary
7 166 Nathan Cutler
* *luminous*
8 166 Nathan Cutler
** "complete":http://tracker.ceph.com/versions/545
9 166 Nathan Cutler
** "backport status":http://tracker.ceph.com/issues/21296
10 166 Nathan Cutler
** "backports":http://tracker.ceph.com/projects/ceph/issues?query_id=127
11 166 Nathan Cutler
** "pending issues":http://tracker.ceph.com/projects/ceph/issues?query_id=128
12 166 Nathan Cutler
** "pull requests":https://github.com/ceph/ceph/milestone/10
13 106 Loïc Dachary
* *jewel* 
14 152 Loïc Dachary
** "complete":http://tracker.ceph.com/versions/529
15 166 Nathan Cutler
** "backport status":http://tracker.ceph.com/issues/20613
16 73 Loïc Dachary
** "backports":http://tracker.ceph.com/projects/ceph/issues?query_id=96
17 141 Loïc Dachary
** "pending issues":http://tracker.ceph.com/projects/ceph/issues?query_id=97 
18 24 Loïc Dachary
** "pull requests":https://github.com/ceph/ceph/milestone/8
19 32 Loïc Dachary
20 32 Loïc Dachary
h3. Leads
21 35 Loïc Dachary
22 1 Loïc Dachary
* Ceph : Sage Weil
23 161 Loïc Dachary
* rados : Josh Durgin
24 32 Loïc Dachary
* radosgw / rgw : Yehuda Sadeh
25 167 Nathan Cutler
* CephFS / fs : Patrick Donnelly
26 60 Loïc Dachary
* RBD : Jason Dillaman
27 1 Loïc Dachary
28 1 Loïc Dachary
Note: It may be useful to know the leads of other projects which have a different lifecycle but depend on Ceph.
29 1 Loïc Dachary
30 1 Loïc Dachary
h3. Who's who
31 1 Loïc Dachary
32 167 Nathan Cutler
Members of the "stable releases team":http://tracker.ceph.com/projects/ceph-releases are assigned the following roles as of September, 2017.
33 162 Loïc Dachary
 
34 168 Nathan Cutler
| Name                | IRC nick       | v10.2.11  | v12.2.5  |
35 165 Nathan Cutler
| Abhishek Lekshmanan | theanalyst     | backup    | driver   |
36 165 Nathan Cutler
| Nathan Cutler       | smithfarm      | driver    | backup   |
37 165 Nathan Cutler
| TBA                 | TBA            | mentee    | mentee   |
38 75 Loïc Dachary
39 96 Loïc Dachary
* Mentee: during the course of a release the driver is available to help understand the stable release workflow
40 76 Loïc Dachary
* Driver: responsible for making sure the release is moving forward
41 76 Loïc Dachary
* Backup: helps the driver and replaces her/him when she/he is not available
42 76 Loïc Dachary
43 165 Nathan Cutler
* Sage Weil, Patrick Donnelly, Jason Dillaman, Josh Durgin, Yehuda Sadeh: leads
44 62 Loïc Dachary
45 26 Loïc Dachary
h3. HOWTO
46 23 Loïc Dachary
47 1 Loïc Dachary
The following describes in detail and in chronological order, the steps to follow for backporting and maintaining stable releases.
48 1 Loïc Dachary
49 23 Loïc Dachary
h4. Add a new stable release
50 19 Loïc Dachary
51 1 Loïc Dachary
* [[HOWTO start backporting a stable release]]
52 15 Loïc Dachary
53 23 Loïc Dachary
h4. Add a new point release
54 1 Loïc Dachary
55 19 Loïc Dachary
* [[HOWTO start working on a new point release]]
56 15 Loïc Dachary
57 23 Loïc Dachary
h4. Prepare a new point release
58 9 Loïc Dachary
59 43 Loïc Dachary
# [[HOWTO monitor the automated tests AKA nightlies]]
60 22 Loïc Dachary
# [[HOWTO schedule an issue for backporting]]
61 30 Loïc Dachary
# [[HOWTO document user visible changes]]
62 1 Loïc Dachary
# [[HOWTO backport commits]]
63 142 Nathan Cutler
# [[HOWTO review backport PRs]]
64 19 Loïc Dachary
# [[HOWTO populate the integration branch]]
65 1 Loïc Dachary
# [[HOWTO run integration and upgrade tests]]
66 46 Loïc Dachary
# [[HOWTO forensic analysis of integration and upgrade tests]]
67 112 Loïc Dachary
# [[HOWTO describe a test result]]
68 25 Loïc Dachary
# [[HOWTO merge commits from the integration branch]]
69 1 Loïc Dachary
# [[HOWTO synchronize pull requests from different repositories]]
70 27 Loïc Dachary
# [[HOWTO resolve issues that are Pending Backport]]
71 34 Loïc Dachary
# [[HOWTO get the Ceph lead to decide if it is time for a point release]]
72 31 Loïc Dachary
# [[HOWTO get the leads to sign-off on a release]]
73 33 Loïc Dachary
# [[HOWTO write the release notes]]
74 157 Loïc Dachary
# [[HOWTO keep backporting while the release branch is frozen]]
75 154 Abhishek Lekshmanan
76 123 Loïc Dachary
h4. Publish a release
77 38 Loïc Dachary
78 122 Loïc Dachary
* [[HOWTO publish a release]]
79 38 Loïc Dachary
80 23 Loïc Dachary
h4. Retire a stable release
81 15 Loïc Dachary
82 1 Loïc Dachary
* [[HOWTO retire a stable release]]
83 154 Abhishek Lekshmanan
84 154 Abhishek Lekshmanan
h4. Release management
85 155 Abhishek Lekshmanan
86 155 Abhishek Lekshmanan
* [[HOWTO formally announce release]]
87 156 Abhishek Lekshmanan
* [[HOWTO do dev checkpoint releases]]
88 41 Loïc Dachary
89 54 Nathan Cutler
h4. Recurring duties expected from backporters
90 52 Cron Tab
91 92 Loïc Dachary
* [[HOWTO triage incoming backport pull requests]]
92 58 Nathan Cutler
* [[HOWTO triage incoming Pending backport issues]]
93 52 Cron Tab
* "fill in the missing releases":http://tracker.ceph.com/projects/ceph/issues?query_id=84
94 56 Cron Tab
95 41 Loïc Dachary
h4. Organize the stable releases and backports team
96 41 Loïc Dachary
97 41 Loïc Dachary
* [[HOWTO become a new team member]]
98 41 Loïc Dachary
* [[HOWTO retire from the team]]