Project

General

Profile

Actions

Gerrit » History » Revision 9

« Previous | Revision 9/130 (diff) | Next »
neels, 05/14/2016 03:00 AM


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
  • libosmo-sccp.git
  • libsmpp34.git
  • openbsc.git
  • osmo-bts.git
  • osmo-iuh.git
  • osmo-pcu.git
  • cellmgr-ng.git
  • osmo-sip-connector.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
USERNAME=gerrit_user_name
PROJECT=$(basename $PWD)
git remote add gerrit ssh://$USERNAME@gerrit.osmocom.org:29418/$PROJECT.git
scp -P 29418 $USERNAME@gerrit.osmocom.org:hooks/commit-msg .git/hooks/
  • In case your local username matches the gerrit username, the setup shortens to
PROJECT=$(basename $PWD)
git remote add gerrit ssh://gerrit.osmocom.org:29418/$PROJECT.git
scp -P 29418 gerrit.osmocom.org:hooks/commit-msg .git/hooks/

Then

  • Push for review
    git push gerrit HEAD:refs/for/master
    
  • Push a user branch
    git push gerrit HEAD:refs/heads/users/$USERNAME/topic
    
  • Directly push to master if you are allowed to
    git push gerrit HEAD:refs/heads/master
    
  • List changesets in gerrit
    git ls-remote gerrit changes/*
    
Files (3)
osmo-gerrit.sh osmo-gerrit.sh 281 Bytes script to add gerit remote and change-id pre-commit hook laforge, 06/12/2018 05:06 PM
rules.pl rules.pl 646 Bytes osmith, 12/12/2018 11:26 AM
rules.pl rules.pl 646 Bytes merge at +3 (+2+1 / +1+1+1) osmith, 12/12/2018 11:33 AM

Updated by neels almost 8 years ago · 9 revisions

Add picture from clipboard (Maximum size: 48.8 MB)