【Git】Gerrit常用指令

在使用 Gerrit 进行代码审查和管理时，掌握一些常用的 Git 和 Gerrit 命令是非常重要的。以下是一些常用的 Gerrit 指令的详细介绍，包括其功能和使用方法。

1. 克隆仓库

首先，你需要克隆包含 Gerrit 仓库的远程仓库。

git clone <repository_url>
cd <repository_directory>

例如：

git clone ssh://user@review.example.com:29418/project.git
cd project

2. 配置 Git 用户信息

确保你设置了正确的 Git 用户名和邮箱。

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

3. 创建更改

在本地创建一个新分支，并进行更改。

git checkout -b feature-branch

4. 添加和提交更改

添加更改并提交。

git add .
git commit -m "Describe your changes"

5. 推送更改到 Gerrit

将更改推送到 Gerrit 进行代码审查。

git push origin HEAD:refs/for/master

这将把当前分支的更改推送到 Gerrit 的 master 分支的审查队列。

6. 查看更改

查看 Gerrit 中的变更列表。

ssh user@review.example.com gerrit ls-projects

查看特定项目的变更：

ssh user@review.example.com gerrit query --format=JSON status:open project:project-name

7. 查看单个更改

查看特定变更的详细信息。

ssh user@review.example.com gerrit review <change-id>

8. 更新变更

在提交更改后，如果需要修改或添加更多更改，可以使用以下命令：

git commit --amend
git push origin HEAD:refs/for/master

9. 删除更改

如果需要删除已经推送到 Gerrit 的更改：

git push origin :refs/for/master

10. 强制推送

在某些情况下，可能需要强制推送更改。

git push --force origin HEAD:refs/for/master

11. 合并更改

在 Gerrit 上审查通过后，可以合并更改到主分支。

ssh user@review.example.com gerrit review <change-id> +1

或者通过命令行执行合并：

ssh user@review.example.com gerrit review <change-id> +2

12. 使用 Gerrit Hook

确保你安装并使用 Gerrit 的 Git Hook 来自动添加 Change-Id。

scp -p -P 29418 user@review.example.com:hooks/commit-msg .git/hooks/

13. 其他常用命令

• 查看变更状态

  ssh user@review.example.com gerrit query --format=JSON status:open project:project-name
  

• 创建新的更改

  git push origin HEAD:refs/for/master
  

• 查找更改

  ssh user@review.example.com gerrit query --format=JSON status:open project:project-name
  

• 查看更改详情

  ssh user@review.example.com gerrit review <change-id>
  

常见 Gerrit 参数说明

• +1、+2、-1、-2：用于审批更改，+1 表示通过，+2 表示优先通过，-1 表示拒绝，-2 表示强烈拒绝。
• status:open：查找所有开放的变更。
• project:project-name：筛选特定项目的变更。

总结

以上命令和说明涵盖了在 Gerrit 中常用的操作，包括从克隆仓库、提交更改到推送和审查更改。掌握这些命令将帮助你更高效地在 Gerrit 环境中进行代码管理和协作。