Gerrit introduction // Gerrit 简介

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 (from wikipedia)

Gerrit，一种免费、开放源代码的代码审查软件，使用网页界面。利用网页浏览器，同一个团队的软件程序员，可以相互审阅彼此修改后的程序代码，决定是否能够提交，退回或者继续修改。它使用Git作为底层版本控制系统。 （from 百度百科）

Gerrit Configure&Install // Gerrit 审核系统搭建过程

create gerrit2 user // 创建gerrit2用户

$sudo useradd -m -d /home/gerrit2 -s /bin/bash gerrit2

$sudo su gerrit2

Setup mysql&&java environment // 安装mysql以及java环境

apt-get

Configure mysql // 配置mysql

#mysql -u root –p
Mysql>
#CREATE USER 'gerrit2'@'localhost' IDENTIFIED BY 'secret';
#CREATE DATABASE reviewdb;
#ALTER DATABASE reviewdb charset=latin1;
#GRANT ALL ON reviewdb.* TO 'gerrit2'@'localhost';
#FLUSH PRIVILEGES;

Install gerrit and Init // 下载gerrit并进行初始化

$wget http://gerrit-releases.storage.googleapis.com/gerrit-2.7.war
$java -jar gerrit-2.7.war init -d review_site

refer to http://www.infoq.com/cn/articles/Gerrit-jenkins-hudson/
Create '/home/gerrit2/review_site' [Y/n]? Y
Location of Git repositories [git]:
Database server type [h2]: mysql

Gerrit Code Review is not shipped with MySQL Connector/J 5.1.21
** This library is required for your configuration. **
Download and install it now [Y/n]? Y
Downloading http://repo2.maven.org/maven2/mysql/mysql-connector-java/5.1.21/mysql-connector-java-5.1.21.jar
Checksum mysql-connector-java-5.1.21.jar OK
Server hostname [localhost]:
Server port [(mysql default)]:
Database name [reviewdb]:
Database username [gerrit2]:
gerrit2's password : secret
confirm password :
SMTP server hostname [localhost]:
SMTP server port [(default)]:
SMTP encryption [NONE/?]:
SMTP username :

Run Gerrit // 运行gerrit审核系统

$ ./review_site/bin/gerrit.sh start

Login gerrit

default port number：8080

Change gerrit color // 修改gerrit界面颜色

By default the screen color is white which is not what i like. The color configuration change is as bellow:
默认情况下是纯白色的，不美观可以对 review_site/etc/gerrit.config 修改，然后重启服务，下面是一个颜色配置模板：

[theme]

backgroundColor = FCFEEF

textColor = 000000

trimColor = D4E9A9

selectionColor = FFFFCC

topMenuColor = D4E9A9

changeTableOutdatedColor = F08080

[theme "signed-in"]

backgroundColor = FCFEEF

textColor = 000000

trimColor = D4E9A9

selectionColor = FFFFCC

topMenuColor = D4E9A9

changeTableOutdatedColor = F08080

More info refer to https://gerrit-review.googlesource.com/Documentation/config-gerrit.html#_a_id_theme_a_section_theme

Gerrit test // Gerrit 系统正常测试

ssh -p 29418 username@webhost to test whether gerrit is running well，based on http://www.infoq.com/cn/articles/Gerrit-jenkins-hudson/, we can do some ssh configuration，It would show these following info after success：

**** Welcome to Gerrit Code Review ****

Hi demo, you have successfully connected over SSH.

Unfortunately, interactive shells are disabled.
To clone a hosted Git repository, use:

git clone ssh://demo@localhost:29418/REPOSITORY_NAME.git

Connection to localhost closed.

Create the first project // Gerrit创建第一个项目

ssh -p 29418 admin@localhost gerrit create-project --name example.git

Github+gerrit+Jenkins(hudson) +redmine

Responsibility // 职责：

GitHub is a resource for managing Git code repositories and interacting with other developers. Jenkins is used to continuously test all of the components of OpenStack to ensure functionality and to verify that each change to the code base works as intended. Gerrit is a code review system originally developed for use by the Android Open Source Project and allows us to build a workflow where every change is peer-reviewed and tested by Jenkins before being merged into the main repository.

Workflow // 工作流：

developer checks out source from github.
developer makes changes.
developer pushes to gerrit.
gerrit sends change notice to jenkins for integration test.
jenkins pulls changes directly from gerrit git server.
on pass, jenkins adds +1 to gerrit review, passes review to other developers.
on failure, jenkins adds -1 to gerrit review
pass/fail status pushed to redmine
other developers review change, approve (+2)
gerrit commits changes to github repository.
github hook notifies redmine of updates.
redmine pulls changes from github, parses commit messages for ticket information.
developer fetchs changes from github ... back to 2. [EDIT]: we switched to pulling directly from gerrit. Github remains as a mirror for pulling production sources.
Run Jenkins

Based on https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger, we can configure jenkins and Gerrit

jenkins + github http://blog.csdn.net/john_cdy/article/details/7738393

java -jar jenkins.war --httpPort=$PORT --httpListenAddress=$HTTP_HOST

how to use jenkins: https://wiki.jenkins-ci.org/display/JENKINS/Use+Jenkins

http://fourkitchens.com/blog/2011/09/20/trigger-jenkins-builds-pushing-github

Available Links：

Jenkins 学习：http://www.cnblogs.com/itech/archive/2011/11/23/2260009.html

Gerrit 学习：http://ci.openstack.org/gerrit.html （介绍了OpenStack源代码开发维护更新流程！）

Gerrit introduction: http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/intro-quick.html

Gerrit installation: http://gerrit.googlecode.com/svn/documentation/2.1.6/install.html

Git、Gerrit与Jenkins/Hudson CI服务器:

http://www.infoq.com/cn/articles/Gerrit-jenkins-hudson/

GerritJenkinsGithub: https://wiki.openstack.org/wiki/GerritJenkinsGithub

Ideas and Actions: https://groups.google.com/forum/#!msg/repo-discuss/rersrCtdEiY/usAodLofFo8J

Gerrit 工作流： https://wiki.openstack.org/wiki/GerritWorkflow

git diff 的用法： http://blog.sina.com.cn/s/blog_40e9d4dd0100xi8p.html

git rebase用法: http://www.cnblogs.com/kym/archive/2010/08/12/1797937.html

Gerrit 安装：http://ci.openstack.org/gerrit.html

图解GIT： http://nettedfish.sinaapp.com/blog/2013/08/05/deep-into-git-with-diagrams/