We follow most of the details as per the document here. If you are not aware of the github workflow, it is recommended to go through them before continuing here.
-
Fork Repository
- Fork GlusterFS repository.
-
Clone Repository
- Clone the glusterfs repo freshly from github using the steps below.
git clone git@github.com:${username}/glusterfs.git
cd glusterfs/
git remote add upstream git@github.com:gluster/glusterfs.git
About two tasks are one time for the life time. You can continue to use the same repository for all the work in future.
-
Issue:
- Make sure there is an issue filed for the task you are working on.
- If it is not filed, open the issue with all the description.
- If it is a bug fix, add label "Type:Bug".
- If it is an RFC, provide all the documentation, and request for "DocApproved", and "SpecApproved" label.
-
Code:
- Start coding
- Build and test locally
- Make sure clang-format is installed and is run on the patch.
-
Keep up-to-date
- GlusterFS is a large project with many developers, so there would be one or the other patch everyday.
- It is critical for developer to be up-to-date with
devel
repo to be Conflict-Free when PR is opened. - Git provides many options to keep up-to-date, below is one of them
git fetch upstream
git rebase upstream/devel
- It is recommended you keep pushing to your repo every day, so you don't loose any work.
- It can be done by
./rfc.sh
(orgit push origin HEAD:issueNNN
)
- It can be done by
-
Commit Message / PR description:
- The name of the branch on your personal fork can start with issueNNNN, followed by anything of your choice.
- PRs continue to have the title of format "component: <title>", like it is practiced now.
- When you open a PR, having a reference Issue for the commit is mandatory in GlusterFS.
- Commit message can have, either
Fixes: #NNNN
orUpdates: #NNNN
in a separate line in the commit message.- Here, NNNN is the Issue ID in glusterfs repository.
- Each commit needs the author to have the "Signed-off-by: Name <email>" line.
- Can do this by
-s
option forgit commit
.
- Can do this by
- If the PR is not ready for review, apply the label
work-in-progress
.- Check the availability of "Draft PR" is present for you, if yes, use that instead.
-
Tests:
- All the required smoke tests would be auto-triggered.
- Developers get a chance to retrigger the smoke tests using "/recheck smoke" as comment.
- The "regression" tests would be triggered by a comment "/run regression" from developers in the @gluster organization.
- Ask for help as comment in PR if you have any questions about the process!
- All the required smoke tests would be auto-triggered.
-
Review Process:
-
+2
: is equivalent to "Approve" from the people in the maintainer's group. -
+1
: can be given by a maintainer/reviewer by explicitly stating that in the comment. -
-1
: provide details on required changes and pick "Request Changes" while submitting your review. -
-2
: done by adding theDO-NOT-MERGE
label. -
Any further discussions can happen as comments in the PR.
-
-
Making changes:
- There are 2 approaches to submit changes done after addressing review comments.
- Commit changes as a new commit on top of the original commits in the branch, and push the changes to same branch (issueNNNN)
- Commit changes into the same commit with
--amend
option, and do a push to the same branch with--force
option.
- There are 2 approaches to submit changes done after addressing review comments.
-
Merging:
- GlusterFS project follows 'Squash and Merge' method
- This is mainly to preserve the historic Gerrit method of one patch in
git log
for one URL link. - This also makes every merge a complete patch, which has passed all tests.
- This is mainly to preserve the historic Gerrit method of one patch in
- The merging of the patch is expected to be done by the maintainers.
- It can be done when all the tests (smoke and regression) pass.
- When the PR has 'Approved' flag from corresponding maintainer.
- If you feel there is delay, feel free to add a comment, discuss the same in Slack channel, or send email.
- GlusterFS project follows 'Squash and Merge' method
This section details the process of becoming part of gluster.org team. The member list is reviewed by the current maintainers along with infra team time to time.
Words 'MUST', 'SHOULD' etc to be referred from RFC2119
- MUST have enabled two-factor authentication on their GitHub account
- MUST have read the contributor guide
- SHOULD have made multiple contributions to the project or community. Contribution may include, but is not limited to:
- Authoring or reviewing PRs on GitHub
- Filing or commenting on issues on GitHub
- Contributing to subproject, or community discussions (e.g. meetings, Slack, email discussion forums, Stack Overflow)
- SHOULD be subscribed to gluster-users, gluster-devel mailing lists.
- SHOULD be actively contributing to 1 or more subprojects for 30 days.
- Sponsored by 2 gluster-maintainers. Note the following requirements for sponsors:
- Sponsors must have close interactions with the prospective member - e.g. code/design/proposal review, coordinating on issues, etc.
- Sponsors must be the maintainer of an active repo in the Gluster org
- An approver/reviewer in the Gluster org may sponsor someone for the Gluster org; as long as it's a project they're involved with.
- Open an issue against the project-infrastructure repo
- With your github handle
- Ensure your sponsors are @mentioned on the issue or may be as approvers
- Have your sponsoring reviewers reply confirmation of sponsorship: +1
- Once your sponsors have responded, your request will be reviewed by the admin. Any missing information will be requested.
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
(b) The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
(c) The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
(d) I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved.