Aiirondev_dev
d9b812812f
- Removed `run.sh` and `test.sh` scripts to simplify the project structure. - Added `setup-first-install.sh` to handle initial setup tasks with options to skip specific steps. - Updated `invario-stack-autostart.service` to use `gitea.sh` for starting the stack on boot. - Removed `start-stack-on-boot.sh` as its functionality is now integrated into the service. - Enhanced `admin_system.html` with a new live logs panel, including automatic updates and log source selection. - Improved CSS styles for the new logs panel for better UI consistency. - Added JavaScript functionality to fetch and display live logs from the server.
4.2 KiB
4.2 KiB
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
- Start/Stop/Restart/Status für Gitea + Website-Stack
- nginx.sh
- Nginx-Konfiguration anwenden/deaktivieren
- Website/provision_instance.sh
- Instanz-Provisioning für Inventarsystem (release-basiert, Multiinstancing-aware)
- Website/launch_dev.sh
- Dev-Start der Website inkl. Host-Sync
- Website/launch_prod.sh
- Prod-Start der Website inkl. Host-Sync
- Website/start_docker_build.sh
- Build/Start-Helfer für Website-Container
- Website/sync_dev_hosts.sh
- Synchronisiert dynamische Subdomains in /etc/hosts
Setup-Skripte (optional, aktiv)
- setup-first-install.sh
- Führt Erstinstallation in einem Ablauf aus (Start, Nginx, Hosts-Sync-Service, Autostart-Service)
- setup-hosts-sync.sh
- Installiert den systemd-Service für automatische Hosts-Synchronisierung
- 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
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
Befehle:
- sudo ./nginx.sh apply
- sudo ./nginx.sh disable
- sudo ./nginx.sh deactivate
Nginx-Templates:
- nginx/gitea.http.conf.template
- nginx/gitea.https.conf.template
- nginx/website.http.conf.template
- nginx/website.https.conf.template
Inventarsystem Instanzen
Admin-Oberfläche:
- Route: /admin/instances
- Menu: Schul-Instanzen
Provisioning-Flow:
- Admin wählt Nutzer, Schule, Version und optional Subdomain.
- Backend ruft Website/provision_instance.sh auf.
- Provisioning installiert release-basiert aus GitHub-Releases.
- Wenn verfügbar, wird docker-compose-multitenant.yml bevorzugt genutzt.
- 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
Betriebsmodi Website
- Development: Website/launch_dev.sh
- Production: Website/launch_prod.sh
Beispiel Production:
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
- sudo ./gitea.sh start
- sudo ./nginx.sh apply
- sudo ./gitea.sh status
Erstinstallation (automatisiert)
Für eine neue Maschine kann die Erstinstallation in einem Schritt ausgeführt werden:
sudo ./setup-first-install.sh
Standardmäßig macht das Skript:
- Startet den Stack über gitea.sh.
- Wendet nginx.sh apply an.
- Installiert den Hosts-Sync-systemd-Service.
- Installiert den Stack-Autostart-systemd-Service.
Optionen:
- --skip-start
- --skip-nginx
- --skip-hosts-sync
- --skip-autostart