[Governance Review]: CubeFS

[leonrayang]

Project Name

CubeFS

Project Website

https://cubefs.io/

Contact Details 1

[email protected]

Contact Details 2

[email protected]

Links to communication channels

cubefs.slack.com

Reason for governance review request

Application for moving levels from Incubation to Graduation

Are there any sub-projects, plugins, and related?

No, https://github.com/cubefs/cubefs is the main project. In addition, the remaining repositories primarily focus on hosting essential components and providing solutions.

Governance model

CubeFS largely adheres to the CNCF governance template and is further improved compared to the template.

• CubeFS is governed by a steering committee responsible for overall project planning.
• The steering committee holds regular meetings to review and formally represent the voice of the community. As long as there is sufficient consensus, obtaining recognition from existing maintainers, and receiving approval through a vote by the steering committee, anyone can become a maintainer.
• Maintainers are responsible for maintaining and iterating on project kernel modules, while committers contribute to version development, key module design, and community maintenance.
• The steering committee members are core maintainers.
• CubeFS is building SIGs, which are responsible for non-core modules or items of the project, such as documentation, integration with Kubernetes for management or deployment-related matters, and other related topics. The members and appointment rules of SIGs have also passed public reviews, and they will be updated in the governance document in the future.

Governance documents

• Project purpose
  File storage and object storage are key in the storage domain. CubeFS is a file storage system that provides cloud-native file system capabilities and is compatible with object storage. Moreover, it offers a multitude of competitive features and capabilities.
  • CubeFS Introduction: link
  • The project’s differentiation is the main feature of CubeFS: link to md#section
• Maintainer List (with employer information)
  Maintainers of CubeFS coming from JD, OPPO, BEIKE etc.: link to md#section
• How your project is making decisions
  Decision making process on leadership roles: link to md#section
• How and when contributors are moving through the contributor ladder (e.g. becoming a maintainer)
  How to become a maintainer: link to md#section
• Maintainer life cycle with information about how and when maintainers are demoted
  Document changes in maintainership,onboarding, offboarding: link to md#section
• Code of Conduct link to md#section
• Contributor Guide link
• How your community conduct communication and meetings
  • The communication channels for all CubeFS projects are shared: link
  • CubeFS Meeting-Schedule: link
  • CubeFS meeting schedulers already added to CNCF calendar: link
• How your community handles security reporting and response link
• Who owns what code and docs

  • Maintainers have expertise in the domain fields of the project and are listed in the maintainer documentation.link to md#section

  • The top 6 contributors with the highest number of contributions are all maintainers.link

Governance Execution Examples

• Voting
  Governance has continuously been iterated upon by the project as a result of their experience applying it, with the governance history demonstrating evolution of maturity alongside the project's maturity evolution.

  • Update the document of the roadmap to improve readability and include features that are in preparation but not yet scheduled: feat(doc): "Update the document of the roadmap to improve readability and include features that are in preparation but not yet scheduled. cubefs/cubefs#3358
  • The establishment of the Steering Committee and clarification of its members in CubeFS: feat(doc): Update maintainer list according to activity and add steering commitee member… cubefs/cubefs#3311 (comment)
  • Update the Governance Document by most of maintainers: feat(doc): Update the Governance Document cubefs/cubefs#3312
  • Update the Governance Document to eliminate the role of the leader:feat(doc): Update the Governance Document cubefs/cubefs#3382
  • Update maintainer list according to activity and add steering commitee member: feat(doc): Update maintainer list according to activity and add steering commitee member… cubefs/cubefs#3311
  • Update the Governance Document to add governance rules related to SIGs.: link to pr
  • Update the Governance Document to add governance rules related to RoadMap.: link to pr

• Promoting a contributor / demoting a maintainer

  • Add a commiter feat(doc): Add Chuanqing Zhang to be a committer. cubefs/cubefs#3386
  • The latest personnel changes are based on the new governance document and voting principles.feat(doc): Update maintainer list according to activity and add steering commitee member… cubefs/cubefs#3311
  • Historical changes: The maintainer update is due to insufficient activity levels from many individuals.update(docs):Update maintainers cubefs/cubefs#3044

• Security response

  • Please reference: link to md#section
  • CubeFS have passed the Third Party Security Review: link
  • Some advisories already be fixed link

• Meeting recordings

  • CubeFS Meeting-Schedule: link
  • CubeFS meeting schedulers already added to CNCF calendar: link

Governance Evolution

Governance has continuously been iterated upon by the project as a result of their experience applying it, with the governance history demonstrating evolution of maturity alongside the project's maturity evolution.
- The establishment of the Steering Committee and clarification of its members in CubeFS: cubefs/cubefs#3311 (comment)
- Update the Governance Document by most of maintainers: cubefs/cubefs#3312
- Update the Governance Document to eliminate the role of the leader:cubefs/cubefs#3382
- Add a commiter through voting by steer committe and maintainers : cubefs/cubefs#3386
- Adding governance rules related to SIGs.: link to pr
- Adding governance rules related to RoadMap.: link to pr

Any specific aspects of your governance structure are you seeking feedback on?

No response

Do you have any concerns or specific areas where you feel your governance could be improved?

No response

Additional notes and resources

No response

[aliok]

@leonrayang

For transparency, I've started this assessment. Here's my working document: https://docs.google.com/document/d/1xd8hCw0O-RiotwO5A046UFU1l_9XLhDK2ZxfVAUa0rg/edit

However, you don't have to start addressing the issues in the document right now. That's not the purpose of this document at this stage.

I am using a commit (https://github.com/cubefs/cubefs/tree/1536a544f2d9547647ad4e260edade60163e3585) and I won't see the changes you make.

Feel free to add comments in the document, if you think I misunderstood some things.

cc @jberkus @geekygirldawn

[leonrayang]

@leonrayang

For transparency, I've started this assessment. Here's my working document: https://docs.google.com/document/d/1xd8hCw0O-RiotwO5A046UFU1l_9XLhDK2ZxfVAUa0rg/edit

However, you don't have to start addressing the issues in the document right now. That's not the purpose of this document at this stage.

I am using a commit (https://github.com/cubefs/cubefs/tree/1536a544f2d9547647ad4e260edade60163e3585) and I won't see the changes you make.

Feel free to add comments in the document, if you think I misunderstood some things.

cc @jberkus @geekygirldawn

@aliok
We greatly appreciate your work. I have responded to some of your comments to clarify certain points for your understanding. Of course, I also believe that most comments need us to further clarify and optimize. Thank you very much!

[leonrayang]

@aliok

Hi aliok,

I proposed the governance review in the TCS a few days ago and greatly appreciate your work.
We have now made adjustments and additions based on your suggestions.
Please take a look at the document

This is the pull request that update the governance-related documentation based on your recommendations:
cubefs/cubefs#3478

[leonrayang]

Hi @aliok @riaankleinhans
Here is the link to the Governance Review Tracking issue. cubefs/cubefs#3530