Introduction¶
Backporting and the maintenance of a stable release begins when a new stable Ceph release 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 is published. This repeats until the the stable release is retired. Backporting is focused on fixing bugs and development on the master branch is expected to add new features. Both share a the same workflow with additional tools and methods dedicated to help with backports.
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
Who's who¶
Members of the stable releases team as of March, 2021.
Name | IRC nick |
David Galloway | dgalloway |
Yuri Weinstein | yuriw |
Adam Kraitman | akraitman |
Nathan Cutler | smithfarm |
Loïc Dachary | loicd |
HOWTO¶
The following describes in detail and in chronological order, the steps to follow for backporting and maintaining stable releases.
Add a new stable release¶
Add a new point release¶
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 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
Retire a stable release¶
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
- HOWTO publish a release release.pdf (this is a copy dated 21 April 2021, the source is here. (requires permission))
Recurring duties expected from backporters¶
- HOWTO triage incoming backport pull requests
- HOWTO triage incoming Pending backport issues
- fill in the missing releases
Organize the stable releases and backports team¶
Updated by Loïc Dachary about 3 years ago · 187 revisions