簡介
本指南將帶你在 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 是否正確安裝:
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 會自動啟動。
離開 gerrit 使用者:
exit
- 確認 Gerrit 是否正在執行
執行以下指令檢查 Gerrit 狀態:
sudo -u gerrit /srv/gerrit/bin/gerrit.sh status
若需要停止服務,可執行:
sudo -u gerrit /srv/gerrit/bin/gerrit.sh stop
- 將 Gerrit 註冊為 systemd 服務
建立 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」,即可以預設管理員身份登入(開發模式下不需密碼)。
