Files
rust-discovery/docs/operations-access.md
kevin_janssenandClaude Opus 5.5 9fa6c05af7
Rust development slice / linux (push) Failing after 15s
Document the Proxmox host, its read-only access and the local Proxmox test VM
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-20 12:17:23 +01:00

3.8 KiB

Betriebszugänge für die Entwicklung

WebUI und MCP sind öffentlich über HTTPS erreichbar. Die folgenden Zugänge dienen der Wartung des dedizierten Entwicklungsservers und der beiden Testgeräte. Der normale Geräteverkehr geht vom registrierten Agenten zum Server. WebUI und MCP · Serveraufbau

SSH-Ziele

Die Werkzeuge werden im Repository als Eigentümer der lokalen Entwicklungsprofile ausgeführt. tools/dev_stage.py findet credentials/ im Checkout oder bei einem verknüpften Worktree im gemeinsamen Hauptcheckout. Die Profile enthalten Zugangsdaten und werden vom Parser als Daten gelesen. Das Verzeichnis hat Modus 0700, private Dateien haben Modus 0600. Die Ausgabe von Profilinhalten, Tokens, Schlüsseln, Zugangscodes und privaten Diagnosen gehört weder in Git noch in den Chat.

Name für das Werkzeug Ziel Lokale Vertrauensgrundlage
server Dedizierter ARM64-Host discovery.ease-technologies.de server.conf, vorhandener SSH-Schlüssel und geprüfter Hostkey
linux Cloud-Linux-Gast dev-znuny-db linux-vm.conf, vorhandener SSH-Schlüssel und geprüfter Hostkey
windows Windows-11-Gast discwindowstest windows-dev-access.json, windows-dev.known_hosts, Alias rmm-windows-dev und SSH-Rückkanal über den Server
proxmox Lokale Proxmox-VE-9.2-VM pve.discovery.lan (192.168.122.50) auf dem Notebook proxmox-vm.conf, eigener Schlüssel proxmox-dev-key, Hostpin proxmox-dev.known_hosts (beim ersten Start im NAT-Netz default der frisch installierten VM erfasst)

Der folgende Befehl liest vom Wurzelverzeichnis des Worktrees aus den Hostnamen der Linux-Test-VM.

python3 - <<'PY'
import subprocess, sys
sys.path.insert(0, "tools")
from dev_stage import ssh_prefix
subprocess.run([*ssh_prefix("linux"), "hostname"], check=True, timeout=20)
PY

ssh_prefix verwendet Batchbetrieb, bestehende Schlüssel und strikte Hostprüfung. Die Hostpins für Server und Linux stehen im vorhandenen SSH-Truststore des Benutzers (~/.ssh/known_hosts). Windows und Proxmox verwenden die oben genannten separaten Hostpindateien. Proxmox-Testhost Für Windows wird der geprüfte Proxyweg mit dem gespeicherten Profil abgeglichen. Vor Änderungen an einem Pin den neuen Fingerabdruck unabhängig mit dem Zieladministrator bestätigen. SSH-Auflösung und Staging

Interne Test-WebUI

Die interne Entwicklungs-API ist auf dem Server an 127.0.0.1:18443 gebunden. Für einen Test mit dem expliziten Entwicklungsprofil auf dem Notebook einen freien lokalen Port zum Server weiterleiten. Dieses Beispiel verwendet lokal ebenfalls 18443 und hält den Tunnel bis zum Beenden des Befehls offen.

python3 - <<'PY'
import subprocess, sys
sys.path.insert(0, "tools")
from dev_stage import ssh_prefix
ssh = ssh_prefix("server")
subprocess.run([*ssh[:-1], "-N", "-o", "ExitOnForwardFailure=yes",
                "-L", "127.0.0.1:18443:127.0.0.1:18443", ssh[-1]], check=True)
PY

Für https://localhost:18443/ die Entwicklungs-CA aus credentials/server-ca.pem gezielt vertrauen. Der private Browser-Testlogin liegt im geschützten Profil credentials/server-browser-login.json. Persönliche Freigaben für die öffentliche Verwaltung verwenden das lokale Benutzerkonto mit TOTP. Browsertests

Windows-Gastkonsole

Bei geschlossenem Entwicklungsrückkanal zuerst auf dem Notebook virsh -c qemu:///system domstate win11-test prüfen. virt-viewer --connect qemu:///system win11-test öffnet die vorhandene Konsole. Im entsperrten Gast lassen sich der Dienst sshd und die geplante Aufgabe RmmDevReverseTunnel prüfen. Der registrierte Rückkanal endet auf dem Server an 127.0.0.1:22240. Der Agent meldet sich unabhängig davon über das Gerätegateway.