Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
+31
-262
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user