Contributing using Gerrit¶

Gerrit is a review tool that integrates nicely with git and ssh. Instead of manually uploading a change, one can push it for review. One can use ssh to trigger review and actions.

Subprojects using Gerrit¶

The following projects use Gerrit to contribute changes:

• libosmocore.git
• libosmo-abis.git
• libosmo-netif.git
• libsmpp34.git
• openbsc.git
• osmo-bts.git
• osmo-iuh.git
• osmo-pcu.git
• cellmgr-ng.git

Configuring Gerrit/Account¶

You will need to sign-up at https://gerrit.osmocom.org/login/. If you have an Osmocom Redmine account you can use https://osmocom.org/openid as OpenID provider. After the initial sign-up you will need to:

• Pick a username (can not be changed)
• Add your public ssh key(s)
• Add email addresses you intend to use as author/comitter

Setting up Gerrit for commits and pushing¶

• Add the remote to be able to fetch and push to gerrit
• Fetch the commit hook that adds Change-Id to each commit to uniquely identify a commit

git remote add gerrit ssh://USERNAME@gerrit.osmocom.org:29418/PROJECT.git
scp -P 29418 USERNAME@gerrit.osmocom.org:hooks/commit-hook .git/hooks/
git push gerrit HEAD:refs/for/master (push for review)
git push gerrit HEAD:refs/heads/user/topic (push a user branch)
git push gerrit HEAD:refs/heads/master (directly push to master if you are allowed to)
git ls-remote gerrit (to list all changesets and patches)