2015/07/20 - Apache Deltacloud has been retired.

• How to contribute? /
• Send a pull request

GIT Workflow and sending a pull request

---

Basics

• Deltacloud uses Github for pull requests and patch reviews.
• The deltacloud/deltacloud-core repository is just a mirror for the official ASF GIT repository.
• The mirror script runs every 2 minutes so please be patient.
• In order to have your patch accepted and pushed, you need to have signed the Apache Individual Contributor License Agreement
• We use the official ASF repository for pushing patches (you need to be an ASF contributor with push rights for this), or you need to ask somebody with push rights to do so. If you are not Deltacloud API ASF project member with push rights, please ignore this information and issue a pull request for someone to push for you.

---

Adding Deltacloud Github repository

• Fork the "deltacloud/deltacloud-core" repository by click on the Fork tab at the top of the page
  
  
  
  
  
  
  
  
  
• Clone your fork

    $ git clone https://github.com/your username/deltacloud-core.git
    

• Configure remotes

    $ cd deltacloud-core
    $ git remote add upstream https://github.com/deltacloud/deltacloud-core.git
    $ git fetch upstream
    

• For more details on forking git repositories see: The Official GitHub Help Fork A Repo

---

Basic GIT workflow

• Commit some code changes

    $ git checkout -b my branch
    Coding your changes
    $ git commit -m "Commit message"
    

• Tip: If there is a JIRA ticket associated with this work please include the JIRA ID in the commit message
  For example: This change addresses: DTACLOUD-123

• Repeat the previous step until you finish the needed changes.

---

Pushing your work

• Update the original repo
  
  

  This will avoid possible merge conflicts and problems with applying your patches.

      $ git checkout master
      $ git pull
      

• Push to your fork.

      $ git checkout my_work_topic
      $ git rebase -i master (Tip: You can rename/squash commits at this point)
      $ git push origin my_work_topic
      

---

Issue the Pull request

• Navigate to your forked Github repository
  For example:https://github.com/your username/deltacloud-core.git
• click the Pull Request tab
(Tip: You can use hub to automate this step)

• For more details on using pull requests see: The Official GitHub Help For Using Pull Request

---

Pull request / review process

• Your pull request will appear here
• All subscribers will be notified by email that a new pull request has been issued.
• When doing a review please follow our coding guidelines
• Reviewers can leave comments on your pull request directly on github.
• Help on reviewing github pull requests can be found here
• If your pullrequest is not being reviewed, please request one on the #deltacloud IRC channel on irc.freenode.org
• Once your pull request gets ACKed, the person who did the review should close the pull request without merging it.
• The reviewer, or someone with push rights, should push the change to the official Apache GIT repository:
  https://github.com/apache/deltacloud
• No changes should be pushed to the mirror used to create your fork,
  https://github.com/deltacloud/deltacloud-core

---

Contributors with push rights

• Adding ASF as a remote branch

      $ git remote add apache https://git-wip-us.apache.org/repos/asf/deltacloud.git
      $ git fetch apache
      $ git checkout -b apache apache/master
      

• Pushing patches

      $ git checkout topic_you_want_to_push
      $ git rebase -i apache
      $ git checkout apache
      $ git merge topic_you_want_to_push
      $ git push apache refs/heads/apache:master
      

• Note: Do not forget to git pull from the apache branch before merging changes

• Tip: To make all pull requests appear in your local GIT repository follow these instructions.
  
  Then to get all pull requests locally issue:

         $ git fetch origin
         

  Then to checkout a single pull request directly issue:

         $ git checkout pr/NUMBER
         

  instead of issueing:

         $ git checkout topic_you_want_to_push
         

  
  
  
  
  Close