CentOS 7如何部署Gerrit代码审核系统？

CentOS 7 作为一款稳定可靠的Linux发行版，常被用于搭建企业级代码审查平台，Gerrit 是一个基于Web的代码审查和项目管理系统，与Git紧密集成，能够有效提升团队协作效率，本文将详细介绍在CentOS 7上安装、配置和使用Gerrit的完整流程，包括环境准备、安装步骤、配置优化及常见问题处理。

环境准备与依赖安装

在开始安装Gerrit之前，需确保系统满足基本要求，CentOS 7系统需保持最新状态，建议执行 yum update 更新所有包，Gerrit依赖Java运行环境，推荐使用OpenJDK 1.8或更高版本，通过 yum install java-1.8.0-openjdk 安装，并验证 java -version 确认安装成功，Gerrit需要HTTP服务器（如Nginx或Apache）提供反向代理，此处以Nginx为例，执行 yum install nginx 安装，并启动服务 systemctl start nginx。

Gerrit的安装与初始化

Gerrit提供了官方的war包安装方式，首先从官网下载最新稳定版war包，gerrit-3.8.0.war，并放置到 /opt 目录，执行 java -jar gerrit-3.8.0.war init -d /var/gerrit 初始化Gerrit实例，-d 指定安装目录，初始化过程中会提示配置数据库类型（默认H2，生产环境推荐PostgreSQL）、HTTP监听端口（默认8081）及管理员邮箱等信息，建议使用非root用户运行Gerrit，可通过 useradd gerrit 创建专用用户并切换权限。

配置反向代理与SSL

Gerrit默认使用HTTP协议，生产环境需配置HTTPS以确保安全，编辑Nginx配置文件 /etc/nginx/conf.d/gerrit.conf，添加以下内容：

server {
    listen 443 ssl;
    server_name your.domain.com;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    location / {
        proxy_pass http://localhost:8081;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

替换域名及证书路径后，重启Nginx服务，防火墙需开放443端口，执行 firewall-cmd --permanent --add-service=https 并重载防火墙规则。

用户管理与权限控制

Gerrit支持基于账户和组的权限管理，管理员可通过Web界面创建用户，或使用 git config --global user.name "Your Name" 配置Git信息后首次访问Gerrit自动注册，权限通过 All-Projects 仓库的 groups 文件配置，例如创建 reviewers 组并赋予代码审查权限，Gerrit还支持LDAP/AD集成，在 /var/gerrit/etc/gerrit.config 中配置认证相关参数,实现企业级用户统一管理。

日常维护与日志管理

Gerrit的日志位于 /var/gerrit/logs 目录，包括 error.log 和 sshd.log 等，定期清理日志文件可避免磁盘空间不足，数据备份可通过 gerrit backup 命令实现，建议结合定时任务（如cron）每日执行，对于数据库升级，需停止Gerrit服务后运行 java -jar gerrit.war upgrade,确保数据兼容性。

常见问题处理

1. Gerrit无法访问：检查防火墙规则及Nginx配置，确认端口是否正确映射，查看 /var/gerrit/logs/error.log 定位错误原因。
2. Git推送失败：验证Gerrit账户SSH密钥是否正确添加，或检查 refs/for/* 分支推送权限配置。

通过以上步骤，您可以在CentOS 7上成功搭建功能完善的Gerrit代码审查平台，为团队协作提供高效支持。

---

FAQs

Q1: 如何重置Gerrit管理员密码？
A1: 若忘记管理员密码，可通过以下步骤重置：

1. 停止Gerrit服务：systemctl stop gerrit。
2. 进入数据库（如H2）：java -cp /var/gerrit/db/h2/h2-*.jar org.h2.tools.Shell -url jdbc:h2:/var/gerrit/db/reviewdb。
3. 执行SQL更新密码：UPDATE account_external_ids SET salted_sha256_hex='新密码的SHA256值' WHERE account_id=1;（需提前计算SHA256值）。
4. 重启Gerrit服务。

Q2: Gerrit如何与GitLab集成？
A2: 通过Gerrit的Git插件实现集成：

1. 在Gerrit中安装 git-plugin，并配置Webhooks。
2. 在GitLab项目设置中添加Webhook，指向Gerrit的 hooks/ 路径。
3. 配置权限，确保GitLab用户能通过SSH访问Gerrit仓库。
4. 测试提交是否同步触发Gerrit代码审查流程。