Gerrit » History » Revision 4
Revision 3 (zecke, 05/08/2016 10:14 PM) → Revision 4/130 (zecke, 05/09/2016 09:35 PM)
h1. 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.
h2. Subprojects using Gerrit
The following projects use Gerrit to contribute changes:
* libosmocore.git
* libosmo-abis.git
* libosmo-netif.git
* libosmo-sccp.git
* libsmpp34.git
* openbsc.git
* osmo-bts.git
* osmo-iuh.git
* osmo-pcu.git
* cellmgr-ng.git
h2. 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
h2. 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
<pre>
git remote add gerrit ssh://USERNAME@gerrit.osmocom.org:29418/PROJECT.git
scp -P 29418 USERNAME@gerrit.osmocom.org:hooks/commit-msg .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)
</pre>