75edf0aa71
- Rust-based digital asset management system - Video analysis: ASR, OCR, YOLO, Face, Pose - RAG capabilities with Qdrant vector database - Multi-database support: PostgreSQL, Redis, MongoDB - Monitoring system with launchd plists - n8n workflow automation integration
395 lines
8.0 KiB
Markdown
395 lines
8.0 KiB
Markdown
# 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)
|
|
|
|
```bash
|
|
# 安裝 Gitea
|
|
brew install gitea
|
|
```
|
|
|
|
**驗證**:
|
|
```bash
|
|
gitea --version
|
|
# gitea version 1.25.3
|
|
```
|
|
|
|
---
|
|
|
|
### Step 2: 建立目錄
|
|
|
|
```bash
|
|
# 建立數據目錄
|
|
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`:
|
|
|
|
```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 開機自動啟動
|
|
|
|
```bash
|
|
# 複製 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` 中添加：
|
|
|
|
```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
|
|
|
|
```bash
|
|
# 找到 Gitea 進程
|
|
ps aux | grep gitea | grep -v grep
|
|
|
|
# 停止 Gitea
|
|
pkill gitea
|
|
|
|
# 確認停止
|
|
ps aux | grep gitea | grep -v grep || echo "Gitea 已停止"
|
|
```
|
|
|
|
---
|
|
|
|
### Step 2: 卸載 Gitea
|
|
|
|
```bash
|
|
# 卸載 Gitea
|
|
brew uninstall gitea
|
|
|
|
# 移除 plist
|
|
sudo launchctl unload /Library/LaunchDaemons/com.momentry.gitea.plist
|
|
sudo rm /Library/LaunchDaemons/com.momentry.gitea.plist
|
|
```
|
|
|
|
---
|
|
|
|
### Step 3: 刪除專屬檔案
|
|
|
|
```bash
|
|
# 刪除數據目錄 (可選)
|
|
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
|
|
```
|
|
|
|
**注意: 不要刪除以下共用目錄**:
|
|
```bash
|
|
# 這些是共用的，不要刪除!
|
|
# /Users/accusys/momentry/var
|
|
# /Users/accusys/momentry/etc
|
|
# /Users/accusys/momentry/log
|
|
```
|
|
|
|
---
|
|
|
|
### Step 4: 卸載後檢查清單
|
|
|
|
```bash
|
|
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. 配置目錄:
|
|
✓ 保留 (或 ✗ 已刪除)
|
|
```
|
|
|
|
---
|
|
|
|
## 手動檢查命令
|
|
|
|
```bash
|
|
# 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` 中:
|
|
|
|
```env
|
|
GITEA_URL=http://localhost:3000
|
|
GITEA_ROOT=/Users/accusys/momentry/var/gitea/data/gitea-repositories
|
|
```
|
|
|
|
---
|
|
|
|
## 故障排除
|
|
|
|
### Gitea 無法啟動
|
|
|
|
```bash
|
|
# 檢查日誌
|
|
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 被佔用
|
|
|
|
```bash
|
|
# 檢查哪個程序佔用 port 3000
|
|
lsof -i :3000
|
|
|
|
# 終止佔用程序
|
|
kill <PID>
|
|
```
|
|
|
|
### 需要重新載入 plist
|
|
|
|
```bash
|
|
# 卸載舊服務 (如果存在)
|
|
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 |
|
|
|
|
---
|
|
|
|
## 常用指令
|
|
|
|
```bash
|
|
# 啟動 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/
|