mirror of
https://github.com/OHV-IT/collabrix.git
synced 2025-12-15 16:48:36 +01:00
Add Service Manager for Background Services
- service-manager.sh: Comprehensive service management script - Start/stop backend and frontend as background services - Status monitoring and log management - Individual service control (start-backend, stop-frontend, etc.) - SERVICE_MANAGER_README.md: Complete documentation - PID file management for process tracking - Colored output and error handling - Production-ready with systemd integration examples
This commit is contained in:
DGSoft
parent
93b98cfb5c
commit
9daab3cdf4
143
SERVICE_MANAGER_README.md
Normal file
143
SERVICE_MANAGER_README.md
Normal file
@ -0,0 +1,143 @@
|
||||
# Team Chat System - Service Manager
|
||||
|
||||
Das `service-manager.sh` Script ermöglicht es, Backend und Frontend als Hintergrund-Services zu starten und zu verwalten.
|
||||
|
||||
## 🚀 Schnellstart
|
||||
|
||||
```bash
|
||||
# Starte beide Services
|
||||
./service-manager.sh start
|
||||
|
||||
# Zeige Status
|
||||
./service-manager.sh status
|
||||
|
||||
# Stoppe beide Services
|
||||
./service-manager.sh stop
|
||||
```
|
||||
|
||||
## 📋 Verfügbare Commands
|
||||
|
||||
### Grundlegende Commands
|
||||
- `start` - Startet Backend und Frontend
|
||||
- `stop` - Stoppt Backend und Frontend
|
||||
- `restart` - Startet beide Services neu
|
||||
- `status` - Zeigt den aktuellen Status an
|
||||
|
||||
### Individuelle Services
|
||||
- `start-backend` - Startet nur das Backend
|
||||
- `start-frontend` - Startet nur das Frontend
|
||||
- `stop-backend` - Stoppt nur das Backend
|
||||
- `stop-frontend` - Stoppt nur das Frontend
|
||||
|
||||
### Logging
|
||||
- `logs backend [zeilen]` - Zeigt Backend-Logs (Standard: 50 Zeilen)
|
||||
- `logs frontend [zeilen]` - Zeigt Frontend-Logs (Standard: 50 Zeilen)
|
||||
|
||||
## 📁 Dateien und Verzeichnisse
|
||||
|
||||
```
|
||||
logs/
|
||||
├── backend.log # Backend-Ausgaben
|
||||
├── frontend.log # Frontend-Ausgaben
|
||||
├── backend.pid # Backend-Prozess-ID
|
||||
└── frontend.pid # Frontend-Prozess-ID
|
||||
```
|
||||
|
||||
## 🌐 Zugriffe
|
||||
|
||||
Nach dem Start sind verfügbar:
|
||||
- **Frontend:** http://192.168.0.12
|
||||
- **Backend API:** http://localhost:8000
|
||||
- **API Docs:** http://localhost:8000/docs
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### Services starten nicht
|
||||
```bash
|
||||
# Prüfe Logs
|
||||
./service-manager.sh logs backend
|
||||
./service-manager.sh logs frontend
|
||||
|
||||
# Prüfe Status
|
||||
./service-manager.sh status
|
||||
```
|
||||
|
||||
### Services gewaltsam stoppen
|
||||
```bash
|
||||
# Einzelne Services
|
||||
./service-manager.sh stop-backend
|
||||
./service-manager.sh stop-frontend
|
||||
|
||||
# Oder alles
|
||||
./service-manager.sh stop
|
||||
```
|
||||
|
||||
### Log-Verzeichnis aufräumen
|
||||
```bash
|
||||
rm -rf logs/
|
||||
```
|
||||
|
||||
## 📊 Beispiel-Session
|
||||
|
||||
```bash
|
||||
# System starten
|
||||
$ ./service-manager.sh start
|
||||
[2025-12-09 22:15:30] Starte Team Chat System...
|
||||
[2025-12-09 22:15:30] Starte Backend-Server...
|
||||
[2025-12-09 22:15:32] ✅ Backend gestartet (PID: 12345)
|
||||
[2025-12-09 22:15:32] 📍 API: http://localhost:8000
|
||||
[2025-12-09 22:15:32] 📚 Docs: http://localhost:8000/docs
|
||||
[2025-12-09 22:15:32] 📄 Logs: /home/OfficeDesk/logs/backend.log
|
||||
[2025-12-09 22:15:32] Starte Frontend-Server...
|
||||
[2025-12-09 22:15:35] ✅ Frontend gestartet (PID: 12346)
|
||||
[2025-12-09 22:15:35] 📍 App: http://192.168.0.12
|
||||
[2025-12-09 22:15:35] 📄 Logs: /home/OfficeDesk/logs/frontend.log
|
||||
|
||||
=== Team Chat System Status ===
|
||||
|
||||
🟢 Backend: Läuft (PID: 12345)
|
||||
📍 API: http://localhost:8000
|
||||
📚 Docs: http://localhost:8000/docs
|
||||
🟢 Frontend: Läuft (PID: 12346)
|
||||
📍 App: http://192.168.0.12
|
||||
|
||||
📁 Logs: /home/OfficeDesk/logs
|
||||
```
|
||||
|
||||
## 🔄 Automatisches Starten
|
||||
|
||||
### Systemd Service (empfohlen für Production)
|
||||
```bash
|
||||
# Service-Datei erstellen
|
||||
sudo nano /etc/systemd/system/teamchat.service
|
||||
|
||||
# Inhalt:
|
||||
[Unit]
|
||||
Description=Team Chat System
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=your_user
|
||||
WorkingDirectory=/home/OfficeDesk
|
||||
ExecStart=/home/OfficeDesk/service-manager.sh start
|
||||
ExecStop=/home/OfficeDesk/service-manager.sh stop
|
||||
Restart=always
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
|
||||
# Service aktivieren und starten
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable teamchat
|
||||
sudo systemctl start teamchat
|
||||
```
|
||||
|
||||
### Cron-Job für automatischen Start beim Boot
|
||||
```bash
|
||||
# Cron-Job hinzufügen
|
||||
crontab -e
|
||||
|
||||
# Füge hinzu:
|
||||
@reboot /home/OfficeDesk/service-manager.sh start
|
||||
```
|
||||
321
service-manager.sh
Executable file
321
service-manager.sh
Executable file
@ -0,0 +1,321 @@
|
||||
#!/bin/bash
|
||||
|
||||
# Team Chat System - Service Manager
|
||||
# Startet Backend und Frontend als Hintergrund-Services
|
||||
|
||||
set -e
|
||||
|
||||
# Konfiguration
|
||||
PROJECT_DIR="/home/OfficeDesk"
|
||||
BACKEND_DIR="$PROJECT_DIR/backend"
|
||||
FRONTEND_DIR="$PROJECT_DIR/frontend"
|
||||
LOG_DIR="$PROJECT_DIR/logs"
|
||||
|
||||
# PID-Dateien
|
||||
BACKEND_PID_FILE="$LOG_DIR/backend.pid"
|
||||
FRONTEND_PID_FILE="$LOG_DIR/frontend.pid"
|
||||
|
||||
# Log-Dateien
|
||||
BACKEND_LOG="$LOG_DIR/backend.log"
|
||||
FRONTEND_LOG="$LOG_DIR/frontend.log"
|
||||
|
||||
# Erstelle Log-Verzeichnis falls nicht vorhanden
|
||||
mkdir -p "$LOG_DIR"
|
||||
|
||||
# Farben für Ausgabe
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
# Hilfsfunktionen
|
||||
log() {
|
||||
echo -e "${GREEN}[$(date +'%Y-%m-%d %H:%M:%S')] $1${NC}"
|
||||
}
|
||||
|
||||
error() {
|
||||
echo -e "${RED}[ERROR] $1${NC}" >&2
|
||||
}
|
||||
|
||||
warning() {
|
||||
echo -e "${YELLOW}[WARNING] $1${NC}"
|
||||
}
|
||||
|
||||
info() {
|
||||
echo -e "${BLUE}[INFO] $1${NC}"
|
||||
}
|
||||
|
||||
# Prüft ob ein Prozess läuft
|
||||
is_running() {
|
||||
local pid_file=$1
|
||||
if [[ -f "$pid_file" ]]; then
|
||||
local pid=$(cat "$pid_file")
|
||||
if kill -0 "$pid" 2>/dev/null; then
|
||||
return 0 # Läuft
|
||||
else
|
||||
rm -f "$pid_file" # PID-Datei aufräumen
|
||||
return 1 # Läuft nicht
|
||||
fi
|
||||
fi
|
||||
return 1 # Läuft nicht
|
||||
}
|
||||
|
||||
# Backend starten
|
||||
start_backend() {
|
||||
if is_running "$BACKEND_PID_FILE"; then
|
||||
warning "Backend läuft bereits (PID: $(cat $BACKEND_PID_FILE))"
|
||||
return 0
|
||||
fi
|
||||
|
||||
log "Starte Backend-Server..."
|
||||
|
||||
cd "$BACKEND_DIR"
|
||||
|
||||
# Starte Backend im Hintergrund
|
||||
nohup /bin/python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload > "$BACKEND_LOG" 2>&1 &
|
||||
local backend_pid=$!
|
||||
|
||||
# Warte kurz und prüfe ob der Prozess gestartet ist
|
||||
sleep 2
|
||||
if kill -0 $backend_pid 2>/dev/null; then
|
||||
echo $backend_pid > "$BACKEND_PID_FILE"
|
||||
log "✅ Backend gestartet (PID: $backend_pid)"
|
||||
log "📍 API: http://localhost:8000"
|
||||
log "📚 Docs: http://localhost:8000/docs"
|
||||
log "📄 Logs: $BACKEND_LOG"
|
||||
else
|
||||
error "Backend konnte nicht gestartet werden"
|
||||
cat "$BACKEND_LOG" 2>/dev/null || true
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Frontend starten
|
||||
start_frontend() {
|
||||
if is_running "$FRONTEND_PID_FILE"; then
|
||||
warning "Frontend läuft bereits (PID: $(cat $FRONTEND_PID_FILE))"
|
||||
return 0
|
||||
fi
|
||||
|
||||
log "Starte Frontend-Server..."
|
||||
|
||||
cd "$FRONTEND_DIR"
|
||||
|
||||
# Starte Frontend im Hintergrund
|
||||
nohup npm run dev > "$FRONTEND_LOG" 2>&1 &
|
||||
local frontend_pid=$!
|
||||
|
||||
# Warte kurz und prüfe ob der Prozess gestartet ist
|
||||
sleep 3
|
||||
if kill -0 $frontend_pid 2>/dev/null; then
|
||||
echo $frontend_pid > "$FRONTEND_PID_FILE"
|
||||
log "✅ Frontend gestartet (PID: $frontend_pid)"
|
||||
log "📍 App: http://192.168.0.12"
|
||||
log "📄 Logs: $FRONTEND_LOG"
|
||||
else
|
||||
error "Frontend konnte nicht gestartet werden"
|
||||
cat "$FRONTEND_LOG" 2>/dev/null || true
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Backend stoppen
|
||||
stop_backend() {
|
||||
if ! is_running "$BACKEND_PID_FILE"; then
|
||||
warning "Backend läuft nicht"
|
||||
return 0
|
||||
fi
|
||||
|
||||
local pid=$(cat "$BACKEND_PID_FILE")
|
||||
log "Stoppe Backend (PID: $pid)..."
|
||||
|
||||
if kill "$pid" 2>/dev/null; then
|
||||
# Warte bis der Prozess beendet ist
|
||||
local count=0
|
||||
while kill -0 "$pid" 2>/dev/null && [ $count -lt 10 ]; do
|
||||
sleep 1
|
||||
((count++))
|
||||
done
|
||||
|
||||
if kill -0 "$pid" 2>/dev/null; then
|
||||
warning "Backend reagiert nicht, erzwinge Stop..."
|
||||
kill -9 "$pid" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
rm -f "$BACKEND_PID_FILE"
|
||||
log "✅ Backend gestoppt"
|
||||
else
|
||||
error "Backend konnte nicht gestoppt werden"
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Frontend stoppen
|
||||
stop_frontend() {
|
||||
if ! is_running "$FRONTEND_PID_FILE"; then
|
||||
warning "Frontend läuft nicht"
|
||||
return 0
|
||||
fi
|
||||
|
||||
local pid=$(cat "$FRONTEND_PID_FILE")
|
||||
log "Stoppe Frontend (PID: $pid)..."
|
||||
|
||||
if kill "$pid" 2>/dev/null; then
|
||||
# Warte bis der Prozess beendet ist
|
||||
local count=0
|
||||
while kill -0 "$pid" 2>/dev/null && [ $count -lt 10 ]; do
|
||||
sleep 1
|
||||
((count++))
|
||||
done
|
||||
|
||||
if kill -0 "$pid" 2>/dev/null; then
|
||||
warning "Frontend reagiert nicht, erzwinge Stop..."
|
||||
kill -9 "$pid" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
rm -f "$FRONTEND_PID_FILE"
|
||||
log "✅ Frontend gestoppt"
|
||||
else
|
||||
error "Frontend konnte nicht gestoppt werden"
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Status anzeigen
|
||||
show_status() {
|
||||
echo ""
|
||||
echo "=== Team Chat System Status ==="
|
||||
echo ""
|
||||
|
||||
# Backend Status
|
||||
if is_running "$BACKEND_PID_FILE"; then
|
||||
echo -e "🟢 Backend: ${GREEN}Läuft${NC} (PID: $(cat $BACKEND_PID_FILE))"
|
||||
echo " 📍 API: http://localhost:8000"
|
||||
echo " 📚 Docs: http://localhost:8000/docs"
|
||||
else
|
||||
echo -e "🔴 Backend: ${RED}Gestoppt${NC}"
|
||||
fi
|
||||
|
||||
# Frontend Status
|
||||
if is_running "$FRONTEND_PID_FILE"; then
|
||||
echo -e "🟢 Frontend: ${GREEN}Läuft${NC} (PID: $(cat $FRONTEND_PID_FILE))"
|
||||
echo " 📍 App: http://192.168.0.12"
|
||||
else
|
||||
echo -e "🔴 Frontend: ${RED}Gestoppt${NC}"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "📁 Logs: $LOG_DIR"
|
||||
echo "📄 Backend Log: $BACKEND_LOG"
|
||||
echo "📄 Frontend Log: $FRONTEND_LOG"
|
||||
}
|
||||
|
||||
# Logs anzeigen
|
||||
show_logs() {
|
||||
local service=$1
|
||||
local lines=${2:-50}
|
||||
|
||||
case $service in
|
||||
backend)
|
||||
if [[ -f "$BACKEND_LOG" ]]; then
|
||||
echo "=== Backend Logs (letzte $lines Zeilen) ==="
|
||||
tail -n "$lines" "$BACKEND_LOG"
|
||||
else
|
||||
warning "Backend-Log nicht gefunden: $BACKEND_LOG"
|
||||
fi
|
||||
;;
|
||||
frontend)
|
||||
if [[ -f "$FRONTEND_LOG" ]]; then
|
||||
echo "=== Frontend Logs (letzte $lines Zeilen) ==="
|
||||
tail -n "$lines" "$FRONTEND_LOG"
|
||||
else
|
||||
warning "Frontend-Log nicht gefunden: $FRONTEND_LOG"
|
||||
fi
|
||||
;;
|
||||
*)
|
||||
error "Unbekannter Service: $service"
|
||||
echo "Verwendung: $0 logs [backend|frontend] [zeilen]"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# Hilfe anzeigen
|
||||
show_help() {
|
||||
echo "Team Chat System - Service Manager"
|
||||
echo ""
|
||||
echo "Verwendung: $0 [command]"
|
||||
echo ""
|
||||
echo "Commands:"
|
||||
echo " start Starte beide Services (Backend + Frontend)"
|
||||
echo " stop Stoppe beide Services"
|
||||
echo " restart Stoppe und starte beide Services neu"
|
||||
echo " start-backend Starte nur Backend"
|
||||
echo " start-frontend Starte nur Frontend"
|
||||
echo " stop-backend Stoppe nur Backend"
|
||||
echo " stop-frontend Stoppe nur Frontend"
|
||||
echo " status Zeige Status aller Services"
|
||||
echo " logs [service] [lines] Zeige Logs (service: backend|frontend, lines: optional)"
|
||||
echo " help Zeige diese Hilfe"
|
||||
echo ""
|
||||
echo "Beispiele:"
|
||||
echo " $0 start # Starte alles"
|
||||
echo " $0 status # Zeige Status"
|
||||
echo " $0 logs backend 100 # Zeige letzte 100 Backend-Logs"
|
||||
echo " $0 stop-frontend # Stoppe nur Frontend"
|
||||
}
|
||||
|
||||
# Hauptlogik
|
||||
case "${1:-help}" in
|
||||
start)
|
||||
log "Starte Team Chat System..."
|
||||
start_backend
|
||||
start_frontend
|
||||
echo ""
|
||||
show_status
|
||||
;;
|
||||
stop)
|
||||
log "Stoppe Team Chat System..."
|
||||
stop_frontend
|
||||
stop_backend
|
||||
echo ""
|
||||
show_status
|
||||
;;
|
||||
restart)
|
||||
log "Restarte Team Chat System..."
|
||||
stop_frontend
|
||||
stop_backend
|
||||
sleep 2
|
||||
start_backend
|
||||
start_frontend
|
||||
echo ""
|
||||
show_status
|
||||
;;
|
||||
start-backend)
|
||||
start_backend
|
||||
;;
|
||||
start-frontend)
|
||||
start_frontend
|
||||
;;
|
||||
stop-backend)
|
||||
stop_backend
|
||||
;;
|
||||
stop-frontend)
|
||||
stop_frontend
|
||||
;;
|
||||
status)
|
||||
show_status
|
||||
;;
|
||||
logs)
|
||||
show_logs "$2" "$3"
|
||||
;;
|
||||
help|--help|-h)
|
||||
show_help
|
||||
;;
|
||||
*)
|
||||
error "Unbekannter Befehl: $1"
|
||||
echo ""
|
||||
show_help
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
Loading…
x
Reference in New Issue
Block a user