Gerrit常用的几条命令

gerrit作为代码评审工具，还是挺受人欢迎的，尤其在AOSP代码管理方面，今天简单介绍几个常用命令

在使用gerrit命令时，请确保用户在管理员组内，或者拥有相关权限

此处假设gerrit ip 为 192.167.100.200, 管理员为 admin，默认端口为 29418

1.安装类

//安装 gerrit-2.12.3.war 到 review_site
$ java -jar gerrit-2.12.3.war init -d review_site

// 安装工具（replication），默认自动安装，若第一次没有安装，则可以安装
//(常用插件commit-message-length-validator，download-commands，replication，reviewnotes，singleusergroup)
$ java -jar gerrit-2.12.3.war init -d review_site --batch --install-plugin replication
$ java -jar gerrit-2.12.3.war init -d review_site --batch --install-plugin reviewnotes
$ java -jar gerrit-2.12.3.war init -d review_site --batch --install-plugin singleusergroup
$ java -jar gerrit-2.12.3.war init -d review_site --batch --install-plugin download-commands
$ java -jar gerrit-2.12.3.war init -d review_site --batch --install-plugin commit-message-length-validator

// 索引重构(多用于版本之间的升级)
$ java -jar gerrit-2.13.war reindex --recheck-mergeable -d review_site

2.操作类

// 创建项目test-project1，当项目很多时，可以将项目名写入文件中，然后批量操作，创建完成后可以直接在gerrit网页端查看，
// 但一般如果代码结构为 gitolite+gerrit/gitlab+gerrit 则不建议这样操作。
// 可先在gitolite创建代码库，然后链接到gerrit或者gitlab建库，git clone到gerrit

$ ssh -p 29418 admin@192.167.100.200 gerrit create-project test-project1

$ ssh -p 29418 admin@192.167.100.200 gerrit plugin ls    查看插件相关信息

Name                           Version    Status   File
-------------------------------------------------------------------------------
commit-message-length-validator v2.12.3    ENABLED  commit-message-length-validator.jar
download-commands              v2.12.3    ENABLED  download-commands.jar
replication                    v2.12.3    ENABLED  replication.jar
reviewnotes                    v2.12.3    ENABLED  reviewnotes.jar
singleusergroup                v2.12.3    ENABLED  singleusergroup.jar

$ ssh -p 29418 admin@192.167.100.200 gerrit --help   查看帮助

gerrit [COMMAND] [ARG ...] [--] [--help (-h)]

 --          : end of options
 --help (-h) : display this help text

Available commands of gerrit are:

   apropos              Search in Gerrit documentation
   ban-commit           Ban a commit from a project's repository
   close-connection     Close the specified SSH connection
   create-account       Create a new batch/role account
   create-branch        Create a new branch
   create-group         Create a new account group
   create-project       Create a new project and associated Git repository
   flush-caches         Flush some/all server caches from memory
   gc                   Run Git garbage collection
   gsql                 Administrative interface to active database
   index                
   logging              
   ls-groups            List groups visible to the caller
   ls-members           List the members of a given group
   ls-projects          List projects visible to the caller
   ls-user-refs         List refs visible to a specific user
   plugin               
   query                Query the change database
   receive-pack         Standard Git server side command for client side git push
   rename-group         Rename an account group
   review               Apply reviews to one or more patch sets
   set-account          Change an account's settings
   set-head             Change HEAD reference for a project
   set-members          Modify members of specific group or number of groups
   set-project          Change a project's settings
   set-project-parent   Change the project permissions are inherited from
   set-reviewers        Add or remove reviewers on a change
   show-caches          Display current cache statistics
   show-connections     Display active client SSH connections
   show-queue           Display the background work queues
   stream-events        Monitor events occurring in real time
   test-submit          
   version              Display gerrit version

See 'gerrit COMMAND --help' for more information.