momentry_core_0_1/docs/INSTALL_GITEA.md

Gitea 安裝指南 (本地部署)

概述

本文檔說明如何在 macOS 上安裝 Gitea Git 服務，配置為本地部署。

---

當前狀態

項目	狀態
Gitea	✅ 已安裝 v1.25.3
數據目錄	/Users/accusys/momentry/var/gitea/
配置目錄	/Users/accusys/momentry/etc/gitea/
日誌目錄	/Users/accusys/momentry/log/
Plist	/Library/LaunchDaemons/com.momentry.gitea.plist

---

安裝步驟

Step 1: 安裝 Gitea (使用 brew)

# 安裝 Gitea
brew install gitea

驗證:

gitea --version
# gitea version 1.25.3

---

Step 2: 建立目錄

# 建立數據目錄
mkdir -p /Users/accusys/momentry/var/gitea/data
mkdir -p /Users/accusys/momentry/var/gitea/log

# 建立配置目錄
mkdir -p /Users/accusys/momentry/etc/gitea

# 建立日誌目錄
mkdir -p /Users/accusys/momentry/log

# 建立日誌文件
touch /Users/accusys/momentry/log/gitea.log
touch /Users/accusys/momentry/log/gitea.error.log

# 設定權限
chown -R accusys:staff /Users/accusys/momentry/var/gitea
chown -R accusys:staff /Users/accusys/momentry/etc/gitea
chown -R accusys:staff /Users/accusys/momentry/log

---

Step 3: 建立設定檔

建立 /Users/accusys/momentry/etc/gitea/app.ini:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = accusys
WORK_PATH = /Users/accusys/momentry/var/gitea
RUN_MODE = prod

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = gitea
USER = gitea
PASSWD = gitea_pass
SSL_MODE = disable

[repository]
ROOT = /Users/accusys/momentry/var/gitea/data/gitea-repositories

[server]
SSH_DOMAIN = gitea.momentry.ddns.net
DOMAIN = gitea.momentry.ddns.net
HTTP_PORT = 3000
ROOT_URL = http://gitea.momentry.ddns.net:3000/
APP_DATA_PATH = /Users/accusys/momentry/var/gitea/data
DISABLE_SSH = false
SSH_PORT = 2222
LFS_START_SERVER = true
OFFLINE_MODE = true

[lfs]
PATH = /Users/accusys/momentry/var/gitea/data/lfs

[log]
MODE = console, file
ROOT_PATH = /Users/accusys/momentry/log

---

Step 4: 使用 plist 開機自動啟動

# 複製 plist 到 LaunchDaemons 目錄
sudo cp /Users/accusys/momentry_core_0.1/momentry_runtime/plist/com.momentry.gitea.plist /Library/LaunchDaemons/

# 載入並啟動
sudo launchctl load /Library/LaunchDaemons/com.momentry.gitea.plist

---

監控配置

添加到監控配置

在 monitor/config/monitor_config.yaml 中添加：

service:
  services:
    - name: "gitea"
      type: "http"
      port: 3000
      host: "localhost"
      check_url: "http://localhost:3000/"
      timeout: 5
      enabled: true

---

卸載步驟

重要: 路徑說明

路徑	類型	說明
/Users/accusys/momentry/var/gitea/	數據	不要刪除 - Gitea 數據
/Users/accusys/momentry/etc/gitea/	配置	不要刪除 - Gitea 配置
/Users/accusys/momentry/log/	日誌	不要刪除 - 日誌目錄
/opt/homebrew/opt/gitea/	安裝	刪除 - Gitea 安裝目錄

Step 1: 停止 Gitea

# 找到 Gitea 進程
ps aux | grep gitea | grep -v grep

# 停止 Gitea
pkill gitea

# 確認停止
ps aux | grep gitea | grep -v grep || echo "Gitea 已停止"

---

Step 2: 卸載 Gitea

# 卸載 Gitea
brew uninstall gitea

# 移除 plist
sudo launchctl unload /Library/LaunchDaemons/com.momentry.gitea.plist
sudo rm /Library/LaunchDaemons/com.momentry.gitea.plist

---

Step 3: 刪除專屬檔案

# 刪除數據目錄 (可選)
rm -rf /Users/accusys/momentry/var/gitea

# 刪除配置目錄 (可選)
rm -rf /Users/accusys/momentry/etc/gitea

# 刪除日誌 (可選)
rm -f /Users/accusys/momentry/log/gitea.log
rm -f /Users/accusys/momentry/log/gitea.error.log

注意: 不要刪除以下共用目錄:

# 這些是共用的，不要刪除!
# /Users/accusys/momentry/var
# /Users/accusys/momentry/etc
# /Users/accusys/momentry/log

---

Step 4: 卸載後檢查清單

echo "=== Gitea 卸載後檢查 ==="

# 1. 檢查 Gitea 進程
echo "1. Gitea 進程:"
ps aux | grep gitea | grep -v grep && echo "   ✗ 仍在運行" || echo "   ✓ 已停止"

# 2. Port 3000
echo "2. Port 3000:"
lsof -i :3000 > /dev/null 2>&1 && echo "   ✗ 仍被佔用" || echo "   ✓ 已釋放"

# 3. gitea 命令
echo "3. gitea 命令:"
which gitea > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"

# 4. brew 安裝
echo "4. brew 安裝:"
brew list gitea > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"

# 5. launchctl 服務
echo "5. launchctl 服務:"
sudo launchctl list | grep gitea > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"

# 6. 數據目錄 (可選刪除)
echo "6. 數據目錄:"
[ -d "/Users/accusys/momentry/var/gitea" ] && echo "   ✓ 保留" || echo "   ✗ 已刪除"

# 7. 配置目錄 (可選刪除)
echo "7. 配置目錄:"
[ -d "/Users/accusys/momentry/etc/gitea" ] && echo "   ✓ 保留" || echo "   ✗ 已刪除"

預期結果:

=== Gitea 卸載後檢查 ===
1. Gitea 進程:
   ✓ 已停止
2. Port 3000:
   ✓ 已釋放
3. gitea 命令:
   ✓ 已移除
4. brew 安裝:
   ✓ 已移除
5. launchctl 服務:
   ✓ 已移除
6. 數據目錄:
   ✓ 保留 (或 ✗ 已刪除)
7. 配置目錄:
   ✓ 保留 (或 ✗ 已刪除)

---

手動檢查命令

# 1. 檢查進程
ps aux | grep gitea | grep -v grep

# 2. 檢查 Port
lsof -i :3000

# 3. 測試連線
curl http://localhost:3000/

# 4. 查看版本
gitea --version

# 5. 驗證配置
gitea doctor --config /Users/accusys/momentry/etc/gitea/app.ini

# 6. 查看日誌
tail -20 /Users/accusys/momentry/log/gitea.log

---

連線資訊

項目	值
URL	http://localhost:3000
Domain	gitea.momentry.ddns.net
SSH Port	2222
Database	PostgreSQL (gitea)

---

環境變數

在 .env 中:

GITEA_URL=http://localhost:3000
GITEA_ROOT=/Users/accusys/momentry/var/gitea/data/gitea-repositories

---

故障排除

Gitea 無法啟動

# 檢查日誌
tail -f /Users/accusys/momentry/log/gitea.log

# 檢查配置語法
gitea doctor --config /Users/accusys/momentry/etc/gitea/app.ini

# 檢查目錄權限
ls -la /Users/accusys/momentry/var/gitea/

# 重新設定權限
chown -R $(whoami):staff /Users/accusys/momentry/var/gitea

Port 被佔用

# 檢查哪個程序佔用 port 3000
lsof -i :3000

# 終止佔用程序
kill <PID>

需要重新載入 plist

# 卸載舊服務 (如果存在)
sudo launchctl unload /Library/LaunchDaemons/com.momentry.gitea.plist 2>/dev/null

# 載入新服務
sudo launchctl load /Library/LaunchDaemons/com.momentry.gitea.plist

---

檔案位置

類型	路徑	說明
安裝	/opt/homebrew/opt/gitea/	Gitea 安裝目錄
執行檔	/opt/homebrew/opt/gitea/bin/gitea	Gitea 執行檔
數據目錄	/Users/accusys/momentry/var/gitea/data/	數據儲存
配置	/Users/accusys/momentry/etc/gitea/app.ini	設定檔
日誌	/Users/accusys/momentry/log/gitea.log	執行日誌
錯誤日誌	/Users/accusys/momentry/log/gitea.error.log	錯誤日誌
plist	/Library/LaunchDaemons/com.momentry.gitea.plist	開機啟動
備份	/Users/accusys/momentry/var/gitea_backup/app.ini	配置備份

---

資料庫資訊

Gitea 使用 PostgreSQL 作為資料庫:

項目	值
Database	gitea
User	gitea
Host	127.0.0.1:5432
Password	gitea_pass

---

常用指令

# 啟動 Gitea
gitea web --config /Users/accusys/momentry/etc/gitea/app.ini

# 驗證配置
gitea doctor --config /Users/accusys/momentry/etc/gitea/app.ini

# 查看版本
gitea --version

# 備份數據
gitea dump --config /Users/accusys/momentry/etc/gitea/app.ini --zipfile /Users/accusys/momentry/var/gitea_backup.zip

---

版本資訊

• 版本: 1.25.3
• HTTP Port: 3000
• SSH Port: 2222
• 數據目錄: /Users/accusys/momentry/var/gitea/
• 配置: /Users/accusys/momentry/etc/gitea/app.ini
• 日誌目錄: /Users/accusys/momentry/log/