...
- Login into JIRA Page for Apache Ranger
- Review all unassigned JIRA(s) that are of your interest and pick a JIRA to work on.
- Send a note to dev community via via dev@ranger.apache.org to have a PMC member assign the JIRA to you.
- Once the JIRA is assigned to you, you can work on the Apache Ranger source on your local repo - to resolve the JIRA.
- Configure your git to use your username and email address. So when the patch is created, it will have your information and the code will have your credit.
After the JIRA is resolved, you can commit the changes to your local repo with commit comment with Apache JIRA number as follows:
Code Block $ git add <modified|add|deleted-files> $ git commit -m "RANGER-<JIRANUMBER>: <description of the JIRA fix>"
After you committed your change into your local repo, you should be able to create a patch using the following command:
Code Block $ git format-patch -n HEAD~
This command should create a git patch file under the current directory. Attach the patch file to the Apache JIRA and provide your comment about the solution. An Apache Ranger committer should be able to review your patch and provide feedback or commit to Apache Ranger.
Info If you have issues applying the patch correctly, please do the following:
git config diff.noprefix false
For additional information, please refer to discussions in RANGER-1739
You should upload the patch in https://reviews.apache.org/r/. Steps are:
Create an account in review board
Click on "New Review Request"
Search for "ranger" in the repository at the left
Upload your patch file
Give name and description. Add Apache JIRA # in review request title/name
- On the right side, give the JIRA number, select group "ranger"
- And publish the request.
- Attach the patch to Apache JIRA
- Provide the link to the review request in Apache JIRA
- Mark the fix version appropriately (if you know)
- If the patch is accepted, then one of the committer committers will commit your code.
- Update the JIRA with commit link once the patch is reviewed and committed
- Mark the review request as closed once the patch is committed
For pulling latest source changes from Apache Ranger, you can execute the following command to get latest code changes from remote apache Apache repo to your local repo:
Code Block $ git pull
FOR COMMITTERS: Those committing contributed code, please follow the below process after approving processafterapproving the code
Code Block language bash #Test whether the patch can be applied without errors git apply --check RANGER-xyz.patch #Apply the patch git am --signoff RANGER-xyz.patch #Push the changes git push
...