admin/gerrit

Fork 0

Files

rjb 1e007fa3f7 first commit

2025-12-22 17:12:39 +08:00

7.4 KiB

Raw Permalink Blame History

Gerrit 快速使用指南

🎉 恭喜！Gerrit 已成功安装并运行

您的 Gerrit 访问地址：http://101.43.95.130:8080

第一步：创建管理员账户

1. 登录 Gerrit

打开浏览器，访问：http://101.43.95.130:8080
点击右上角的 "Sign In" 按钮
在登录页面，输入任意用户名（例如：admin）
点击 "Sign In"

重要：由于配置了开发模式（DEVELOPMENT_BECOME_ANY_ACCOUNT），您可以使用任意用户名登录，无需密码。

2. 验证管理员权限

登录后，点击右上角用户名 → "Settings" → 左侧菜单应该显示 "Administration" 选项，说明您已经是管理员了。

第二步：创建第一个项目

方法一：通过 Web 界面创建（推荐）

登录后，点击顶部菜单 "Projects" → "Create Project"
填写项目信息：
- Project Name: my-project（例如）
- Parent: All-Projects（默认）
- Description: 项目描述（可选）
- Submit Type: Merge If Necessary（推荐）
- Create initial empty commit: ✅ 勾选（推荐）
点击 "Create Project"

方法二：通过命令行创建

# 使用 SSH 连接 Gerrit
ssh -p 29418 admin@101.43.95.130 gerrit create-project my-project

第三步：配置本地 Git

1. 配置 Git 用户信息

# 设置全局用户信息
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 配置 Gerrit 服务器（替换 admin 为您的用户名）
git config --global review.101.43.95.130:29418.username admin

2. 克隆项目

# 方式一：通过 SSH（推荐）
git clone ssh://admin@101.43.95.130:29418/my-project

# 方式二：通过 HTTP
git clone http://101.43.95.130:8080/my-project

如果使用 HTTP，首次克隆时可能需要输入用户名（密码留空，开发模式不需要密码）。

第四步：开发提交流程

1. 创建开发分支并修改代码

# 进入项目目录
cd my-project

# 创建特性分支
git checkout -b feature/new-feature

# 进行代码修改
echo "# My Project" > README.md
git add README.md

# 提交更改
git commit -m "Add README file"

2. 推送到 Gerrit 进行评审

关键：推送到 refs/for/master 分支（不是直接推送到 master）

# 推送到评审队列
git push origin HEAD:refs/for/master

推送成功后的输出示例：

remote: Resolving deltas: 100% (1/1)
remote: Processing changes: refs: 1, new: 1
remote: 
remote: SUCCESS
remote: 
remote:   http://101.43.95.130:8080/c/my-project/+/1 [NEW]
remote: 
To ssh://admin@101.43.95.130:29418/my-project
 * [new branch]      HEAD -> refs/for/master

3. 查看变更

复制 Gerrit 返回的 URL（例如：http://101.43.95.130:8080/c/my-project/+/1），在浏览器中打开查看变更详情。

第五步：代码评审与合并

1. 在 Web 界面进行评审

查看变更详情
- 点击 Change 进入详情页
- 查看文件差异（Diff）
- 查看提交信息
添加评论
- 在代码行上点击，添加行内评论
- 在页面底部添加整体评论
评审投票
- Code-Review:
  - +2 = 批准合并
  - +1 = 看起来不错，但需要其他人批准
  - -1 = 需要修改
  - -2 = 拒绝
- Verified:
  - +1 = 验证通过
  - -1 = 验证失败
合并变更
- 当满足以下条件时，变更可以自动合并：
  - Code-Review: +2
  - Verified: +1（如果启用了 Verified 标签）
- 或者管理员可以手动点击 "Submit" 按钮合并

2. 修改代码后重新推送

如果需要根据评审意见修改代码：

# 修改代码后，追加提交（会自动关联到同一个 Change）
git add .
git commit --amend  # 修改最后一次提交
git push origin HEAD:refs/for/master

3. 合并后的操作

# 更新本地仓库
cd my-project
git checkout master
git pull origin master

# 删除已合并的特性分支
git branch -d feature/new-feature

常用操作

跳过评审直接推送（个人使用）

如果只是个人使用，可以配置直接推送：

# 方法一：推送到 refs/heads/master（绕过评审）
git push origin HEAD:refs/heads/master

# 方法二：配置项目权限，允许直接推送
# 在 Gerrit Web 界面：
# Projects → my-project → Access → Edit
# 添加权限：
#   Reference: refs/heads/*
#   Push: 允许您的用户组

查看所有项目

# 通过 SSH
ssh -p 29418 admin@101.43.95.130 gerrit ls-projects

# 在 Web 界面
访问：http://101.43.95.130:8080/#/admin/projects/

查看变更列表

# 通过 SSH
ssh -p 29418 admin@101.43.95.130 gerrit query --format=JSON change:1

# 在 Web 界面
访问：http://101.43.95.130:8080/#/q/status:open

服务管理命令

# 进入 Gerrit 目录
cd ~/gerrit_install/review_site

# 启动服务
JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.23.0.9-2.el7_9.x86_64 bin/gerrit.sh start

# 停止服务
bin/gerrit.sh stop

# 重启服务
bin/gerrit.sh restart

# 查看状态
bin/gerrit.sh status

# 查看日志
tail -f logs/gerrit.log
tail -f logs/error_log

常见问题

1. 无法访问 Web 界面

检查项：

服务是否运行：cd ~/gerrit_install/review_site && bin/gerrit.sh status
端口是否被占用：netstat -tlnp | grep 8080

防火墙是否开放端口：

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

2. SSH 连接失败