CrossProject:Integration Group:Hack Code

Intro

This is an overview on how to hack the Integration code

Make sure you have an account

In order to push code you will need to get an account.

Gerrit Setup

Code reviews are enabled through Gerrit. Set up Gerrit for use if you wish to use ssh. If you wish to use https, Set up Gerrit to use HTTPS.

Note: You will need to perform the Gerrit Setup before you can access git via ssh as described below.

Pull code via git CLI

Pull the code by cloning the controller repository.

First, all the lines below use the $ODL_USERNAME environment variable, so your life will be *way* easier of you set it with:

export ODL_USERNAME=<username for the account you created at OpenDaylight>

Then you will want to check out the code from each of the repos for each project. You can, of course select any one of the following lines if you are only looking for one project. Each line does three things:

Clone the git repo
Setup the Gerrit ChangeId commit hook
Setup pushes to go back to HEAD:refs/for/master as Gerrit requires

You have two choices for your method of engagement, you can use:

ssh on port 29418 (blocked by some firewalls)
https

1. Pull master code via ssh

git clone ssh://${ODL_USERNAME}@git.opendaylight.org:29418/integration/test.git
cd test
scp -p -P 29418 ${ODL_USERNAME}@git.opendaylight.org:hooks/commit-msg .git/hooks/
chmod 755 .git/hooks/commit-msg
git config remote.origin.push HEAD:refs/for/master
git config --global user.name "John Doe"
git config --global user.email johndoe@example.com

2. Pull master code with https

git clone https://git.opendaylight.org/gerrit/p/integration/test.git
cd integration
curl -o .git/hooks/commit-msg https://git.opendaylight.org/gerrit/tools/hooks/commit-msg
chmod 755 .git/hooks/commit-msg
git config remote.origin.push HEAD:refs/for/master
git config --global user.name "John Doe"
git config --global user.email johndoe@example.com

3. Checkout stable branch if needed

cd integration
git checkout stable/helium

4. Pull the latest code changes

Use git pull to get the latest changes from the remote repository

git pull

Hack the Code

It is highly recommended to make your changes in a local branch so that master is always in sync with remote:

git checkout -b test
Switched to a new branch 'test'

Integration repo is made of 3 folders:

distributions: release vehicles generation code
packaging: Linux package generation code (rpm, docker)
test: this is where we store the test code

To check the changes you are doing

git status
# On branch master
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#       test1
nothing added to commit but untracked files present (use "git add" to track)

Do not forget to add the changes to git

git add -A
git status
# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#       new file:   test1
#

Commit the code via git CLI

You do it this way

git commit --signoff

or in a shorter version:

git commit -s

You will be prompted for a commit message, and if you are fixing a bugzilla bug, you can add that to your commit message as well and it will get linked from the Gerrit:

Fix for bug 2.

Signed-off-by: Ed Warnicke <eaw@cisco.com>

# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#       modified:   README
#

Push the code via git CLI

Use git push to push your changes back to the remote repository. Also it is good idea to rebase your local repository before you push, especially if some time passed since last git pull. Check this link to learn how to do it.

git push

In case you want to push to stable branch:

git push origin HEAD:refs/for/stable/helium

You will get a message pointing you to your gerrit request like:

remote: Resolving deltas: 100% (2/2)
remote: Processing changes: new: 1, refs: 1, done    
remote: 
remote: New Changes:
remote:   http://git.opendaylight.org/gerrit/64
remote:

Seeing your change in Gerrit

Follow the link you got above to see your commit in Gerrit:

Note the Jenkins Integration User has verified your code, and at the bottom is a link to the Jenkins build.

Remember that your code must be reviewed at least by one committer (different than you) before merging to master. You can add reviewers for your code by using the buttom on the Review table.

Once your code has been reviewed and submitted by a committer it will be merged into the authoritative repo, which would look like this:

Undo commit keeping changes

If you wish to 'undo' your last commit use:

git reset --soft 'HEAD^'

Undo commit and changes

If you wish to 'reset' to the commit just before your last commit use:

git reset --hard 'HEAD^'

Amending your Commit

If you wish to 'amend' your commit and push a new PatchSet to your existing Gerrit, you can make your changes and do:

git add -A
git commit --amend
git push

More Information

Please check the GIT Cheat Sheet wiki