在 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 是否正確安裝:

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 會自動啟動。

離開 gerrit 使用者:

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 服務

建立 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」,即可以預設管理員身份登入(開發模式下不需密碼)。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

返回頂端