Gerrit is a free, web-based team code collaboration tool. Software developers in a team can review each other's modifications on their source code using a Web browser and approve or reject those changes. It integrates closely with Git, a distributed version control system
Before installing gerrit make sure you have
Install Gerrit locally
In our case we will use GerritHub
GerritHub is a public instance of Gerrit Code Review, which provides highly customisable sofisticated security. Whilst right now all GerritHub projects have shared a common public polity for all projects, you can customise your Gerrit project security and further restrict or extends the default permissions.
- Visit this link
- Click Signin and follow the steps
When working with a GerittHub repository, you'll often need to identify yourself to GerritHub using your username and password. An SSH key is an alternate way to identify yourself that doesn't require you to enter you username and password every time.
SSH keys come in pairs, a public key that gets shared with services like GerritHub, and a private key that is stored only on your computer. If the keys match, you're granted access.
- Generating an SSH key pair
$ ssh-keygen -t rsa -C "gerrituser@example.com"
> Generating public/private rsa key pair.
> Enter file in which to save the key (/Users/username/.ssh/id_rsa):
> Enter passphrase (empty for no passphrase):
> Enter same passphrase again:
- Add your public key to GerritHub
$ cat ~/.ssh/id_rsa.pub
The output should look something like this:
ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA879BJGYlPTLIuc9/R5MYiN4yc/YiCLcdBpSdzgK9Dt0Bkfe3rSz5cPm4wmehdE7GkVFXrBJ2YHqPLuM1yx1AUxIebpwlIl9f/aUHOts9eVnVh4NztPy0iSU/Sv0b2ODQQvcy2vYcujlorscl8JjAgfWsO3W4iGEe6QwBpVomcME8IU35v5VbylM9ORQa6wvZMVrPECBvwItTY8cPWH3MGZiK/74eHbSLKA4PY3gM4GHI450Nie16yggEg2aTQfWA1rry9JYWEoHS9pJ1dnLqZU3k/8OWgqJrilwSoC5rGjgp93iu0H8T6+mEHGRQe84Nk1y5lESSWIbn6P636Bl3uQ== your@email.com
Copy the contents of the output to your clipboard.
- Go to Settings
- Select SSH-Keys from the side menu
- Paste the contents of your clipboard into the Key text box.
- Test connection
$ ssh -p 29418 <username>@review.gerrithub.io
**** Welcome to Gerrit Code Review ****
Hi Younes Lamkhanter, you have successfully connected over SSH.
Unfortunately, interactive shells are disabled.
To clone a hosted Git repository, use:
git clone ssh://<username>@review.gerrithub.io:29418/REPOSITORY_NAME.git
Connection to review.gerrithub.io closed.
- Clone repository on local machine
$ git clone "ssh://Jonas56@review.gerrithub.io:29418/Jonas56/Blog" && scp -p -P 29418 Jonas56@review.gerrithub.io:hooks/commit-msg "Blog/.git/hooks/"
- Create a local branch
$ cd Blog
$ git checkout -b feature:test
-
Make your changes
-
Satge and Commit changes
$ git add README.md
$ git commit -m "Feature test"
- Push changes to HEAD:refs/for/feature:test
$ git push origin HEAD:refs/for/feature:test
- Switch to Gerrit UI
- Add reviewers to review my code
- Submit code review
- Switch to your github repository and your changes will be made