gerrit/上传本地项目到Gerrit指南.md

将本地项目上传到 Gerrit 指南

前提条件

1. ✅ Gerrit 已安装并运行：http://101.43.95.130:8080
2. ✅ 已在 Gerrit 创建项目：zhini_im
3. ✅ 本地已安装 Git

方法一：已有 Git 仓库（推荐）

如果 D:\zhini\zhini_im 已经是 Git 仓库：

步骤 1：打开 Git Bash 或命令行

在 Windows 上：

• 打开 Git Bash（如果安装了 Git for Windows）
• 或者打开 PowerShell/CMD

步骤 2：进入项目目录

cd /d/zhini/zhini_im
# 或
cd D:\zhini\zhini_im

步骤 3：添加 Gerrit 远程仓库

# 添加 Gerrit 作为远程仓库
git remote add gerrit http://101.43.95.130:8080/zhini_im
# 或使用 SSH（如果配置了 SSH 密钥）
git remote add gerrit ssh://admin@101.43.95.130:29418/zhini_im

步骤 4：推送代码到 Gerrit

# 推送主分支
git push gerrit HEAD:refs/heads/master

# 或者推送所有分支
git push gerrit --all

方法二：首次上传（创建初始提交）

如果项目还没有 Git 仓库：

步骤 1：初始化 Git 仓库

cd D:\zhini\zhini_im
git init

步骤 2：添加所有文件

git add .

步骤 3：创建初始提交

git commit -m "Initial commit"

步骤 4：配置 Git 用户信息（如果还没配置）

git config user.name "admin"
git config user.email "admin@example.com"

步骤 5：添加 Gerrit 远程仓库

git remote add gerrit http://101.43.95.130:8080/zhini_im

步骤 6：推送代码

git push gerrit HEAD:refs/heads/master

方法三：通过代码评审推送（推荐用于后续更新）

步骤 1：配置 Git 远程仓库

cd D:\zhini\zhini_im
git remote add gerrit http://101.43.95.130:8080/zhini_im

步骤 2：推送代码进行评审

# 推送当前分支到评审队列
git push gerrit HEAD:refs/for/master

# 如果需要指定主题
git push gerrit HEAD:refs/for/master%topic=feature-name

步骤 3：在 Gerrit Web 界面进行评审

1. 访问：http://101.43.95.130:8080
2. 在 "Outgoing reviews" 中查看您的变更
3. 等待评审或自己评审后合并

详细操作步骤（Windows）

1. 打开 Git Bash

• 在项目目录 D:\zhini\zhini_im 右键
• 选择 "Git Bash Here"

2. 检查是否已有 Git 仓库

# 检查是否有 .git 目录
ls -la | grep .git

3. 如果没有 Git 仓库，初始化

git init
git add .
git commit -m "Initial commit"

4. 配置 Git 用户信息

git config user.name "admin"
git config user.email "admin@example.com"

# 或全局配置
git config --global user.name "admin"
git config --global user.email "admin@example.com"

5. 添加 Gerrit 远程仓库

# 使用 HTTP（推荐，简单）
git remote add gerrit http://101.43.95.130:8080/zhini_im

# 或使用 SSH（需要配置 SSH 密钥）
git remote add gerrit ssh://admin@101.43.95.130:29418/zhini_im

6. 推送代码

# 直接推送到主分支（首次上传）
git push gerrit HEAD:refs/heads/master

# 或推送到评审队列（后续更新，推荐）
git push gerrit HEAD:refs/for/master

常见问题

Q: 推送时提示需要认证？

A: 在开发模式下，HTTP 推送可能不需要密码，但如果需要：

• 用户名：您注册时使用的用户名（例如：admin）
• 密码：留空（开发模式不需要密码）

Q: 推送失败，提示 "remote rejected"？

A: 可能的原因：

1. 项目不存在 → 先在 Gerrit 创建项目
2. 没有推送权限 → 检查项目权限配置
3. 分支保护 → 使用 refs/for/master 推送到评审队列

Q: 如何查看远程仓库？

git remote -v

Q: 如何更新远程仓库地址？

# 删除旧的
git remote remove gerrit

# 添加新的
git remote add gerrit http://101.43.95.130:8080/zhini_im

推送方式对比

直接推送（refs/heads/master）

• ✅ 直接更新主分支
• ❌ 跳过代码评审流程
• 适用于：首次上传、管理员直接合并

评审推送（refs/for/master）

• ✅ 进入代码评审流程
• ✅ 需要评审后才能合并
• ✅ 符合 Gerrit 工作流程
• 推荐用于：日常开发、团队协作

完整示例

# 1. 进入项目目录
cd D:\zhini\zhini_im

# 2. 初始化 Git（如果还没有）
git init
git add .
git commit -m "Initial commit"

# 3. 配置用户信息
git config user.name "admin"
git config user.email "admin@example.com"

# 4. 添加 Gerrit 远程仓库
git remote add gerrit http://101.43.95.130:8080/zhini_im

# 5. 推送代码（首次上传）
git push gerrit HEAD:refs/heads/master

# 6. 后续更新（推送到评审队列）
git add .
git commit -m "Update code"
git push gerrit HEAD:refs/for/master

验证上传

推送成功后：

1. 访问：http://101.43.95.130:8080/#/admin/projects/zhini_im
2. 应该能看到项目信息
3. 访问：http://101.43.95.130:8080/#/q/project:zhini_im
4. 应该能看到您的变更

后续操作

克隆项目（其他团队成员）

# 使用 HTTP
git clone http://101.43.95.130:8080/zhini_im

# 或使用 SSH
git clone ssh://admin@101.43.95.130:29418/zhini_im

日常开发流程

# 1. 修改代码
# 2. 提交更改
git add .
git commit -m "描述您的更改"

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

# 4. 在 Gerrit Web 界面进行评审
# 5. 评审通过后，代码会自动合并