HOWTO » History » Revision 168
Revision 167 (Nathan Cutler, 09/12/2017 09:26 PM) → Revision 168/187 (Nathan Cutler, 04/05/2018 07:30 PM)
h3. Introduction 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/. h3. Overview of the backports in progress * *luminous* ** "complete":http://tracker.ceph.com/versions/545 ** "backport status":http://tracker.ceph.com/issues/21296 ** "backports":http://tracker.ceph.com/projects/ceph/issues?query_id=127 ** "pending issues":http://tracker.ceph.com/projects/ceph/issues?query_id=128 ** "pull requests":https://github.com/ceph/ceph/milestone/10 * *jewel* ** "complete":http://tracker.ceph.com/versions/529 ** "backport status":http://tracker.ceph.com/issues/20613 ** "backports":http://tracker.ceph.com/projects/ceph/issues?query_id=96 ** "pending issues":http://tracker.ceph.com/projects/ceph/issues?query_id=97 ** "pull requests":https://github.com/ceph/ceph/milestone/8 h3. Leads * Ceph : Sage Weil * rados : Josh Durgin * radosgw / rgw : Yehuda Sadeh * CephFS / fs : Patrick Donnelly * RBD : Jason Dillaman Note: It may be useful to know the leads of other projects which have a different lifecycle but depend on Ceph. h3. Who's who Members of the "stable releases team":http://tracker.ceph.com/projects/ceph-releases are assigned the following roles as of September, 2017. | Name | IRC nick | v10.2.11 v10.2.10 | v12.2.5 v12.2.1 | | Abhishek Lekshmanan | theanalyst | backup | driver | | Nathan Cutler | smithfarm | driver | backup | | TBA | TBA | mentee | mentee | * Mentee: during the course of a release the driver is available to help understand the stable release workflow * Driver: responsible for making sure the release is moving forward * Backup: helps the driver and replaces her/him when she/he is not available * Sage Weil, Patrick Donnelly, Jason Dillaman, Josh Durgin, Yehuda Sadeh: leads h3. HOWTO The following describes in detail and in chronological order, the steps to follow for backporting and maintaining stable releases. h4. Add a new stable release * [[HOWTO start backporting a stable release]] h4. Add a new point release * [[HOWTO start working on a new point release]] h4. Prepare a new point release # [[HOWTO monitor the automated tests AKA nightlies]] # [[HOWTO schedule an issue for backporting]] # [[HOWTO document user visible changes]] # [[HOWTO backport commits]] # [[HOWTO review backport PRs]] # [[HOWTO populate the integration branch]] # [[HOWTO run integration and upgrade tests]] # [[HOWTO forensic analysis of integration and upgrade tests]] # [[HOWTO describe a test result]] # [[HOWTO merge commits from the integration branch]] # [[HOWTO synchronize pull requests from different repositories]] # [[HOWTO resolve issues that are Pending Backport]] # [[HOWTO get the Ceph lead to decide if it is time for a point release]] # [[HOWTO get the leads to sign-off on a release]] # [[HOWTO write the release notes]] # [[HOWTO keep backporting while the release branch is frozen]] h4. Publish a release * [[HOWTO publish a release]] h4. Retire a stable release * [[HOWTO retire a stable release]] h4. Release management * [[HOWTO formally announce release]] * [[HOWTO do dev checkpoint releases]] h4. Recurring duties expected from backporters * [[HOWTO triage incoming backport pull requests]] * [[HOWTO triage incoming Pending backport issues]] * "fill in the missing releases":http://tracker.ceph.com/projects/ceph/issues?query_id=84 h4. Organize the stable releases and backports team * [[HOWTO become a new team member]] * [[HOWTO retire from the team]]