Project

General

Profile

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 but both share the same workflow.

Overview of the backports in progress

Leads

  • Ceph : Sage Weil
  • rados : Josh Durgin
  • radosgw / rgw : Yehuda Sadeh
  • CephFS / fs : John Spray
  • RBD : Jason Dillaman
  • build/ops : Ken Dreyer

Note: It may be useful to know the leads of other projects which have a different lifecycle but depend on Ceph.

Who's who

Members of the stable releases team are assigned the following roles as of December, 2016.

Name IRC nick v0.94.10 v10.2.6 v11.2.1
Abhishek Lekshmanan theanalyst backup
Abhishek Varshney abhishekvrshny driver
Nathan Cutler smithfarm driver
Loic Dachary loicd backup backup
  • 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, Josh Durgin, Yehuda Sadeh, John Spray, Jason Dillaman: leads

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

  1. HOWTO monitor the automated tests AKA nightlies
  2. HOWTO schedule an issue for backporting
  3. HOWTO document user visible changes
  4. HOWTO backport commits
  5. HOWTO review backport PRs
  6. HOWTO populate the integration branch
  7. HOWTO run integration and upgrade tests
  8. HOWTO forensic analysis of integration and upgrade tests
  9. HOWTO describe a test result
  10. HOWTO merge commits from the integration branch
  11. HOWTO synchronize pull requests from different repositories
  12. HOWTO resolve issues that are Pending Backport
  13. HOWTO get the Ceph lead to decide if it is time for a point release
  14. HOWTO get the leads to sign-off on a release
  15. HOWTO write the release notes
  16. HOWTO keep backporting while the release branch is frozen

Publish a release

Retire a stable release

Release management

Recurring duties expected from backporters

Organize the stable releases and backports team