HOWTO » History » Revision 186
Revision 185 (Loïc Dachary, 03/30/2021 08:48 PM) → Revision 186/187 (Loïc Dachary, 04/21/2021 01:10 PM)
h3. Introduction 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. h3. Overview of the backports in progress * *pacific* ** "backports": https://tracker.ceph.com/projects/ceph/issues?query_id=223 ** "pull requests": https://github.com/ceph/ceph/milestone/14 * *octopus* ** "backports": http://tracker.ceph.com/projects/ceph/issues?query_id=199 ** "pending issues": http://tracker.ceph.com/projects/ceph/issues?query_id=215 ** "pull requests": https://github.com/ceph/ceph/milestone/13 * *nautilus* ** "backports": http://tracker.ceph.com/projects/ceph/issues?query_id=171 ** "pending issues": http://tracker.ceph.com/projects/ceph/issues?query_id=172 ** "pull requests": https://github.com/ceph/ceph/milestone/12 h3. Who's who Members of the "stable releases team":http://tracker.ceph.com/projects/ceph-releases as of March, 2021. | Name | IRC nick | | David Galloway | dgalloway | | Yuri Weinstein | yuriw | | Adam Kraitman | akraitman | | Nathan Cutler | smithfarm | | Loïc Dachary | loicd | 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":https://github.com/ceph/ceph/blob/master/SubmittingPatches-backports.rst # [[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. Retire a stable release * [[HOWTO retire a stable release]] h4. Release management * [[HOWTO cut a release]] (DEPRECATED) * [[HOWTO announce a release]] (DEPRECATED. See https://tracker.ceph.com/projects/ceph-releases/wiki/HOWTO_write_the_release_notes#E-mail-Release-Notes) * [[HOWTO do dev checkpoint releases]] * "HOWTO make a hotfix release":https://pad.ceph.com/p/hotfix-process * "HOWTO publish a release":https://docs.google.com/document/d/1VivEEKDbYiWu2gJEcFe37w6AtalmuKNJSq6T1ZlZva0 (requires permission) 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]]