- Checkout Code from: http://git-wip-us.apache.org/repos/asf/ambari.git
- Open an Apache Jira corresponding to the internal Jira
Please make sure you use the external jira for most of the design updates (adding detailed descriptions, comments, etc)
Create a patch and upload to the external jira
As soon as you think the patch is ready for review please mark the patch as Patch Available by clicking on the “Submit Patch” button
Request 2 of the Ambari Team Committers to review the patch via the code review process below
Please note that if the patch is not involved - one committer should suffice
On review completion and any further updates, the reviewer adds a comment to the external jira approving the patch (“+1”)
NOTE: On backend changes reviewers please make sure tests are attached to each jira. If there is special case, please make sure there is a good explanation for not having a test case.
After the reviewer has approved the patch, the person who is assigned the jira is responsible for getting it committed to external jira - so in case you do not have commit rights please find one of your team members to do it for you.
Use https://cwiki.apache.org/confluence/display/AMBARI/How+to+Commit on how to commit to svn
After committing to svn, resolve the external and internal Jiras as Fixed.
All unit tests must pass after applying the patch.
Also, any new files must contain Apache 2.0 license headers
Do not use tabs. Set your IDE to convert tabs into spaces instead.
Do not use non-ASCII characters
Do not use Windows newline characters. Use UNIX newline characters instead.
Make sure that you are checking in all dependencies/new files; after committing, the build should work on clean checkout
Make sure that the clock is set up correctly on your machine.
Ambari uses ReviewBoard for code reviews.
All Ambari related code reviews, at ReviewBoard, can be found at https://reviews.apache.org/groups/Ambari/
Using ReviewBoard
You may need to create a ReviewBoard login. Once you login add yourself to the "Ambari" group.
To submit a patch for review
- Click on "New Review Request"
- Select "ambari" from the drop-down and upload a diff file
- Go to the next page
- Add a summary
- Names of two reviewers (only one +1 is necessary for commit)
- Select ambari as the group
- Type in the Ambari JIRA id
- Add description of the fix
- Add a link to the ReviewBoard URL to the JIRA
- [if applicable] Fill the optional fields as needed.
- [if applicable] Add the unit test summary to the request
- Publish the review
- After the review is marked "Ship It" you can optionally attach the final patch to the JIRA.
For reviewers
Reviewers, after you are satisfied with the patch, mark "Ship It" through the ReviewBoard as well as add a "+1" to the JIRA.