first commit

2025-12-22 17:12:39 +08:00
commit 1e007fa3f7
107 changed files with 15447 additions and 0 deletions
--- a/添加团队成员账号指南.md
+++ b/添加团队成员账号指南.md
@@ -0,0 +1,179 @@
+# 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 并直接合并代码
+