180 lines
4.4 KiB
Markdown
180 lines
4.4 KiB
Markdown
# 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 配置正确）
|
||
|
||
```bash
|
||
# 添加用户到组
|
||
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 并直接合并代码
|
||
|