Update: Dokumentation und Production Setup überarbeitet
This commit is contained in:
parent
aa4ec84a44
commit
0038b15c5b
596
README.md
596
README.md
@ -1,139 +1,475 @@
|
||||
# 📦 MYP - Manage your Printer
|
||||
# 🖨️ MYP - Manage your Printer
|
||||
|
||||
MYP *(Manage your Printer)* ist eine Plattform zur Reservierung von 3D-Druckern, die für die TBA im Werk 040, Berlin-Marienfelde, entwickelt wurde.
|
||||
[](https://docker.com)
|
||||
[](https://linux.org)
|
||||
[](https://windows.com)
|
||||
[](LICENSE.md)
|
||||
[](https://github.com)
|
||||
|
||||
> Frontend: https://git.i.mercedes-benz.com/TBA-Berlin-FI/MYP/tree/main/frontend
|
||||
MYP *(Manage your Printer)* ist eine moderne, containerbasierte Plattform zur Verwaltung und Reservierung von 3D-Druckern, entwickelt für die TBA im Werk 040, Berlin-Marienfelde.
|
||||
|
||||
> ⚠️ MYP ist zzt. in Entwicklung
|
||||
## 🏗️ Architektur
|
||||
|
||||
> ‼ Datenbank aus Blueprint steht im Konflikt zu MYP.sql - Integration muss besprochen werden
|
||||
Das System basiert auf einer **Microservice-Architektur** mit klarer Trennung zwischen Frontend und Backend:
|
||||
|
||||
> 💡 Vorschlag wenn machbar @Torben: Aufteilung der Datenbanken? API ist ja nur für Drucker zuständig; WebInterface für Authentifizierung, Sessions etc.
|
||||
- **🖥️ Backend**: Flask API Server (Python) - Port 5000
|
||||
- **🌐 Frontend**: Next.js Web Interface (TypeScript/React) - Port 3000
|
||||
- **🔄 Proxy**: Caddy Reverse Proxy - Port 80/443
|
||||
- **📊 Monitoring**: Prometheus & Grafana (Entwicklung)
|
||||
|
||||
> UltiMaker HTTP API: https://support.makerbot.com/s/article/1667412427787
|
||||
### 🔧 Technologie-Stack
|
||||
|
||||
**Backend:**
|
||||
- Flask 3.0+ (Python Web Framework)
|
||||
- SQLAlchemy (ORM)
|
||||
- JWT Authentication
|
||||
- TAPO Smart Plug Integration
|
||||
- RESTful API Design
|
||||
|
||||
**Frontend:**
|
||||
- Next.js 14+ (React Framework)
|
||||
- TypeScript (Type Safety)
|
||||
- Tailwind CSS (Styling)
|
||||
- Drizzle ORM (Database)
|
||||
- Modern UI Components
|
||||
|
||||
**Infrastructure:**
|
||||
- Docker & Docker Compose
|
||||
- Caddy (Reverse Proxy)
|
||||
- Prometheus (Monitoring)
|
||||
- Grafana (Dashboards)
|
||||
|
||||
## 🚀 Schnellstart
|
||||
|
||||
### Voraussetzungen
|
||||
|
||||
- **Docker** & **Docker Compose** installiert
|
||||
- **Git** (empfohlen für Entwicklung)
|
||||
- **4GB RAM** und **10GB freier Speicherplatz**
|
||||
- **PowerShell 5.1+** (Windows) oder **Bash 4.0+** (Linux/macOS)
|
||||
|
||||
### Installation
|
||||
|
||||
1. **Repository klonen**
|
||||
```bash
|
||||
git clone <repository-url>
|
||||
cd Projektarbeit-MYP
|
||||
```
|
||||
|
||||
2. **System starten**
|
||||
|
||||
**Windows:**
|
||||
```powershell
|
||||
# Einfacher Start (Entwicklungsumgebung)
|
||||
.\start.ps1
|
||||
|
||||
# Mit Optionen
|
||||
.\start.ps1 -Help # Hilfe anzeigen
|
||||
.\start.ps1 prod # Produktionsumgebung
|
||||
.\start.ps1 dev -Clean # Mit Bereinigung
|
||||
```
|
||||
|
||||
**Linux/macOS:**
|
||||
```bash
|
||||
# Ausführungsrechte setzen (einmalig)
|
||||
chmod +x start.sh cleanup.sh
|
||||
|
||||
# Einfacher Start (Entwicklungsumgebung)
|
||||
./start.sh
|
||||
|
||||
# Mit Optionen
|
||||
./start.sh --help # Hilfe anzeigen
|
||||
./start.sh prod # Produktionsumgebung
|
||||
./start.sh dev --clean # Mit Bereinigung
|
||||
```
|
||||
|
||||
3. **Zugriff auf die Anwendung**
|
||||
- 🌐 **Web Interface**: http://localhost
|
||||
- 🔧 **Backend API**: http://localhost/api
|
||||
- ⚛️ **Frontend Dev**: http://localhost:3000 (nur Entwicklung)
|
||||
|
||||
## 📋 Verfügbare Umgebungen
|
||||
|
||||
### 🛠️ Entwicklung (Standard)
|
||||
```bash
|
||||
# Windows
|
||||
.\start.ps1 dev
|
||||
|
||||
# Linux/macOS
|
||||
./start.sh dev
|
||||
```
|
||||
|
||||
**Features:**
|
||||
- Hot Reload für Frontend und Backend
|
||||
- Debug-Server auf Port 5555 (Backend) und 8081 (Frontend)
|
||||
- Monitoring: Prometheus (9090), Grafana (3001)
|
||||
- Datenbank-Viewer: Adminer (8080)
|
||||
- Redis Cache (6379)
|
||||
- Entwickler-Tools aktiviert
|
||||
|
||||
### 🚀 Produktion
|
||||
```bash
|
||||
# Windows
|
||||
.\start.ps1 prod
|
||||
|
||||
# Linux/macOS
|
||||
./start.sh prod
|
||||
```
|
||||
|
||||
**Features:**
|
||||
- Optimierte Container-Images
|
||||
- SSL-Verschlüsselung (Let's Encrypt)
|
||||
- Performance-Optimierungen
|
||||
- Sicherheitsheader
|
||||
- Automatische Backups
|
||||
- Health Checks
|
||||
|
||||
### 🧪 Test
|
||||
```bash
|
||||
# Windows
|
||||
.\start.ps1 test
|
||||
|
||||
# Linux/macOS
|
||||
./start.sh test
|
||||
```
|
||||
|
||||
**Features:**
|
||||
- In-Memory-Datenbank
|
||||
- Mock-Services
|
||||
- Test-Fixtures
|
||||
- Coverage-Reports
|
||||
- Automatisierte Tests
|
||||
|
||||
## 🛠️ Entwicklung
|
||||
|
||||
### Projektstruktur
|
||||
|
||||
```
|
||||
Projektarbeit-MYP/
|
||||
├── 🖥️ backend/ # Flask API Server
|
||||
│ ├── app.py # Hauptanwendung
|
||||
│ ├── config.py # Konfiguration
|
||||
│ ├── security.py # Sicherheitsmodule
|
||||
│ ├── monitoring.py # Monitoring & Logging
|
||||
│ ├── requirements.txt # Python-Abhängigkeiten
|
||||
│ ├── Dockerfile # Produktions-Container
|
||||
│ ├── Dockerfile.dev # Entwicklungs-Container
|
||||
│ ├── instance/ # Datenbank & Uploads
|
||||
│ ├── logs/ # Anwendungslogs
|
||||
│ ├── migrations/ # Datenbankmigrationen
|
||||
│ ├── static/ # Statische Dateien
|
||||
│ └── templates/ # HTML-Templates
|
||||
│
|
||||
├── 🌐 frontend/ # Next.js Web Interface
|
||||
│ ├── src/ # Quellcode
|
||||
│ │ ├── app/ # App Router (Next.js 14)
|
||||
│ │ ├── components/ # React-Komponenten
|
||||
│ │ ├── server/ # Server-seitige Logik
|
||||
│ │ └── utils/ # Hilfsfunktionen
|
||||
│ ├── public/ # Öffentliche Dateien
|
||||
│ ├── package.json # Node.js-Abhängigkeiten
|
||||
│ ├── Dockerfile # Produktions-Container
|
||||
│ ├── Dockerfile.dev # Entwicklungs-Container
|
||||
│ ├── tailwind.config.ts # Tailwind-Konfiguration
|
||||
│ ├── tsconfig.json # TypeScript-Konfiguration
|
||||
│ └── drizzle/ # Datenbank-Schema
|
||||
│
|
||||
├── 🔄 proxy/ # Caddy Reverse Proxy
|
||||
│ └── Caddyfile # Proxy-Konfiguration
|
||||
│
|
||||
├── 📊 monitoring/ # Prometheus & Grafana
|
||||
│ ├── prometheus/ # Monitoring-Konfiguration
|
||||
│ └── grafana/ # Dashboard-Konfiguration
|
||||
│
|
||||
├── 🔧 infrastructure/ # Deployment & Konfiguration
|
||||
│ ├── scripts/ # Deployment-Skripte
|
||||
│ │ ├── start.ps1 # Windows-Startskript
|
||||
│ │ ├── start.sh # Linux/macOS-Startskript
|
||||
│ │ ├── cleanup.ps1 # Windows-Bereinigung
|
||||
│ │ └── cleanup.sh # Linux/macOS-Bereinigung
|
||||
│ └── environments/ # Umgebungskonfigurationen
|
||||
│ ├── development.env # Entwicklungsumgebung
|
||||
│ ├── production.env # Produktionsumgebung
|
||||
│ └── test.env # Testumgebung
|
||||
│
|
||||
├── 🧪 tests/ # Übergreifende Tests
|
||||
│ ├── e2e/ # End-to-End-Tests
|
||||
│ └── integration/ # Integrationstests
|
||||
│
|
||||
├── 📚 docs/ # Projektdokumentation
|
||||
├── 📝 logs/ # Systemlogs
|
||||
├── 🐳 docker-compose.yml # Hauptkonfiguration
|
||||
├── 🐳 docker-compose.dev.yml # Entwicklungskonfiguration
|
||||
├── 📋 README.md # Diese Datei
|
||||
├── 📋 PROJECT_STRUCTURE.md # Detaillierte Architektur
|
||||
├── 📋 Dokumentation.md # Deutsche Dokumentation
|
||||
└── 📄 LICENSE.md # Lizenzinformationen
|
||||
```
|
||||
|
||||
### Backend-Entwicklung
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
|
||||
# Virtuelle Umgebung erstellen
|
||||
python -m venv venv
|
||||
|
||||
# Aktivieren
|
||||
source venv/bin/activate # Linux/macOS
|
||||
venv\Scripts\activate # Windows
|
||||
|
||||
# Abhängigkeiten installieren
|
||||
pip install -r requirements.txt
|
||||
|
||||
# Entwicklungsserver starten
|
||||
flask run --debug --host=0.0.0.0 --port=5000
|
||||
```
|
||||
|
||||
### Frontend-Entwicklung
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
|
||||
# Abhängigkeiten installieren
|
||||
pnpm install
|
||||
|
||||
# Entwicklungsserver starten
|
||||
pnpm dev
|
||||
|
||||
# Build für Produktion
|
||||
pnpm build
|
||||
|
||||
# Linting & Formatierung
|
||||
pnpm lint
|
||||
pnpm format
|
||||
```
|
||||
|
||||
### API-Dokumentation
|
||||
|
||||
Die API-Dokumentation ist verfügbar unter:
|
||||
- **Swagger UI**: http://localhost/api/docs
|
||||
- **OpenAPI Spec**: http://localhost/api/swagger.json
|
||||
- **Redoc**: http://localhost/api/redoc
|
||||
|
||||
## 🔧 Konfiguration
|
||||
|
||||
### Umgebungsvariablen
|
||||
|
||||
Konfigurationsdateien befinden sich in `infrastructure/environments/`:
|
||||
|
||||
- `development.env` - Entwicklungsumgebung
|
||||
- `production.env` - Produktionsumgebung
|
||||
- `test.env` - Testumgebung
|
||||
|
||||
### Drucker-Konfiguration
|
||||
|
||||
Drucker werden über die `PRINTERS` Umgebungsvariable konfiguriert:
|
||||
|
||||
```json
|
||||
{
|
||||
"Drucker 1": {
|
||||
"ip": "192.168.0.100",
|
||||
"model": "UltiMaker S5",
|
||||
"location": "Raum A.1.01"
|
||||
},
|
||||
"Drucker 2": {
|
||||
"ip": "192.168.0.101",
|
||||
"model": "UltiMaker S5",
|
||||
"location": "Raum A.1.02"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### TAPO Smart Plug Integration
|
||||
|
||||
```env
|
||||
TAPO_USERNAME=your-email@example.com
|
||||
TAPO_PASSWORD=your-secure-password
|
||||
```
|
||||
|
||||
### SSL/TLS-Konfiguration (Produktion)
|
||||
|
||||
```env
|
||||
CADDY_DOMAIN=your-domain.com
|
||||
CADDY_EMAIL=admin@your-domain.com
|
||||
SSL_ENABLED=true
|
||||
```
|
||||
|
||||
## 🧹 Wartung
|
||||
|
||||
### System bereinigen
|
||||
|
||||
**Windows:**
|
||||
```powershell
|
||||
# Interaktive Bereinigung
|
||||
.\cleanup.ps1
|
||||
|
||||
# Automatische Bereinigung
|
||||
.\cleanup.ps1 -Force
|
||||
|
||||
# Vollständige Bereinigung (inkl. Volumes)
|
||||
.\cleanup.ps1 -All -Force
|
||||
```
|
||||
|
||||
**Linux/macOS:**
|
||||
```bash
|
||||
# Interaktive Bereinigung
|
||||
./cleanup.sh
|
||||
|
||||
# Automatische Bereinigung
|
||||
./cleanup.sh --force
|
||||
|
||||
# Vollständige Bereinigung (inkl. Volumes)
|
||||
./cleanup.sh --all --force
|
||||
```
|
||||
|
||||
### Logs anzeigen
|
||||
|
||||
```bash
|
||||
# Alle Services
|
||||
docker-compose logs -f
|
||||
|
||||
# Spezifische Services
|
||||
docker-compose logs -f backend
|
||||
docker-compose logs -f frontend
|
||||
docker-compose logs -f caddy
|
||||
|
||||
# Mit Zeitstempel
|
||||
docker-compose logs -f -t
|
||||
```
|
||||
|
||||
### Container-Status prüfen
|
||||
|
||||
```bash
|
||||
# Status aller Container
|
||||
docker-compose ps
|
||||
|
||||
# Detaillierte Informationen
|
||||
docker-compose top
|
||||
|
||||
# Ressourcenverbrauch
|
||||
docker stats
|
||||
|
||||
# Health Checks
|
||||
docker-compose exec backend curl -f http://localhost:5000/health
|
||||
docker-compose exec frontend curl -f http://localhost:3000/api/health
|
||||
```
|
||||
|
||||
### Backup & Restore
|
||||
|
||||
```bash
|
||||
# Datenbank-Backup erstellen
|
||||
docker-compose exec backend python -c "
|
||||
import sqlite3
|
||||
import shutil
|
||||
shutil.copy('instance/myp.db', 'instance/backup_$(date +%Y%m%d_%H%M%S).db')
|
||||
"
|
||||
|
||||
# Logs archivieren
|
||||
tar -czf logs_backup_$(date +%Y%m%d_%H%M%S).tar.gz logs/
|
||||
```
|
||||
|
||||
## 🔒 Sicherheit
|
||||
|
||||
### Produktionsumgebung
|
||||
|
||||
- **SSL/TLS**: Automatische Let's Encrypt-Zertifikate
|
||||
- **Security Headers**: HSTS, CSP, X-Frame-Options
|
||||
- **Rate Limiting**: API-Endpunkt-Schutz
|
||||
- **Authentication**: JWT-basierte Authentifizierung
|
||||
- **Input Validation**: Umfassende Eingabevalidierung
|
||||
- **CORS**: Konfigurierbare Cross-Origin-Richtlinien
|
||||
|
||||
### Geheimnisse verwalten
|
||||
|
||||
```bash
|
||||
# Sichere Umgebungsvariablen setzen
|
||||
echo "SECRET_KEY=$(openssl rand -hex 32)" >> infrastructure/environments/production.env
|
||||
echo "JWT_SECRET=$(openssl rand -hex 32)" >> infrastructure/environments/production.env
|
||||
```
|
||||
|
||||
## 🚨 Fehlerbehebung
|
||||
|
||||
### Häufige Probleme
|
||||
|
||||
**Docker-Container starten nicht:**
|
||||
```bash
|
||||
# Docker-Status prüfen
|
||||
docker info
|
||||
|
||||
# Container-Logs anzeigen
|
||||
docker-compose logs
|
||||
|
||||
# Ports prüfen
|
||||
netstat -tulpn | grep :80
|
||||
netstat -tulpn | grep :3000
|
||||
netstat -tulpn | grep :5000
|
||||
```
|
||||
|
||||
**Frontend kann Backend nicht erreichen:**
|
||||
```bash
|
||||
# Netzwerk-Konfiguration prüfen
|
||||
docker network ls
|
||||
docker network inspect projektarbeit-myp_myp-network
|
||||
|
||||
# API-Erreichbarkeit testen
|
||||
curl -f http://localhost/api/health
|
||||
```
|
||||
|
||||
**Datenbank-Probleme:**
|
||||
```bash
|
||||
# Datenbank-Integrität prüfen
|
||||
docker-compose exec backend python -c "
|
||||
import sqlite3
|
||||
conn = sqlite3.connect('instance/myp.db')
|
||||
conn.execute('PRAGMA integrity_check;')
|
||||
print(conn.fetchall())
|
||||
"
|
||||
```
|
||||
|
||||
### Support
|
||||
|
||||
Bei Problemen:
|
||||
1. Prüfen Sie die Logs: `docker-compose logs`
|
||||
2. Überprüfen Sie die Systemvoraussetzungen
|
||||
3. Führen Sie eine Bereinigung durch: `./cleanup.sh --force`
|
||||
4. Starten Sie das System neu: `./start.sh`
|
||||
|
||||
## 📈 Performance
|
||||
|
||||
### Monitoring
|
||||
|
||||
- **Prometheus**: http://localhost:9090 (nur Entwicklung)
|
||||
- **Grafana**: http://localhost:3001 (nur Entwicklung)
|
||||
- **Caddy Admin**: http://localhost:2019
|
||||
|
||||
### Optimierungen
|
||||
|
||||
- **Container-Images**: Multi-Stage-Builds für minimale Größe
|
||||
- **Caching**: Redis für Session-Management
|
||||
- **CDN**: Statische Assets über Caddy
|
||||
- **Database**: SQLite mit WAL-Modus für bessere Performance
|
||||
|
||||
## 🤝 Beitragen
|
||||
|
||||
1. Fork des Repositories erstellen
|
||||
2. Feature-Branch erstellen: `git checkout -b feature/neue-funktion`
|
||||
3. Änderungen committen: `git commit -am 'Neue Funktion hinzufügen'`
|
||||
4. Branch pushen: `git push origin feature/neue-funktion`
|
||||
5. Pull Request erstellen
|
||||
|
||||
## 📄 Lizenz
|
||||
|
||||
Dieses Projekt steht unter der MIT-Lizenz. Siehe [LICENSE.md](LICENSE.md) für Details.
|
||||
|
||||
## 🙏 Danksagungen
|
||||
|
||||
- **TBA Werk 040** - Für die Unterstützung und Anforderungen
|
||||
- **Open Source Community** - Für die verwendeten Technologien
|
||||
- **Docker Team** - Für die Container-Technologie
|
||||
- **Next.js Team** - Für das Frontend-Framework
|
||||
- **Flask Team** - Für das Backend-Framework
|
||||
|
||||
---
|
||||
|
||||
# Datenbankstruktur
|
||||
|
||||
(MYP.sql - Gerät: Reservation Pi)
|
||||
|
||||
### Printer
|
||||
|
||||
- Speichert Informationen zu Druckern.
|
||||
- Beinhaltet Details wie Namen, Beschreibung und Betriebsstatus.
|
||||
- Verknüpft mit Druckaufträgen.
|
||||
|
||||
### PrintJob
|
||||
|
||||
- Enthält alle Druckaufträge.
|
||||
- Jeder Auftrag ist einem Drucker und einem Benutzer zugeordnet.
|
||||
- Speichert Startzeit, Dauer und Kommentare zu den Aufträgen.
|
||||
- Erfassung, ob ein Auftrag abgebrochen wurde und die dazugehörige Begründung.
|
||||
|
||||
### Account
|
||||
|
||||
- Verwaltet Benutzerkonten.
|
||||
- Speichert Authentifizierungsdetails wie Tokens und deren Ablaufzeiten.
|
||||
|
||||
### Session
|
||||
|
||||
- Erfasst Session-Daten.
|
||||
- Beinhaltet eindeutige Session-Tokens und Ablaufdaten.
|
||||
|
||||
### User
|
||||
|
||||
- Speichert Benutzerinformationen.
|
||||
- Verknüpft mit Druckaufträgen, Accounts und Sessions.
|
||||
|
||||
## Fremdschlüsselbeziehungen
|
||||
|
||||
- `User` ist verknüpft mit `PrintJob`, `Account` und `Session` über Benutzer-ID.
|
||||
- `Printer` ist verknüpft mit `PrintJob` über die Drucker-ID.
|
||||
|
||||
## Installation und Start
|
||||
|
||||
### Windows
|
||||
|
||||
1. Stellen Sie sicher, dass Docker Desktop installiert und gestartet ist.
|
||||
2. Öffnen Sie PowerShell und navigieren Sie zum Projektverzeichnis.
|
||||
3. Führen Sie das Start-Skript aus:
|
||||
```
|
||||
.\start.ps1
|
||||
```
|
||||
|
||||
### Linux/Mac
|
||||
|
||||
1. Stellen Sie sicher, dass Docker installiert und gestartet ist.
|
||||
2. Öffnen Sie ein Terminal und navigieren Sie zum Projektverzeichnis.
|
||||
3. Machen Sie die Skripte ausführbar:
|
||||
```
|
||||
chmod +x start.sh cleanup.sh
|
||||
```
|
||||
4. Führen Sie das Start-Skript aus:
|
||||
```
|
||||
./start.sh
|
||||
```
|
||||
|
||||
## Bereinigung der Umgebung
|
||||
|
||||
Um eine vollständige Bereinigung aller Container, Images und Volumes durchzuführen, können Sie folgende Skripte verwenden:
|
||||
|
||||
### Windows
|
||||
|
||||
```
|
||||
.\cleanup.ps1
|
||||
```
|
||||
|
||||
### Linux/Mac
|
||||
|
||||
```
|
||||
./cleanup.sh
|
||||
```
|
||||
|
||||
Die Bereinigung kann auch während des Starts der Anwendung durchgeführt werden, wenn alte Container erkannt werden.
|
||||
|
||||
## Backend-Interface
|
||||
|
||||
Das Backend-Interface ist unter folgenden URLs erreichbar:
|
||||
|
||||
- Produktionsumgebung: http://localhost:5000
|
||||
- Debug-Server: http://localhost:5555
|
||||
|
||||
## Frontend-Interface
|
||||
|
||||
Das Frontend-Interface ist unter folgenden URLs erreichbar:
|
||||
|
||||
- Produktionsumgebung: http://localhost:80 oder https://localhost:443
|
||||
- Debug-Server: http://localhost:8081
|
||||
|
||||
## SSH-Server
|
||||
|
||||
Die Start-Skripte sorgen automatisch dafür, dass ein SSH-Server installiert, aktiviert und gestartet wird:
|
||||
|
||||
- Unter Linux: Verwendet systemd, um den OpenSSH-Server zu aktivieren und zu starten
|
||||
- Unter Windows: Installiert und konfiguriert den Windows OpenSSH-Server
|
||||
|
||||
Der SSH-Server wird so konfiguriert, dass er automatisch beim Systemstart aktiviert wird, um einen Fernzugriff auf das System zu ermöglichen. Auf Windows-Systemen wird auch eine entsprechende Firewall-Regel erstellt.
|
||||
|
||||
### Manuelles Einrichten des SSH-Servers
|
||||
|
||||
Falls die automatische Installation fehlschlägt:
|
||||
|
||||
#### Linux (Debian/Ubuntu)
|
||||
```
|
||||
sudo apt-get update
|
||||
sudo apt-get install openssh-server
|
||||
sudo systemctl enable ssh
|
||||
sudo systemctl start ssh
|
||||
```
|
||||
|
||||
#### Windows 10/11
|
||||
1. Öffnen Sie "Einstellungen" > "Apps" > "Optionale Features"
|
||||
2. Klicken Sie auf "Feature hinzufügen" und wählen Sie "OpenSSH Server"
|
||||
3. Nach der Installation öffnen Sie PowerShell als Administrator und führen Sie folgende Befehle aus:
|
||||
```
|
||||
Set-Service -Name sshd -StartupType Automatic
|
||||
Start-Service sshd
|
||||
New-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -DisplayName 'OpenSSH Server (TCP-In)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22
|
||||
```
|
||||
**Entwickelt mit ❤️ für die TBA im Werk 040, Berlin-Marienfelde**
|
||||
|
||||
@ -1 +1,327 @@
|
||||
# MYP Backend - Produktions-Setup Anleitung
|
||||
|
||||
Diese Anleitung beschreibt die Installation und Konfiguration des MYP Backends für den Produktionsbetrieb.
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
- Linux-Server (Ubuntu 20.04 LTS oder höher empfohlen)
|
||||
- Python 3.8 oder höher
|
||||
- Nginx (optional, für Reverse Proxy)
|
||||
- Systemd (für Service-Management)
|
||||
|
||||
## Installation
|
||||
|
||||
### 1. System-Updates und Abhängigkeiten
|
||||
|
||||
```bash
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
sudo apt install python3 python3-pip python3-venv nginx sqlite3 -y
|
||||
```
|
||||
|
||||
### 2. Benutzer und Verzeichnisse erstellen
|
||||
|
||||
```bash
|
||||
# MYP-Benutzer erstellen
|
||||
sudo useradd --system --group --home /opt/myp myp
|
||||
|
||||
# Verzeichnisse erstellen
|
||||
sudo mkdir -p /opt/myp/{backend,logs}
|
||||
sudo chown -R myp:myp /opt/myp
|
||||
```
|
||||
|
||||
### 3. Anwendung installieren
|
||||
|
||||
```bash
|
||||
# Als myp-Benutzer wechseln
|
||||
sudo -u myp bash
|
||||
|
||||
# In das Backend-Verzeichnis wechseln
|
||||
cd /opt/myp/backend
|
||||
|
||||
# Repository klonen (oder Dateien kopieren)
|
||||
# git clone https://github.com/your-org/myp.git .
|
||||
|
||||
# Virtual Environment erstellen
|
||||
python3 -m venv /opt/myp/venv
|
||||
source /opt/myp/venv/bin/activate
|
||||
|
||||
# Dependencies installieren
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### 4. Konfiguration
|
||||
|
||||
```bash
|
||||
# Umgebungsvariablen konfigurieren
|
||||
cp env.example .env
|
||||
nano .env
|
||||
|
||||
# Wichtige Konfigurationen:
|
||||
# - SECRET_KEY: Sicheren Schlüssel generieren
|
||||
# - TAPO_USERNAME/TAPO_PASSWORD: Tapo-Anmeldedaten
|
||||
# - PRINTERS: Drucker-Konfiguration als JSON
|
||||
```
|
||||
|
||||
#### Beispiel für sichere SECRET_KEY-Generierung:
|
||||
|
||||
```bash
|
||||
python3 -c "import secrets; print(secrets.token_hex(32))"
|
||||
```
|
||||
|
||||
### 5. Datenbank initialisieren
|
||||
|
||||
```bash
|
||||
# Datenbank-Verzeichnis erstellen
|
||||
mkdir -p instance
|
||||
|
||||
# Flask-Anwendung starten, um Datenbank zu initialisieren
|
||||
python3 app.py
|
||||
# Ctrl+C nach erfolgreicher Initialisierung
|
||||
```
|
||||
|
||||
### 6. Systemd Service einrichten
|
||||
|
||||
```bash
|
||||
# Als root-Benutzer
|
||||
sudo cp myp-backend.service /etc/systemd/system/
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable myp-backend
|
||||
sudo systemctl start myp-backend
|
||||
```
|
||||
|
||||
### 7. Service-Status überprüfen
|
||||
|
||||
```bash
|
||||
sudo systemctl status myp-backend
|
||||
sudo journalctl -u myp-backend -f
|
||||
```
|
||||
|
||||
## Nginx Reverse Proxy (Optional)
|
||||
|
||||
### Nginx-Konfiguration erstellen
|
||||
|
||||
```bash
|
||||
sudo nano /etc/nginx/sites-available/myp-backend
|
||||
```
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com;
|
||||
|
||||
location / {
|
||||
proxy_pass http://127.0.0.1:5000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_connect_timeout 30;
|
||||
proxy_send_timeout 30;
|
||||
proxy_read_timeout 30;
|
||||
}
|
||||
|
||||
# Statische Dateien direkt ausliefern
|
||||
location /static/ {
|
||||
alias /opt/myp/backend/static/;
|
||||
expires 1h;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
|
||||
# Health Check
|
||||
location /monitoring/health/simple {
|
||||
access_log off;
|
||||
proxy_pass http://127.0.0.1:5000;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Nginx aktivieren
|
||||
|
||||
```bash
|
||||
sudo ln -s /etc/nginx/sites-available/myp-backend /etc/nginx/sites-enabled/
|
||||
sudo nginx -t
|
||||
sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
## SSL/HTTPS Setup (Empfohlen)
|
||||
|
||||
### Mit Let's Encrypt (Certbot)
|
||||
|
||||
```bash
|
||||
sudo apt install certbot python3-certbot-nginx -y
|
||||
sudo certbot --nginx -d your-domain.com
|
||||
```
|
||||
|
||||
### Umgebungsvariable für HTTPS setzen
|
||||
|
||||
```bash
|
||||
# In .env-Datei
|
||||
FORCE_HTTPS=true
|
||||
```
|
||||
|
||||
## Monitoring und Logs
|
||||
|
||||
### Log-Dateien
|
||||
|
||||
- Anwendungs-Logs: `/opt/myp/backend/logs/myp.log`
|
||||
- Error-Logs: `/opt/myp/backend/logs/myp-errors.log`
|
||||
- Security-Logs: `/opt/myp/backend/logs/security.log`
|
||||
- Systemd-Logs: `journalctl -u myp-backend`
|
||||
|
||||
### Health Check-Endpunkte
|
||||
|
||||
- Einfacher Health Check: `http://your-domain.com/monitoring/health/simple`
|
||||
- Detaillierter Health Check: `http://your-domain.com/monitoring/health`
|
||||
- System-Metriken: `http://your-domain.com/monitoring/metrics`
|
||||
- Anwendungsinfo: `http://your-domain.com/monitoring/info`
|
||||
|
||||
## Wartung und Updates
|
||||
|
||||
### Service neustarten
|
||||
|
||||
```bash
|
||||
sudo systemctl restart myp-backend
|
||||
```
|
||||
|
||||
### Logs rotieren
|
||||
|
||||
Die Log-Rotation ist automatisch konfiguriert. Bei Bedarf manuell:
|
||||
|
||||
```bash
|
||||
sudo logrotate -f /etc/logrotate.d/myp-backend
|
||||
```
|
||||
|
||||
### Updates installieren
|
||||
|
||||
```bash
|
||||
sudo -u myp bash
|
||||
cd /opt/myp/backend
|
||||
source /opt/myp/venv/bin/activate
|
||||
|
||||
# Code aktualisieren
|
||||
git pull
|
||||
|
||||
# Dependencies aktualisieren
|
||||
pip install -r requirements.txt --upgrade
|
||||
|
||||
# Service neustarten
|
||||
sudo systemctl restart myp-backend
|
||||
```
|
||||
|
||||
### Datenbank-Backup
|
||||
|
||||
```bash
|
||||
# Backup erstellen
|
||||
sudo -u myp sqlite3 /opt/myp/backend/instance/myp.db ".backup /opt/myp/backup/myp_$(date +%Y%m%d_%H%M%S).db"
|
||||
|
||||
# Automatisches Backup via Cron
|
||||
sudo -u myp crontab -e
|
||||
# Füge hinzu: 0 2 * * * sqlite3 /opt/myp/backend/instance/myp.db ".backup /opt/myp/backup/myp_$(date +\%Y\%m\%d_\%H\%M\%S).db"
|
||||
```
|
||||
|
||||
## Sicherheit
|
||||
|
||||
### Firewall konfigurieren
|
||||
|
||||
```bash
|
||||
sudo ufw allow ssh
|
||||
sudo ufw allow 'Nginx Full'
|
||||
sudo ufw --force enable
|
||||
```
|
||||
|
||||
### Fail2Ban für zusätzlichen Schutz
|
||||
|
||||
```bash
|
||||
sudo apt install fail2ban -y
|
||||
sudo nano /etc/fail2ban/jail.local
|
||||
```
|
||||
|
||||
```ini
|
||||
[DEFAULT]
|
||||
bantime = 3600
|
||||
findtime = 600
|
||||
maxretry = 5
|
||||
|
||||
[nginx-http-auth]
|
||||
enabled = true
|
||||
port = http,https
|
||||
logpath = /var/log/nginx/error.log
|
||||
```
|
||||
|
||||
### Regelmäßige Security-Updates
|
||||
|
||||
```bash
|
||||
sudo apt install unattended-upgrades -y
|
||||
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Service startet nicht
|
||||
|
||||
```bash
|
||||
# Logs überprüfen
|
||||
sudo journalctl -u myp-backend --no-pager
|
||||
sudo -u myp cat /opt/myp/backend/logs/myp-errors.log
|
||||
```
|
||||
|
||||
### Hohe Speichernutzung
|
||||
|
||||
```bash
|
||||
# Memory-Statistiken
|
||||
sudo systemctl status myp-backend
|
||||
sudo ps aux | grep gunicorn
|
||||
```
|
||||
|
||||
### Datenbankprobleme
|
||||
|
||||
```bash
|
||||
# Datenbank-Integrität prüfen
|
||||
sudo -u myp sqlite3 /opt/myp/backend/instance/myp.db "PRAGMA integrity_check;"
|
||||
```
|
||||
|
||||
### Netzwerk-Konnektivität
|
||||
|
||||
```bash
|
||||
# Port-Verfügbarkeit prüfen
|
||||
sudo netstat -tlnp | grep :5000
|
||||
curl -I http://localhost:5000/monitoring/health/simple
|
||||
```
|
||||
|
||||
## Performance-Optimierung
|
||||
|
||||
### Gunicorn Worker anpassen
|
||||
|
||||
```bash
|
||||
# In .env oder Service-Datei
|
||||
WORKERS=8 # 2 * CPU-Kerne + 1
|
||||
```
|
||||
|
||||
### Nginx-Caching aktivieren
|
||||
|
||||
```nginx
|
||||
# In Nginx-Konfiguration
|
||||
location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
```
|
||||
|
||||
### SQLite-Optimierung
|
||||
|
||||
```sql
|
||||
-- Für bessere Performance (einmalig ausführen)
|
||||
PRAGMA journal_mode=WAL;
|
||||
PRAGMA synchronous=NORMAL;
|
||||
PRAGMA cache_size=10000;
|
||||
PRAGMA temp_store=memory;
|
||||
```
|
||||
|
||||
## Support
|
||||
|
||||
Bei Problemen oder Fragen:
|
||||
|
||||
1. Überprüfen Sie die Log-Dateien
|
||||
2. Testen Sie die Health Check-Endpunkte
|
||||
3. Konsultieren Sie die Systemd-Logs
|
||||
4. Kontaktieren Sie das Entwicklungsteam
|
||||
Loading…
x
Reference in New Issue
Block a user