Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s

This commit is contained in:
2026-11-18 17:21:12 +01:00
parent f37b6dc4f7
commit 6963ad332c
188 changed files with 370 additions and 34933 deletions
+31 -262
View File
@@ -1,278 +1,47 @@
# Zugänge für eine andere AI auf diesem Entwicklungs-PC
# Betriebszugänge für die Entwicklung
**Aktuell öffentlich.** WebUI und MCP sind über [den Passwort-/TOTP- und Tokenzugang](public-access.md) erreichbar. Die nachstehende SSH-Anleitung beschreibt zusätzlich den internen Entwicklungsweg.
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](public-access.md) · [Serveraufbau](server-deployment.md)
## SSH-Ziele
Die nachstehenden Zugangsproben stammen vom 17. November 2026, 09:14–09:38 Uhr MEZ. Am Nachmittag waren alle drei SSH-Ziele erreichbar. Den aktuellen Produktzustand mit Zeitstempeln und Zielbelegen nennt der [Lieferplan](mvp-completion-plan.md). Die [Bestandsaufnahme](evidence/product-audit-20261117.json) dokumentiert den Zustand vor der Reparatur. Für die direkte Entwicklungsbereitstellung siehe [Entwicklungsweg](development.md).
Diese Anleitung beschreibt vorhandene Zugänge, keine Erlaubnis für neue Jobs,
Deployments, Konten, Schlüssel, Reboots oder Wiederherstellungen.
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.
## 1. Vom richtigen Arbeitsverzeichnis und Benutzer ausgehen
~~~bash
cd /home/kevin/Schreibtisch/Coding/rust-discovery
git status --short
git log -1 --oneline
~~~
Als lokaler Benutzer **kevin** arbeiten, nicht Python mit sudo starten.
Die Parser verlangen Dateien im Eigentum des aktuellen Unixbenutzers.
Ein neuer Checkout/Worktree enthält die absichtlich ignorierten credentials/
und devstate/ nicht. Die Originale liegen **hier auf diesem PC** im obigen
Arbeitsverzeichnis. Nicht neu enrollen oder den User nach Schlüsseldateien
fragen, nur weil eine andere Arbeitskopie sie nicht enthält.
| Ziel/Zweck | Vorhandenes lokales Profil oder Quelle | Transport |
| Name für das Werkzeug | Ziel | Lokale Vertrauensgrundlage |
| --- | --- | --- |
| Server 88.99.80.202 | credentials/server.conf | root per bestehendem SSH-Key |
| Cloud-Linux 116.203.20.85 | credentials/linux-vm.conf | vorhandener Key/Benutzer aus Profil |
| Windowsgast | credentials/windows-dev-access.json | vollständiger vorhandener ssh_prefix mit ProxyCommand |
| Öffentliche Server-CA | credentials/server-ca.pem | TLS-Kette und SAN prüfen |
| WebUI-Testlogin | credentials/server-browser-login.json | nur geschützter lokaler Browserlogin |
| Windows-Hostpin | credentials/windows-dev.known_hosts | Alias rmm-windows-dev, bereits vorhandener Trust |
| Server-/Linuxpins | normale bestehende SSH-known_hosts | keine automatische Neuannahme |
| `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 |
credentials/ hat 0700, geprüfte Profile/Keydateien 0600; Profile und devstate
sind gitignoriert. Nur gezielt programmgesteuert verwenden. Keine Passwörter,
Tokens, privaten Schlüssel oder gesamten Profile drucken oder in Git kopieren.
Niemals source/eval für diese Dateien verwenden. Standard-SSH darf den
bestehenden Schlüssel zur Authentisierung verwenden; er wird nicht exportiert.
Der folgende Befehl liest vom Wurzelverzeichnis des Worktrees aus den Hostnamen der Linux-Test-VM.
## 2. Server und Cloud-Linux: geprüfter lesender SSH-Einstieg
Das Datenformat der conf-Dateien liest
[vm_access_check.py](../deploy/vm_access_check.py) mit striktem Parser.
Der folgende feste Befehl liest ausschließlich den Kerneltyp:
~~~bash
python3 - <<'PYCODE'
from pathlib import Path
```sh
python3 - <<'PY'
import subprocess, sys
sys.path.insert(0, "deploy")
import vm_access_check as access
sys.path.insert(0, "tools")
from dev_stage import ssh_prefix
subprocess.run([*ssh_prefix("linux"), "hostname"], check=True, timeout=20)
PY
```
profile = "server.conf" # Für die Cloud-Linux-VM: "linux-vm.conf".
cfg = access.load_config(Path("credentials") / profile)
args = [
"ssh", "-F", "/dev/null", "-T",
"-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=yes",
"-o", "IdentitiesOnly=yes", "-o", "ForwardAgent=no",
"-o", "ControlMaster=no", "-o", "ControlPath=none",
"-o", "ConnectTimeout=7", "-p", cfg.get("port", "22"),
"-i", str(Path(cfg["ssh_key_path"]).expanduser()),
cfg["username"] + "@" + cfg["address"], "uname -s",
]
r = subprocess.run(args, capture_output=True, timeout=20)
if r.returncode:
raise SystemExit("SSH-Prüfung fehlgeschlagen; private Fehlerausgabe zurückhalten")
print(r.stdout.decode().strip())
PYCODE
~~~
`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 verwendet die oben genannte separate Hostpindatei. 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](../tools/dev_stage.py)
Heute beide Zielverbindungen erfolgreich, ohne SSH-Multiplexing.
Der bestehende Linux-Preflight kann alternativ mit
python3 deploy/vm_access_check.py aufgerufen werden; er ist lesend, prüft mehr
OS-Metadaten und kann bei fehlendem Trust nur **unbestätigte** Scan-Fingerprints
zeigen. Diese nicht automatisch übernehmen. Das neue Linux-RMM-Verbindungsziel
ist direkt discovery.ease-technologies.de, **kein** alter PC→VM-RMM-Reversetunnel.
## Interne Test-WebUI
Serverarbeitsverzeichnis: /opt/rust-discovery. API/Gateway/Postgres heißen
rust-discovery-server-api-1, rust-discovery-server-gateway-1,
rust-discovery-server-postgres-1. Reine Lesebefehle über die oben gebildete
SSH-Verbindung sind beispielsweise docker ps oder ein enges docker inspect.
Niemals komplette Config.Env, .env, private PKI oder Tokenfiles ausgeben.
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.
**Bei einer später ausdrücklich beauftragten Bereitstellung:** Die tatsächlich
laufende Compose-Dateikette erst aus dem Label
com.docker.compose.project.config_files der API/Gatewaycontainer lesen.
Beim morgendlichen Abruf enthielt sie neun Basis-/Broker-/Release-/Policydateien. Nur die Basisdatei
mit compose up/recreate zu verwenden würde den falschen Stand erzeugen.
Die genaue heutige Reihenfolge steht im
[öffentlichen Zugangsbeleg](evidence/ai-handover-access-20261117.json).
Heute wurde kein Compose-/Dienstaufruf mit Wirkung ausgeführt.
## 3. WebUI und MCP: privater SSH-Forward, gültiges TLS
API/MCP auf Server 127.0.0.1:18443, Gateway auf127.0.0.1:18444; PostgreSQL
ohne Portveröffentlichung. Öffentlicher Agenteningress und SSH sind getrennt.
Keine öffentliche Dev-Anmeldung einrichten.
Für einen eigenen lokalen Verwaltungsforward ist dieser Befehl vorbereitet.
Er läuft im Vordergrund bis Strg+C. Vorher prüfen, ob18443 schon belegt ist;
keinen fremden Listener beenden oder verwenden.
~~~bash
python3 - <<'PYCODE'
from pathlib import Path
```sh
python3 - <<'PY'
import subprocess, sys
sys.path.insert(0, "deploy")
import vm_access_check as access
c = access.load_config(Path("credentials/server.conf"))
args = [
"ssh", "-F", "/dev/null", "-N", "-T",
"-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=yes",
"-o", "IdentitiesOnly=yes", "-o", "ForwardAgent=no",
"-o", "ExitOnForwardFailure=yes", "-o", "ConnectTimeout=7",
"-o", "ServerAliveInterval=15", "-o", "ServerAliveCountMax=2",
"-p", c.get("port", "22"),
"-i", str(Path(c["ssh_key_path"]).expanduser()),
"-L", "127.0.0.1:18443:127.0.0.1:18443",
c["username"] + "@" + c["address"],
]
subprocess.run(args, check=True)
PYCODE
~~~
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
```
Danach WebUI https://localhost:18443/ und MCP https://localhost:18443/mcp.
Die CA gezielt aus credentials/server-ca.pem verwenden; kein curl -k,
ignoreHTTPSErrors oder falscher TLS-Name. Heute über einen eigenen temporären
Loopbackforward tatsächlich geprüft: gültige Kette/localhost-SAN, healthz200,
MCP ohne Authentisierung401. Kein neuer Browserlogin. Ein zusätzlicher authentisierter MCP-Leseaufruf ist
unten separat nachgewiesen.
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](../deploy/browser/README.md)
Vorhandene Anwendungshelfer, erst lesen und nur passend verwenden:
## Windows-Gastkonsole
- deploy/cloud_mvp_acceptance.py: Backend() spricht echtes MCP über den Server;
gespeicherte Daten etwa mit inventory.get_device/jobs.get lesen.
Der normale CLI-Abnahmelauf ist **nicht** bloß ein Zugangstest.
- deploy/browser/windows_mvp_approve.cjs: führt echte UI-Genehmigung durch;
**niemals** als Erreichbarkeitsprobe oder mit einem alten Checkpoint ausführen.
- prepare_browser() aus cloud_mvp_acceptance.py richtet gezielten Browsertrust
im vorhandenen isolierten NSS-Verzeichnis ein. Der Browser liest die geschützte
Login-JSON selbst; keine Kennwörter kopieren.
- Entwicklungslogin und sichtbar simulierte Freigaben sind für diesen MVP
beauftragt; kein OIDC nötig. Das ersetzt keine neue Risikoentscheidung.
Beim morgendlichen Abruf bestanden: authentisierter MCP-Aufruf jobs.get,
nur gespeicherter Job7d756c34… gelesen, Ergebnis unknown/Revision2. Die
vorhandenen Zugangsdaten bleiben auf dem Server; kein Submit, Plan oder Approval.
Der reproduzierbare lesende Einstieg ist:
~~~bash
python3 - <<'PYCODE'
import sys, json
sys.path.insert(0, "deploy")
import cloud_mvp_acceptance as c
record = c.Backend().call("jobs.get", {
"tenant_id": "11111111-1111-4111-8111-111111111111",
"job_id": "7d756c34-3506-4545-8ecd-0e94b9fe7569",
})
print(json.dumps({"state": record["state"], "revision": record["revision"]}))
PYCODE
~~~
Alte private Browserwrapper mit festgehaltener PID 1689414 oder historischem
Portbesitzer nicht übernehmen. Einen eigenen Forwardprozess identifizieren
und nach Benutzung ausschließlich diesen schließen.
## 4. Windows: vorhandenen Prefix benutzen, nicht neu bootstrappen
Der vorhandene Weg ist:
~~~text
Entwicklungs-PC
└─ SSH-Key/Hostpins → root@88.99.80.202
└─ Server 127.0.0.1:22240
└─ bestehender Windows→Server-Reversetunnel
└─ Windows127.0.0.1:22222 (sshd)
└─ rmm-dev
~~~
Der ProxyCommand und die richtigen Key-/Hostpinpfade sind bereits vollständig
im ssh_prefix der geschützten JSON gespeichert. Nicht von Hand aus alten
Chatbefehlen rekonstruieren. Schlüssel-/Hostpinexistenz und die Optionen
BatchMode/IdentitiesOnly/StrictHostKeyChecking wurden heute lokal geprüft.
Bevorzugter lesender Einstieg mit dem vorhandenen Helper:
~~~bash
python3 - <<'PYCODE'
import sys, json
sys.path.insert(0, "deploy/windows")
import client_bootstrap as cb
result = cb.powershell(r"""
[pscustomobject]@{
utc = [DateTime]::UtcNow.ToString('o')
sshd = [string](Get-Service sshd).Status
tunnel = [string](Get-ScheduledTask RmmDevReverseTunnel).State
agent = [string](Get-Service RmmDiscoveryWindows).Status
helper = [string](Get-Service RmmDiscoverySystemHelper).Status
} | ConvertTo-Json -Compress
""", timeout=30)
print(json.dumps(result))
PYCODE
~~~
Beim morgendlichen Versuch scheiterte der Gaststatusbefehl:
Dem Windows-SSH-Zugang fehlte damals der Serverlistener 22240. Eine frische
Verbindung mit deaktiviertem äußerem Multiplexing bestätigte Connection refused.
Am Nachmittag bestätigte der Zugriff über den vorhandenen Prefix die laufenden Agent- und Helperprozesse. [Betriebsnachlese](evidence/product-audit-20261117.json)
Der User hat am 16. November permanenten Entwicklungs-SSH ausdrücklich erlaubt.
Konto rmm-dev ohne Ablaufdatum und SYSTEM-Task RmmDevReverseTunnel sind
historisch eingerichtet und nachgewiesen. **expires_at in der lokalen JSON
ist noch der historische abgelaufene Bootstrapwert.** Die Funktion
client_bootstrap.powershell() nutzt den vorhandenen Prefix und prüft dieses
alte Fristfeld nicht. JSON nicht nur für alte Runner umschreiben und keinen
neuen User-Wartungsfensterbefehl erzeugen.
[Historischer Nachweis](windows-development-access.md).
Weitere Stolperstellen: cb.powershell() erwartet eine einzelne JSON-Ausgabe.
Keine Schlüssel/Tokens oder breite Diagnoseausgaben zurückgeben.
[Console]::In.ReadLine()-Payloads haben über diesen Transport bereits gehangen;
alte Upload-/Renewal-CLI nicht als Allzweckzugang ausführen. Für einen später
beauftragten Import nur die vorhandenen geprüften Hash-/Stagingpfade verwenden.
remote_signed=True setzt RemoteSigned nur für den einzelnen Bootstrapprozess;
keine globale ExecutionPolicy ändern.
## 5. Wenn der Windows-Tunnel fehlt: lokale Gastkonsole ist der zweite Weg
Tatsächlich heute lesend geprüft:
- libvirt-Verbindung qemu:///system, Domain win11-test: Running.
- DHCP-Lease laut libvirt192.168.122.170/24; **keine** Aussage über einen dortigen
SSH-Listener. Windows-sshd ist absichtlich nur an Gast-Loopback gebunden.
- virsh, virt-viewer und virt-manager sind auf diesem PC vorhanden.
- Konsole konnte ohne Tasteneingabe aufgenommen werden. Bild schwarz,
ein entsperrter Administrator-PowerShellprompt wurde heute nicht bestätigt.
~~~bash
virsh -c qemu:///system domstate win11-test
virsh -c qemu:///system domifaddr win11-test --source lease
~~~
Zum späteren Öffnen der bestehenden Konsole ist vorbereitet, hier nicht gestartet:
~~~bash
virt-viewer --connect qemu:///system win11-test
~~~
Der schon benutzte lokale Tastatur-/Screenshothelfer liegt unter
devstate/windows-client/mvp-closeout-20261116/console.py.
Er verwendet virsh send-key für **diesen Gast**, deutsche Tastenbelegung und
nur eingeschränkte Zeichen. Ein Aufruf mit Argument tippt tatsächlich in die
gerade aktive Gastoberfläche; enter sendet Enter. Nicht blind aufrufen,
importieren oder unbekannte laufende Befehle unterbrechen.
Ohne Argument überschreibt er seine privaten live-Bilder.
Heutige neue, getrennte Bilder:
devstate/ai-handover-20261117/windows-console.png und .ppm.
Bei beauftragter Zugangswartung zuerst die Konsole/Anmeldung klären und
ausschließlich den bestehenden Task und sshd **lesen**. Erst danach gegebenenfalls
den bereits beauftragten Entwicklungstransport erhaltend wieder starten.
Kein RMM-Dienstwechsel, kein Reboot/Update, keine neuen Schlüssel/Accounts/Ports
und kein alter Bootstrap-Reparaturlauf sind dafür automatisch nötig/autorisiert.
Heute wurde nichts davon ausgeführt. Ein vorhandener Konsolenlogin wurde
nicht vorausgesetzt; erforderliche Benutzerinteraktion offen melden.
## 6. Historische Werkzeuge sind keine Wiederaufnahmeanweisung
console_access_recovery.py/precision/hash/original_bootstrap, Open-*Window,
Recover-*, Set-PersistentDevelopmentAccess, die221-/205-SDKs,
Install-*Successor und windows_system_scope_renew.py besitzen feste alte Fälle,
Fristen, Inodes oder create-once-Intents. **Nicht erneut ausführen oder deren
Guards passend machen.** Ebenso keine credentials-/devstate-Snapshots über
die aktuellen Originale kopieren.
Heute wurden ausschließlich Profile/Dateiexistenz, SSH, gespeicherter Serverzustand,
VMstatus und TLS geprüft. Kein Zugang ist als Jobgenehmigung zu verstehen.
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.