在 Ubuntu 24.04 上安装 Gerrit 3.11.2

简介

本指南将带你在 Ubuntu 24.04 上安装 Gerrit 3.11.2,使用 Java 21 和一个专用的系统用户。安装以开发模式进行,使用内置的 Jetty 服务器和 H2 数据库,并通过 systemd 将 Gerrit 作为后台服务进行管理。

身份验证采用 Gerrit 默认的开发模式,允许你直接以 admin 登录,无需密码。


  1. 安装 Java 21
sudo apt update
sudo apt install openjdk-21-jdk -y

验证安装:

java -version

你应该会看到类似以下的输出:

openjdk version "21" ...

  1. 创建 gerrit 系统用户
sudo groupadd --system --gid 2001 gerrit

sudo useradd --system --uid 2001 --gid 2001 \
  --home /home/gerrit \
  --shell /bin/bash \
  --create-home \
  gerrit

  1. 创建 Gerrit 安装目录
sudo mkdir -p /srv/gerrit
sudo chown gerrit:gerrit /srv/gerrit

  1. 下载并初始化 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

  1. 确认 Gerrit 是否正在运行

检查 Gerrit 状态:

sudo -u gerrit /srv/gerrit/bin/gerrit.sh status

如需停止:

sudo -u gerrit /srv/gerrit/bin/gerrit.sh stop

  1. 配置 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)

  1. 访问 Gerrit 网页界面

打开浏览器,访问:

http://gerrit:8080

你将看到登录界面。在“Choose”下点击“admin”,即可使用默认管理员账户登录(开发模式下无需密码)。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部