HOWTO » History » Version 108
Loïc Dachary, 02/24/2016 01:56 AM
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 | |||
7 | 73 | Loïc Dachary | * *infernalis* |
8 | 84 | Loïc Dachary | ** "complete":http://tracker.ceph.com/versions/507 |
9 | 86 | Loïc Dachary | ** "backport status":http://tracker.ceph.com/issues/13750 |
10 | 73 | Loïc Dachary | ** "backports":http://tracker.ceph.com/projects/ceph/issues?query_id=82 |
11 | ** "pending issues":http://tracker.ceph.com/projects/ceph/issues?query_id=83 |
||
12 | ** "pull requests":https://github.com/ceph/ceph/pulls?q=is%3Aopen+is%3Apr+milestone%3Ainfernalis |
||
13 | 106 | Loïc Dachary | * *hammer* |
14 | 101 | Loïc Dachary | ** "complete":http://tracker.ceph.com/versions/511 |
15 | ** "backport status":http://tracker.ceph.com/issues/14692 |
||
16 | 73 | Loïc Dachary | ** "backports":http://tracker.ceph.com/projects/ceph/issues?query_id=78 |
17 | ** "pending issues":http://tracker.ceph.com/projects/ceph/issues?query_id=77 |
||
18 | ** "pull requests":https://github.com/ceph/ceph/pulls?q=is%3Aopen+is%3Apr+milestone%3Ahammer |
||
19 | 24 | Loïc Dachary | |
20 | 32 | Loïc Dachary | h3. Leads |
21 | |||
22 | 35 | Loïc Dachary | * Ceph : Sage Weil |
23 | 32 | Loïc Dachary | * rados : Samuel Just |
24 | * radosgw / rgw : Yehuda Sadeh |
||
25 | * CephFS / fs : Gregory Farnum |
||
26 | 102 | Loïc Dachary | * RBD : Jason Dillaman |
27 | 60 | Loïc Dachary | * build/ops : Ken Dreyer |
28 | 1 | Loïc Dachary | |
29 | 98 | Loïc Dachary | Note: It may be useful to know the leads of other projects which have a different lifecycle but depend on Ceph. |
30 | 1 | Loïc Dachary | |
31 | h3. Who's who |
||
32 | |||
33 | 97 | Loïc Dachary | Members of the "stable releases team":http://tracker.ceph.com/projects/ceph-releases are assigned the following roles as of February, 2016. |
34 | 93 | Loïc Dachary | |
35 | 107 | Loïc Dachary | | | v0.94.7 | v9.2.1 | v9.2.2 | v10.2.0 | |
36 | | Abhishek Lekshmanan | | backup | | backup | |
||
37 | | Abhishek Varshney | | driver | | driver | |
||
38 | | Nathan Cutler | driver | | | | |
||
39 | | Loic Dachary | backup | backup | backup | backup | |
||
40 | | Robin Hugh Johnson | | | | | |
||
41 | | M Ranga Swami Reddy | mentee | mentee | driver | | |
||
42 | 94 | Loïc Dachary | |
43 | 75 | Loïc Dachary | |
44 | 96 | Loïc Dachary | * Mentee: during the course of a release the driver is available to help understand the stable release workflow |
45 | 76 | Loïc Dachary | * Driver: responsible for making sure the release is moving forward |
46 | * Backup: helps the driver and replaces her/him when she/he is not available |
||
47 | |||
48 | 62 | Loïc Dachary | * Sage Weil, Samuel Just, Yehuda Sadeh, Gregory Farnum, Josh Durgin, Ken Dreyer : leads |
49 | |||
50 | 26 | Loïc Dachary | h3. HOWTO |
51 | 23 | Loïc Dachary | |
52 | 1 | Loïc Dachary | The following describes in detail and in chronological order, the steps to follow for backporting and maintaining stable releases. |
53 | |||
54 | 23 | Loïc Dachary | h4. Add a new stable release |
55 | 19 | Loïc Dachary | |
56 | 1 | Loïc Dachary | * [[HOWTO start backporting a stable release]] |
57 | 15 | Loïc Dachary | |
58 | 23 | Loïc Dachary | h4. Add a new point release |
59 | 1 | Loïc Dachary | |
60 | 19 | Loïc Dachary | * [[HOWTO start working on a new point release]] |
61 | 15 | Loïc Dachary | |
62 | 23 | Loïc Dachary | h4. Prepare a new point release |
63 | 9 | Loïc Dachary | |
64 | 43 | Loïc Dachary | # [[HOWTO monitor the automated tests AKA nightlies]] |
65 | 22 | Loïc Dachary | # [[HOWTO schedule an issue for backporting]] |
66 | 30 | Loïc Dachary | # [[HOWTO document user visible changes]] |
67 | 1 | Loïc Dachary | # [[HOWTO backport commits]] |
68 | 19 | Loïc Dachary | # [[HOWTO populate the integration branch]] |
69 | 1 | Loïc Dachary | # [[HOWTO run integration and upgrade tests]] |
70 | 46 | Loïc Dachary | # [[HOWTO forensic analysis of integration and upgrade tests]] |
71 | 19 | Loïc Dachary | # [[HOWTO describe a test result]] inline or [[HOWTO summarize test results]] in a separate issue |
72 | 25 | Loïc Dachary | # [[HOWTO merge commits from the integration branch]] |
73 | 1 | Loïc Dachary | # [[HOWTO synchronize pull requests from different repositories]] |
74 | 27 | Loïc Dachary | # [[HOWTO resolve issues that are Pending Backport]] |
75 | 34 | Loïc Dachary | # [[HOWTO get the Ceph lead to decide if it is time for a point release]] |
76 | 31 | Loïc Dachary | # [[HOWTO get the leads to sign-off on a release]] |
77 | 33 | Loïc Dachary | # [[HOWTO write the release notes]] |
78 | 15 | Loïc Dachary | |
79 | 38 | Loïc Dachary | h4. Publish a stable release |
80 | |||
81 | 39 | Loïc Dachary | * Study https://github.com/ceph/ceph-build/ and http://jenkins.ceph.com/ to figure out how it is used to update http://ceph.com/debian-hammer/ and http://ceph.com/rpm-hammer/ |
82 | 40 | Loïc Dachary | * The jenkins job is http://jenkins.ceph.com/job/ceph/ and requires some setup |
83 | 108 | Loïc Dachary | * A jenkins job does a bunch of things like "changing version numbers, creating a tag and pushing to the Jenkins GIT repository":https://github.com/ceph/ceph-build/blob/master/ceph/config/definitions/ceph.yml |
84 | * Once that process completes the binaries are HTTP POSTed to chacra.ceph.com following the "convention in the chacra docs":https://github.com/ceph/chacra#chacra |
||
85 | * Once those are there, Alfredo, ssh into signer.ceph.com pull the binaries from chacra, sign them and upload them into download.ceph.com |
||
86 | * The entire procedure is explained in a document that has not yet been released (Feb 2016). |
||
87 | 38 | Loïc Dachary | |
88 | 23 | Loïc Dachary | h4. Retire a stable release |
89 | 15 | Loïc Dachary | |
90 | 21 | Loïc Dachary | * [[HOWTO retire a stable release]] |
91 | 41 | Loïc Dachary | |
92 | 54 | Nathan Cutler | h4. Recurring duties expected from backporters |
93 | 52 | Cron Tab | |
94 | 92 | Loïc Dachary | * [[HOWTO triage incoming backport pull requests]] |
95 | 58 | Nathan Cutler | * [[HOWTO triage incoming Pending backport issues]] |
96 | 52 | Cron Tab | * "fill in the missing releases":http://tracker.ceph.com/projects/ceph/issues?query_id=84 |
97 | 56 | Cron Tab | |
98 | 41 | Loïc Dachary | h4. Organize the stable releases and backports team |
99 | |||
100 | * [[HOWTO become a new team member]] |
||
101 | * [[HOWTO retire from the team]] |