Skript-Cockpit

Zweck: Verwaltet einen einzelnen Hetzner-Podman-Host mit up, down, toggle, status und ssh.

Wirkung: up baut den Server aus dem neuesten Snapshot oder erstmals per Cloud-init auf und setzt die Podman-Verbindung. down erstellt einen Snapshot und löscht danach den kostenpflichtigen Server.

Zweck: An/Aus-Workflow für den einzelnen Kubernetes-Server k3s-host.

Wirkung: Beim Hochfahren werden Kubeconfig und KUBECONFIG auf dem Laptop aktualisiert; beim Herunterfahren wird k3s sauber gestoppt, gesichert und der Server gelöscht.

Zweck: Installiert und verwaltet ein vollständiges OKD/OpenShift als Single-Node-Cluster auf Hetzner.

Wirkung: install durchläuft Rescue, SCOS-kexec und bootstrap-in-place. down sichert den Node als Snapshot; destroy entfernt Server, Snapshot, reservierte IP und Firewall.

Zweck: Betreibt den Jenkins-Server für CI-Deployments auf den OKD-Single-Node.

Wirkung: install baut das Image aus shared/enterprise-infrastructure/jenkins/; up/down verwenden Snapshots und pflegen die OKD-Firewallregel für Port 6443.

Passwort: Ohne -AdminPassword erzeugt das Skript selbst ein Passwort. Bei manueller Eingabe erscheint es im erzeugten und kopierten Befehl im Klartext.

Zweck: Status und Kostenkontrolle für den mehrteiligen OKD-Cluster.

Achtung: down ist ein Kill-Switch und löscht alle okd-*-Server, den Load Balancer und das private Netz in einem Durchlauf.

Zweck: Sichert und restauriert mehrere konfigurierte Hetzner-Server; mit -Only auch gezielt einen einzelnen.

Wirkung: Zeigt Laufzeitkosten und Snapshot-Inventar, stoppt Dienste vor dem Snapshot, kann reservierte IPs wieder anhängen und mit prune -Keep N alte Sicherungen entfernen.

Zweck: Meldet den Laptop per OAuth-Gerätecode am Netcup-SCP an und verwaltet einen bereits gebuchten VPS oder Root-Server.

Wirkung: Bietet Liste, Status, Start, Stop, Umschalten und SSH. Das Token wird mit Windows-DPAPI geschützt. Ausschalten beendet den Vertrag und seine Kosten nicht.

Zweck: Kapselt OAuth-Geräteanmeldung, verschlüsselten Refresh-Token, REST-Aufrufe, Aufgabenstatus, Serverauflösung und SSH-Wartezeiten.

Nutzung: Wird von den vier Netcup-Skripten eingebunden und nicht direkt aufgerufen.

Zweck: Enthält getrennte Profile für normalen Server, k3s und OKD-SNO.

Nutzung: Als netcup.config.psd1 kopieren und dort Server-ID, Name, SSH-Benutzer und lokale Pfade eintragen. Die lokale Kopie wird nicht eingecheckt.

Zweck: Steuert k3s und die zugehörige Netcup-VM kontrolliert.

Wirkung: Startet und stoppt k3s, holt die kubeconfig, setzt KUBECONFIG und erzeugt auf Wunsch einen Offline-Snapshot.

Zweck: Verwaltet Netcup-Snapshots für normale Server, k3s und OKD-SNO.

Wirkung: Erstellt standardmäßig einen Offline-Snapshot und startet einen zuvor laufenden Server danach wieder. Wiederherstellung und Löschen verlangen eine ausdrückliche Freigabe.

Zweck: Bereitet die OKD-Single-Node-Installation für einen bestehenden Netcup-x86-Server vor und betreibt sie danach.

Wirkung: Erzeugt die geheime Ignition-ISO, legt eine hochgeladene ISO per API ein, überwacht die Installation, setzt die kubeconfig und steuert den Node.

Zweck: Linux-Teil der Netcup-SNO-Installation.

Wirkung: Lädt Installer und Client, erzeugt Single-Node-Ignition, bettet sie in eine Fedora-CoreOS-ISO ein und überwacht die Installation.

Zweck: Enthält die Stundensätze der Hetzner-Skripte. Netcup verwendet stattdessen den in der lokalen Konfiguration dokumentierten monatlichen Vertragspreis.

Zweck: Steuert alle Compose-Stacks unter /opt/stacks auf dem konsolidierten Server.

Wirkung: Erkennt Stacks automatisch, startet Traefik und gemeinsame Datenbanken zuerst und fährt sie umgekehrt herunter. Unterstützt Status, Start, Stop, Neustart, Pull und Logs sowie -Only.

Zweck: Erstellt, aktualisiert oder löscht Cloudflare-A-Records, wenn ein neu aufgebauter Server eine andere IPv4 erhält.

Wirkung: Nutzt $env:CF_API_TOKEN, akzeptiert eine IP direkt oder liest sie bei Hetzner per hcloud und bei Netcup per SCP-REST-API aus. -DryRun zeigt die geplante Änderung ohne Schreibzugriff.

Zweck: Überträgt eine statische Website oder einen Compose-Stack auf den geschützten Projekt-Host.

Wirkung: Nutzt bevorzugt rsync, sonst tar über SSH. -Stack startet anschließend Compose; -Delete entfernt mit rsync veraltete Zieldateien und -Logs folgt den Container-Logs.

Zweck: Legt Windows-Verknüpfungen für up, down und status einer oder aller Plattformen an.

Wirkung: -For wählt eine Hetzner- oder Netcup-Plattform, darunter netcup, netcup-k3s und netcup-sno. -ForAll verarbeitet alle.

Zweck: Installiert ein tägliches down als Windows-Aufgabe.

Wirkung: Ruft zur mit -Time gewählten Uhrzeit das passende Skript auf. Bei Hetzner dient das als Kostenschutz. Bei Netcup ist es nur eine Betriebspause, weil der Vertrag weiterläuft.

Zweck: Aktiviert die drei Terminal-Schaltflächen oberhalb dieser Liste.

Wirkung: Registriert cloudhost-terminal: nur für den aktuellen Benutzer und verweist auf den fest eingeschränkten Handler. Mit -Unregister lässt sich die Registrierung wieder entfernen.

Zweck: Startet Windows Terminal, PowerShell oder Bash im Wurzelverzeichnis dieses Repositories.

Sicherheit: Der Handler akzeptiert drei fest codierte Terminalziele, eine Whitelist lesender Skriptaktionen und ein vorhandenes Dateisystem-Verzeichnis; URL-Inhalte werden nie direkt als Befehl ausgeführt. Bash verwendet Git Bash, ersatzweise WSL.

Parameter: -Url ist ein Pflichtparameter an Position 0 und enthält ausschließlich den registrierten cloudhost-terminal:-Link. Nicht manuell aufrufen; der Browser übergibt ihn an den Handler.

Zweck: Erzeugt aus allen anleitungen/*.html den Volltextindex suchindex.js.

Wann ausführen: Nach Inhaltsänderungen an Anleitungen, damit die Suche oben nicht nur Kartentexte, sondern auch den eigentlichen Seiteninhalt findet.

Parameter: keine; Quellordner und Zieldatei werden relativ zum Skript ermittelt.

Zweck: Aktiviert einmalig pro Klon den lokalen pre-commit-Hook.

Wirkung: Setzt core.hooksPath auf .githooks; vor dem Commit werden bei geänderten Anleitungen suchindex.js und bei geänderten Skript-/YAML-Dateien script-inhalte.js neu gebaut und mit aufgenommen.

Parameter: keine; das Repository wird aus dem Speicherort des Skripts bestimmt.

Zweck: Gemeinsame Hetzner-, Firewall-, SSH-, Snapshot- und Kostenfunktionen der An/Aus-Skripte.

Nutzung: Wird von den Hauptskripten per Dot-Sourcing geladen und normalerweise nicht direkt gestartet.

Skriptparameter: keine; einzelne interne Funktionen besitzen eigene Funktionsparameter.

Zweck: Misst die Laufzeit und gibt am Ende eines Skripts Ausfuehrungszeit: X s aus.

Nutzung: Wird von den anderen PowerShell-Dateien eingebunden und nicht eigenständig aufgerufen.

Skriptparameter: keine.

Zweck: Zentrale Preistabelle für die ungefähre Stunden- und Monatskostenanzeige der Verwaltungsskripte.

Hinweis: Die Werte sind lokale Rechengrundlagen und sollten bei Preisänderungen des Anbieters aktualisiert werden.

Zweck: Enthält den von build-suchindex.ps1 erzeugten Volltext aller Anleitungen für die Suche in index.html.

Hinweis: Nicht manuell bearbeiten. Fehlt die Datei, sucht die Seite weiterhin, aber nur innerhalb der sichtbaren Karten.

Zweck: Erzeugt script-inhalte.js mit den Quelltexten aller scripts/*.ps1, *.sh und *.yaml für die aufklappbare Anzeige.

Parameter: keine; Quellordner und Zieldatei werden relativ zum Skript ermittelt.

Zweck: Baut die Browserindizes, stellt nur die veröffentlichten Website-Dateien in einem temporären Verzeichnis bereit und deployt sie nach Cloudflare Pages.

Sicherheit: Ohne -Preview wird der Production-Branch aktualisiert; Tests rufen dieses Skript deshalb niemals selbst auf.

Zweck: Liefert die eingebetteten Quelltexte für die aufklappbaren Leser in diesem Bereich.

Hinweis: Nicht manuell bearbeiten; nach Änderungen an PowerShell-, Bash- oder YAML-Dateien neu erzeugen.

Zweck: Standard-Erstinstallation eines Ubuntu-Servers als Podman-Host.

Wirkung: Wird von cloud.ps1 nur beim allerersten up verwendet, solange noch kein Snapshot existiert.

Zweck: Fertige Erstinstallationen für Docker, einen k3s-Node oder den geschützten Projekt-Host.

Nutzung: Die gewählte Datei wird mit -CloudInit übergeben; eigene Varianten folgen dem Namen cloud-init.<name>.yaml.

Zweck: Technische Teilschritte von sno.ps1 install.

Wirkung: sno-wsl.sh erzeugt in WSL2 Installationsdateien und wartet auf OKD; sno-kexec.sh startet im Hetzner-Rescue das SCOS-Live-System mit eingebetteter Ignition.

Parameter von sno-wsl.sh: Position 1 ist der Befehl tools, latest, stream, ignition, wait, finish, kubeadmin-password oder remediate. tools erwartet danach die OKD-Version, ignition Clustername und Node-IP, finish den Windows-Zielpfad der Kubeconfig; die anderen Befehle haben keine weiteren Positionsparameter.

Eingaben für sno-kexec.sh: Pflicht sind die Umgebungsvariablen KERNEL_URL, INITRD_URL und ROOTFS_URL; IGN ist optional und verwendet standardmäßig /root/sno.ign. Keine Positionsparameter.

Zweck: Richtet bei jenkins.ps1 install den frischen Jenkins-Server ein.

Wirkung: Installiert Podman, konfiguriert Registries, baut das Jenkins-Image, startet den Container und richtet den Neustartdienst ein. Danach liegt der Zustand im Snapshot.

Eingaben: ADMIN_PASSWORD ist als Umgebungsvariable Pflicht; ADMIN_USER ist optional und hat die Vorgabe admin. Keine Positionsparameter.

Zweck: Podman-Erstinstallation mit automatischer Selbstlöschung nach zwölf Stunden.

Achtung: Der Server löscht sich per Hetzner-API selbst. Nur mit einem separaten, eng berechtigten API-Token und Projekt verwenden.

Zweck: Kurze Einstiegsübersicht zu Voraussetzungen, Installation und täglichem Gebrauch.

Enthält: Benötigte Winget-Pakete, Hetzner-Kontext, SSH-Schlüssel und die wichtigsten Aufrufe.