Project

General

Profile

Gerrit » History » Version 1

Version 1/112 - Next » - Current version
zecke, 05/08/2016 05:51 PM


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 git remote add gerrit ssh://USERNAME@gerrit.osmocom.org:29418/PROJECT.git
  • Fetch a commit hook to auto add "Change-Id: ...". scp -P 29418 USERNAME@gerrit.osmocom.org:hooks/commit-hook .git/hooks/
  • Push your current branch to be considered for master git push gerrit HEAD:refs/for/master
  • Push a work in progress user branch git push gerrit HEAD:refs/heads/user/topic
Add picture from clipboard (Maximum size: 48.8 MB)