git-gerrit

用于与gerrit codereview服务及其ci集成交互的命令行工具。为内部使用而制作，但对其他人也可能有用。

安装

pip install gitgerrit

安装包后，可通过 git gerrit 使用。

配置

• 在Gerrit网页界面中生成HTTP密码。
• git config --add gerrit.host hostname.of.your.gerrit.instance
• git config --add gerrit.user your_user_name
• git config --add gerrit.token your_http_password
• `git config --add gerrit.prevent_build_topic noci

或者，您可以将相同的值设置到以下环境变量中

• GERRIT_HOST
• GERRIT_USER
• GERRIT_TOKEN
• GERRIT_PREVENT_BUILD_TOPIC

如果您需要修改runverify操作使用的注释，您可以可选地添加环境变量GERRIT_TRIGGER或gerrit.trigger git配置选项。如果没有设置，默认为runverify，但您也可以根据仓库设置它为artifactoryupload。

prevent_build_topic 是在ci中配置的topic，通常意味着带有该topic的提交将不会构建。当与提交链（--support-chain标志）一起工作时，这很有帮助，并且只需要构建关系中的HEAD，而不是所有指向HEAD的父级。如果没有设置，默认为NOCI

使用方法

git-gerrit 如果没有提供--commit或--changeid，则默认在工作目录的当前提交上工作。

默认情况下，git-gerrit 在单个提交上操作。如果您想对一起提交的每个提交应用操作，请在操作之前提供--support-chain参数。

您还可以通过--loglevel=$level标志指定日志级别。

在可选参数之后，这些参数影响正在操作哪些变更请求，您需要提供关键字以定义针对变更所采取的操作

操作

runverify

可以打印出变更的最新版本上的当前投票，或将“runverify”消息添加到最新版本以触发当前更改的ci构建。

"runverify"触发消息可以通过设置gerrit.trigger git配置或通过GERRIT_TRIGGER环境变量进行自定义。

更多信息：git gerrit runverify -h

topic

可以设置或获取变更上的主题。

更多信息：git gerrit runverify -h

hashtag

获取、添加或删除变更上的标签。可以通过多次添加--add和--del标志到命令行来在一个调用中添加或删除多个标签。如果没有提供标签，默认将当前分支名称添加到变更的标签列表中。

更多信息：git gerrit hashtag-h

wip

将变更标记为工作进行中，表示目前不需要审查。

更多信息：git gerrit wip -h

ready

将变更标记为准备审查，表示您的更改已准备好进行审查。

更多信息：git gerrit ready -h

private

将变更标记为私有。只有被添加为审查人员的人才能看到变更。

更多信息：git gerrit private -h

public

将变更标记为公共。任何有权访问项目的人都可以看到您的变更。

更多信息：git gerrit public -h

prepare

准备变更以合并。这是一个组操作。

• 将变更标记为准备审查。
• 将变更标记为公共。
• 将除了HEAD主题之外的所有变更更改到NOCI，以避免合并时的多次构建。
• 将HEAD的主题添加到变更的标签中。

更多信息：git gerrit prepare -h

abandon

放弃变更。更多信息：git gerrit abandon -h