App Installer & Manager

Ein Flask-basierter App-Installer und -Manager für Docker-basierte Projekte.

Features

• 🚀 Automatische Installation von Git-Repositories mit Dockerfile
• 🔧 Konfigurationsverwaltung für .env-Dateien
• 🐳 Docker-Integration für Build, Start, Stop und Monitoring
• 📊 Web-Dashboard für Projektübersicht und -verwaltung
• 🔄 Automatische Updates der Projektliste
• 📋 Masseninstallation mehrerer Projekte
• 🛠️ Container-Monitoring mit Logs und Statistiken

Quick Start

1. Dependencies installieren:

   pip install -r requirements.txt
   

2. Docker sicherstellen:

   docker --version
   git --version
   

3. Anwendung starten:

   python app.py
   

4. Browser öffnen:

   http://localhost:5000
   

Konfiguration

Projektliste URL

Konfiguriere eine URL, die eine Liste von Git-Repositories zurückgibt. Unterstützte Formate:

JSON Format:

[
  {
    "url": "https://gitea.simolzimol.net/Simon/quizify",
    "name": "quizify",
    "description": "Ein interaktives Quiz-System",
    "language": "JavaScript",
    "tags": ["quiz", "web"]
  }
]

Gitea API Beispiel:

https://gitea.simolzimol.net/api/v1/repos/search?sort=updated&order=desc&limit=50

GitHub API Beispiel:

https://api.github.com/users/USERNAME/repos

Projekt-Anforderungen

Jedes Projekt sollte enthalten:

• Dockerfile - Für Container-Builds
• .env.example - Für Umgebungskonfiguration
• Optional: docker-compose.yml

API Endpoints

• GET / - Dashboard
• GET /available_projects - Verfügbare Projekte
• GET /config - Konfiguration
• POST /install_project - Projekt installieren
• GET /build_project/<name> - Projekt bauen
• GET /start_project/<name> - Projekt starten
• GET /stop_project/<name> - Projekt stoppen
• GET /project_details/<name> - Projektdetails

Verzeichnisstruktur

app installer/
├── app.py                 # Hauptanwendung
├── requirements.txt       # Python Dependencies
├── config.json           # Konfigurationsdatei
├── config.example.json   # Beispielkonfiguration
├── templates/            # HTML Templates
│   ├── base.html
│   ├── index.html
│   ├── available_projects.html
│   ├── config.html
│   └── project_details.html
├── projects/             # Geklonte Projekte
└── apps/                # Laufende Apps

Unterstützte Git-Provider

• ✅ Gitea
• ✅ GitHub
• ✅ GitLab
• ✅ Beliebige Git-URLs

Docker-Features

• Automatischer Build von Dockerfiles
• Port-Management (8080, 8443, custom)
• Container-Status-Monitoring
• Log-Anzeige in Echtzeit
• Resource-Monitoring (CPU, RAM, Netzwerk)
• Backup & Restore von Containern

Sicherheit

• Isolierte Container-Umgebungen
• Konfigurierbare Port-Bereiche
• Sichere .env-Dateiverwaltung
• Optional: Docker Registry Integration

Erweiterte Features

Masseninstallation

Installiere mehrere Projekte gleichzeitig über das Web-Interface.

Automatische Updates

Projektlisten werden automatisch aktualisiert basierend auf der konfigurierten Frequenz.

Backup & Restore

• Automatische Backups vor Updates
• Manuelle Backup-Erstellung
• Wiederherstellung aus Backups

Monitoring

• Container-Ressourcenverbrauch
• Netzwerk-Statistiken
• Log-Aggregation
• Status-Dashboard

Beispiel-Projekt

Für ein Projekt wie https://gitea.simolzimol.net/Simon/quizify:

1. Repository wird automatisch geklont
2. .env.example → .env kopiert
3. Dockerfile wird gebaut
4. Container wird gestartet
5. Web-Interface zeigt Status an

Troubleshooting

Docker nicht verfügbar

# Windows
Install Docker Desktop

# Linux
sudo systemctl start docker

Port bereits belegt

Der Installer erkennt belegte Ports automatisch und schlägt Alternativen vor.

Build-Fehler

Überprüfe das Dockerfile und die .env-Konfiguration im Projektdetail-Panel.

Roadmap

• Kubernetes-Unterstützung
• Multi-User-Management
• SSL/TLS-Zertifikat-Management
• Plugin-System
• Mobile-optimierte UI
• CI/CD-Integration

Lizenz

MIT License - Siehe LICENSE Datei für Details.

Beitrag

1. Fork das Repository
2. Erstelle einen Feature-Branch
3. Committe deine Änderungen
4. Push zum Branch
5. Erstelle einen Pull Request