Project

General

Profile

Gerrit » History » Revision 3

Revision 2 (zecke, 05/08/2016 05:53 PM) → Revision 3/130 (zecke, 05/08/2016 10:14 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 
 * 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 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) 
 </pre>
Add picture from clipboard (Maximum size: 48.8 MB)