gerrit/添加团队成员账号指南.md

Gerrit 添加团队成员账号指南

方法一：让团队成员自己注册（推荐，最简单）

在开发模式下（DEVELOPMENT_BECOME_ANY_ACCOUNT），团队成员可以自己注册账号。

操作步骤：

1. 团队成员访问 Gerrit

   • 打开浏览器
   • 访问：http://101.43.95.130:8080

2. 注册账号

   • 点击 "Sign In"
   • 在登录页面，点击 "New Account" 按钮
   • 系统会自动创建账户并登录

3. 管理员添加用户到组

   • 管理员登录后，访问：http://101.43.95.130:8080/#/admin/groups
   • 创建或选择用户组（例如：Developers）
   • 添加团队成员到组中

方法二：管理员通过 Web 界面添加用户到组

步骤 1：创建用户组（如果需要）

1. 访问：http://101.43.95.130:8080/#/admin/groups
2. 点击 "CREATE NEW" 按钮
3. 输入组名（例如：Developers）
4. 点击 "CREATE"

步骤 2：添加用户到组

1. 访问：http://101.43.95.130:8080/#/admin/groups/Developers,members
   • 将 Developers 替换为您创建的组名
2. 点击 "Add" 或 "+" 按钮
3. 输入用户名（团队成员注册时使用的用户名）
4. 点击 "Add" 保存

步骤 3：配置项目权限

1. 访问项目页面：http://101.43.95.130:8080/#/admin/projects/项目名称,access
2. 点击 "Edit" 按钮
3. 添加权限规则：
   • Reference: refs/heads/*
   • Permission: Read
   • Group: Developers（或您创建的组名）
   • 点击 "Add"
4. 添加评审权限：
   • Reference: refs/for/*
   • Permission: Label Code-Review
   • Group: Developers
   • Value: -2..+2（允许 -2 到 +2 的评审）
   • 点击 "Add"
5. 点击 "Save Changes" 保存

方法三：通过命令行添加用户（如果 SSH 配置正确）

# 添加用户到组
ssh -p 29418 admin@101.43.95.130 gerrit set-members --add 用户名 Developers

# 查看组成员
ssh -p 29418 admin@101.43.95.130 gerrit ls-members Developers

推荐的权限配置

给开发组配置的权限：

1. 读取权限：

   • Reference: refs/heads/*
   • Permission: Read
   • Group: Developers

2. 代码评审权限：

   • Reference: refs/for/*
   • Permission: Label Code-Review
   • Group: Developers
   • Value: -2..+2

3. 提交权限（如果需要）：

   • Reference: refs/heads/*
   • Permission: Push
   • Group: Developers

快速操作流程

管理员操作：

1. 创建开发组：

   访问: http://101.43.95.130:8080/#/admin/groups
   点击 "CREATE NEW"
   输入组名: Developers
   点击 "CREATE"
   

2. 添加团队成员：

   访问: http://101.43.95.130:8080/#/admin/groups/Developers,members
   点击 "Add"
   输入用户名（团队成员注册时使用的用户名）
   点击 "Add"
   

3. 配置项目权限：

   访问: http://101.43.95.130:8080/#/admin/projects/项目名称,access
   点击 "Edit"
   添加权限规则（参考上面的推荐配置）
   点击 "Save Changes"
   

团队成员操作：

1. 访问：http://101.43.95.130:8080
2. 点击 "Sign In"
3. 点击 "New Account"
4. 填写用户名等信息
5. 等待管理员添加到组中

验证配置

检查组成员：

访问：http://101.43.95.130:8080/#/admin/groups/Developers,members

应该能看到所有团队成员的用户名。

检查项目权限：

访问：http://101.43.95.130:8080/#/admin/projects/项目名称,access

应该能看到配置的权限规则。

常见问题

Q: 用户注册后看不到项目？

A: 需要：

1. 将用户添加到有权限的组
2. 在项目权限中给该组配置 Read 权限

Q: 用户无法进行代码评审？

A: 需要：

1. 在项目权限中给组配置 Label Code-Review 权限
2. 设置合适的值范围（例如：-2..+2）

Q: 如何给用户 +2 权限？

A: 在项目权限中：

• Reference: refs/heads/* 或 refs/for/*
• Permission: Label Code-Review
• Group/User: 选择用户或组
• Value: +2

示例：完整的权限配置

项目: zhini_im

权限规则：
1. refs/heads/*
   - Read: Developers
   - Push: Administrators
   - Label Code-Review +2: Administrators

2. refs/for/*
   - Read: Developers
   - Label Code-Review -2..+2: Developers
   - Label Code-Review +2: Administrators

这样配置后：

• Developers 组的成员可以读取代码、创建变更、进行评审（-2 到 +2）
• Administrators 可以 +2 并直接合并代码