Aiirondev_dev
280d25dda9
- Removed the JWT authentication setup and related access token handling. - Deleted the test license activation functionality and associated routes. - Removed the admin license management interface and related templates. - Cleaned up the appointments page by removing test license options. - Updated various templates to reflect changes in terminology from "license" to "instance". - Removed the verify module and its associated functions for license key management. - Deleted unused templates related to license management. - Added a new empty JSON file for licenses backup.
181 lines
5.0 KiB
Markdown
181 lines
5.0 KiB
Markdown
# Key Service Server
|
|
|
|
Dieses Repository ist auf einen schlanken, Docker-first Betrieb ausgerichtet.
|
|
|
|
## Voraussetzungen
|
|
|
|
- Docker Engine + Docker Compose Plugin
|
|
- Nginx
|
|
- OpenSSL
|
|
- Optional: UFW (Ports 80/443 werden bei aktivem UFW automatisch freigegeben)
|
|
|
|
## Script Matrix
|
|
|
|
### Core-Skripte (aktiv)
|
|
|
|
- [gitea.sh](gitea.sh)
|
|
- Start/Stop/Restart/Status für Gitea + Website-Stack
|
|
- [nginx.sh](nginx.sh)
|
|
- Nginx-Konfiguration anwenden/deaktivieren
|
|
- [Website/provision_instance.sh](Website/provision_instance.sh)
|
|
- Instanz-Provisioning für Inventarsystem (release-basiert, Multiinstancing-aware)
|
|
- [Website/launch_dev.sh](Website/launch_dev.sh)
|
|
- Dev-Start der Website inkl. Host-Sync
|
|
- [Website/launch_prod.sh](Website/launch_prod.sh)
|
|
- Prod-Start der Website inkl. Host-Sync
|
|
- [Website/start_docker_build.sh](Website/start_docker_build.sh)
|
|
- Build/Start-Helfer für Website-Container
|
|
- [Website/sync_dev_hosts.sh](Website/sync_dev_hosts.sh)
|
|
- Synchronisiert dynamische Subdomains in /etc/hosts
|
|
|
|
### Setup-Skripte (optional, aktiv)
|
|
|
|
- [setup-first-install.sh](setup-first-install.sh)
|
|
- Führt Erstinstallation in einem Ablauf aus (Start, Nginx, Hosts-Sync-Service, Autostart-Service)
|
|
- [setup-hosts-sync.sh](setup-hosts-sync.sh)
|
|
- Installiert den systemd-Service für automatische Hosts-Synchronisierung
|
|
- [setup-stack-autostart.sh](setup-stack-autostart.sh)
|
|
- Installiert den systemd-Service für Stack-Autostart über gitea.sh
|
|
|
|
### Legacy-Skripte (entfernt)
|
|
|
|
- start-stack-on-boot.sh (durch direkten systemd-ExecStart auf gitea.sh ersetzt)
|
|
- provision_instance.sh im Repo-Root (Duplikat, Website-Version ist Single Source)
|
|
- Website/run.sh (alt, nicht Teil des aktuellen Flows)
|
|
- Website/test.sh (alt, nicht Teil des aktuellen Flows)
|
|
|
|
## Core Betrieb
|
|
|
|
### Docker Services
|
|
|
|
Datei: [gitea.sh](gitea.sh)
|
|
|
|
Befehle:
|
|
|
|
- sudo ./gitea.sh start
|
|
- sudo ./gitea.sh stop
|
|
- sudo ./gitea.sh restart
|
|
- sudo ./gitea.sh status
|
|
|
|
Wichtige Ports:
|
|
|
|
- Gitea intern: 127.0.0.1:3001
|
|
- Gitea SSH: 2222
|
|
- Website Upstream: 4999
|
|
|
|
### Nginx
|
|
|
|
Datei: [nginx.sh](nginx.sh)
|
|
|
|
Befehle:
|
|
|
|
- sudo ./nginx.sh apply
|
|
- sudo ./nginx.sh disable
|
|
- sudo ./nginx.sh deactivate
|
|
|
|
Nginx-Templates:
|
|
|
|
- [nginx/gitea.http.conf.template](nginx/gitea.http.conf.template)
|
|
- [nginx/gitea.https.conf.template](nginx/gitea.https.conf.template)
|
|
- [nginx/website.http.conf.template](nginx/website.http.conf.template)
|
|
- [nginx/website.https.conf.template](nginx/website.https.conf.template)
|
|
|
|
## Inventarsystem Instanzen
|
|
|
|
Admin-Oberfläche:
|
|
|
|
- Route: /admin/instances
|
|
- Menu: Schul-Instanzen
|
|
|
|
Provisioning-Flow:
|
|
|
|
1. Admin wählt Nutzer, Schule, Version und optional Subdomain.
|
|
2. Backend ruft [Website/provision_instance.sh](Website/provision_instance.sh) auf.
|
|
3. Provisioning installiert release-basiert aus GitHub-Releases.
|
|
4. Wenn verfügbar, wird docker-compose-multitenant.yml bevorzugt genutzt.
|
|
5. Instanzstatus wird in school_instances gespeichert.
|
|
|
|
Wichtige Website-Variablen:
|
|
|
|
- INSTANCE_REPO_URL (default: https://github.com/AIIrondev/legendary-octo-garbanzo)
|
|
- INSTANCE_PARENT_DOMAIN (default: meine-domain)
|
|
- INSTANCE_BASE_DIR (default: /opt/inventarsystem-instances)
|
|
- INSTANCE_PROVISION_SCRIPT (default: Website/provision_instance.sh)
|
|
|
|
Berechtigungen für Provisioning:
|
|
|
|
- Docker-Zugriff
|
|
- Schreibrechte auf /etc/nginx/sites-available und /etc/nginx/sites-enabled
|
|
- nginx -t und nginx reload/signal-Rechte
|
|
|
|
## Admin Homepage: Live-Logs
|
|
|
|
Die Admin-Seite unter /admin/system zeigt jetzt Live-Logs direkt im Frontend.
|
|
|
|
Enthaltene Quellen:
|
|
|
|
- Core Docker Logs (website + mongodb)
|
|
- invario-hosts-sync.service
|
|
- invario-stack-autostart.service
|
|
- nginx.service
|
|
|
|
Verhalten:
|
|
|
|
- Auto-Refresh alle 20 Sekunden
|
|
- Manuelles Aktualisieren per Button
|
|
- Auswahl der Log-Quelle per Dropdown
|
|
|
|
Hinweis:
|
|
|
|
- Wenn die Website ohne Zugriff auf systemd/journalctl läuft (z. B. in eingeschränkten Containern), bleiben Core-Docker-Logs verfügbar, während Service-Logs als nicht verfügbar angezeigt werden können.
|
|
|
|
## Betriebsmodi Website
|
|
|
|
- Development: [Website/launch_dev.sh](Website/launch_dev.sh)
|
|
- Production: [Website/launch_prod.sh](Website/launch_prod.sh)
|
|
|
|
Beispiel Production:
|
|
|
|
```bash
|
|
cd Website
|
|
export INSTANCE_PARENT_DOMAIN=example.de
|
|
export INSTANCE_WILDCARD_CERT_FILE=/etc/nginx/certs/wildcard.example.de.crt
|
|
export INSTANCE_WILDCARD_KEY_FILE=/etc/nginx/certs/wildcard.example.de.key
|
|
./launch_prod.sh
|
|
```
|
|
|
|
## Empfohlener Ablauf
|
|
|
|
1. sudo ./gitea.sh start
|
|
2. sudo ./nginx.sh apply
|
|
3. sudo ./gitea.sh status
|
|
|
|
## Erstinstallation (automatisiert)
|
|
|
|
Für eine neue Maschine kann die Erstinstallation in einem Schritt ausgeführt werden:
|
|
|
|
```bash
|
|
sudo ./setup-first-install.sh
|
|
```
|
|
|
|
Standardmäßig macht das Skript:
|
|
|
|
1. Startet den Stack über gitea.sh.
|
|
2. Wendet nginx.sh apply an.
|
|
3. Installiert den Hosts-Sync-systemd-Service.
|
|
4. Installiert den Stack-Autostart-systemd-Service.
|
|
|
|
Optionen:
|
|
|
|
- --skip-start
|
|
- --skip-nginx
|
|
- --skip-hosts-sync
|
|
- --skip-autostart
|
|
|
|
## Quick Verify
|
|
|
|
```bash
|
|
sudo ./gitea.sh status
|
|
sudo systemctl status invario-hosts-sync --no-pager
|
|
sudo systemctl status invario-stack-autostart --no-pager
|
|
``` |