简介
本指南将带你在 Ubuntu 24.04 上安装 Gerrit 3.11.2,使用 Java 21 和一个专用的系统用户。安装以开发模式进行,使用内置的 Jetty 服务器和 H2 数据库,并通过 systemd 将 Gerrit 作为后台服务进行管理。
身份验证采用 Gerrit 默认的开发模式,允许你直接以 admin 登录,无需密码。
- 安装 Java 21
sudo apt update
sudo apt install openjdk-21-jdk -y
验证安装:
java -version
你应该会看到类似以下的输出:
openjdk version "21" ...
- 创建 gerrit 系统用户
sudo groupadd --system --gid 2001 gerrit
sudo useradd --system --uid 2001 --gid 2001 \
--home /home/gerrit \
--shell /bin/bash \
--create-home \
gerrit
- 创建 Gerrit 安装目录
sudo mkdir -p /srv/gerrit
sudo chown gerrit:gerrit /srv/gerrit
- 下载并初始化 Gerrit 3.11.2
切换到 gerrit 用户:
sudo su - gerrit
下载 Gerrit WAR 文件:
wget https://gerrit-releases.storage.googleapis.com/gerrit-3.11.2.war -O gerrit.war
初始化 Gerrit:
java -jar gerrit.war init --batch --dev -d /srv/gerrit
初始化完成后,Gerrit 会自动启动。
退出用户 shell:
exit
- 确认 Gerrit 是否正在运行
检查 Gerrit 状态:
sudo -u gerrit /srv/gerrit/bin/gerrit.sh status
如需停止:
sudo -u gerrit /srv/gerrit/bin/gerrit.sh stop
- 配置 Gerrit 为 systemd 服务
创建服务单元文件:
sudo vi /etc/systemd/system/gerrit.service
粘贴以下内容:
[Unit]
Description=Gerrit Code Review
After=network.target
[Service]
Type=simple
LimitNOFILE=65536
User=gerrit
ExecStart=/usr/bin/java -jar /srv/gerrit/bin/gerrit.war daemon -d /srv/gerrit
RemainAfterExit=yes
Restart=on-failure
OOMScoreAdjust=-1000
[Install]
WantedBy=multi-user.target
启用并启动 Gerrit 服务:
sudo systemctl daemon-reload
sudo systemctl enable --now gerrit
验证服务状态:
sudo systemctl status gerrit
预期输出:
Active: active (running)
- 访问 Gerrit 网页界面
打开浏览器,访问:
http://gerrit:8080
你将看到登录界面。在“Choose”下点击“admin”,即可使用默认管理员账户登录(开发模式下无需密码)。
