The Git repositories

The jclouds Git repositories are hosted in the ASF infrastructure, but there are also mirrors in Github. This is the current repository layout:  

 

Apache

https://gitbox.apache.org/repos/asf?s=jclouds

The main and official repositories

Github

https://github.com/apache/jclouds

Mirrors from the ASF repositories, used to accept contributions and do code reviews

Rules of thumb

  1. Every contribution is a piece of intellectual property. This is the precious sustenance that nourishes our project. Please treat it with respect. If it's sufficiently complex, or from a large corporate entity, ensure there is an ICLA or CCLA on file that covers the contribution. Asking in #jclouds or #asf will probably be the easiest way to get an answer. 

  2. ALWAYS give credit where it is due, ensure EVERY merged commit reflects properly the individual who authored that commit. Preserve both the name and email address. 

  3. Ensure your name and email address are there as the committer prior to pushing it to the Apache repositories. Please read the 'which hat' guide before deciding whether to use your @apache.org, personal or other email address. 

  4. Always strive for linear commit history, avoid merge commits while pulling in contributor's changes.

Committing the changes to the ASF repo

From a GitHub pull request  

Just merge it normally from the GitHUb site.

From a patch file

1. Save the patch from the Github patch link (just append '.patch' to the pull request link to get it). This patch will keep the authorship of the commit, so we should use it instead of the diff. 

2. If the commit message needs to be edited, edit it in the patch file. 

3. Pull the changes in the ASF repository to make sure you have the latest version of the master branch. 

git remote add asf https://gitbox.apache.org/repos/asf/jclouds.git
git fetch asf
git checkout master
git rebase asf/master

4. Apply the patch preserving the original author: 

git am JCLOUDS-XX.patch

5. Run a build to make sure everything works as expected after applying the patch and push the changes once the build succeeds. 

mvn clean install
git push asf master

6. If there are no issues with the applied patch, attach the patch file to the JIRA issue, and mark it as Resolved. 

7. Close the pull request and leave a comment saying it has been merged.

  • No labels