Testanleitung: eigenes X-Display je Projekt fuer Parallelbetrieb
Damit mehrere Agenten gleichzeitig Oberflaechen testen koennen, bekommt jedes Projekt eine feste Displaynummer (Vorgabe Richard): :99 PolyTrader, :98 Predictalytics, :97 ClawdDotNet, :96 IBKRTrader, :95 und absteigend fuer kuenftige Projekte. Zwei Prozesse auf demselben Display sehen die Fenster des jeweils anderen - Klicks landen im falschen Programm, Aufnahmen zeigen fremde Anwendungen. Beim Durcharbeiten fielen zwei weitere Kollisionspunkte auf, die zum Parallelbetrieb dazugehoeren und mit aufgenommen wurden: - Screenshot- und Logdateien in /tmp brauchen ein Projektpraefix. /tmp/v_1.png ueberschreiben sich parallel laufende Projekte gegenseitig. - "xvfb-run -a" darf NICHT mehr verwendet werden: Das -a sucht sich selbst ein freies Display und beginnt dabei bei :99 - ausgerechnet PolyTraders Nummer. Stattdessen "xvfb-run -n <nummer>". Die Warnung ist nicht theoretisch: Auf der VM lag ein verwaister X98-Socket, entstanden durch genau so einen "xvfb-run -a"-Aufruf beim smoke-ui-Test, als :99 belegt war. Er blockierte Predictalytics' reservierte Nummer, ohne dass ein Prozess lief. Entfernt, und die Anleitung erklaert jetzt, wie man verwaiste Sockets erkennt (ls /tmp/.X11-unix/ gegen pgrep -a Xvfb lesen) und aufraeumt. Weiter ergaenzt: - pkill nie ohne Displaynummer - "pkill Xvfb" erschlaegt die Sitzungen aller anderen Projekte. - DISPLAY in jedem Skript setzen, sonst landet man auf :0, dem echten Desktop. - Die Skriptvorlage hat jetzt einen Kopf mit PROJEKT/DISP/FENSTER; das ist alles, was sich je Projekt unterscheidet. Praktisch gegengetestet. - Aufraeumabschnitt und Belegungsliste um Displays und Verzeichnisse erweitert. Nebenbei aufgefallen: Das PolyTrader-Publish lag unter ~/pt-test statt ~/polytrader-test und verletzte damit die eigene Verzeichniskonvention. Umbenannt. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
@@ -122,7 +122,7 @@ Die Rechte enden **an der eigenen Datenbank** — `GRANT ALL ON <projekt>_test.*
|
||||
| Zweck | Ort |
|
||||
|---|---|
|
||||
| Quellcode | `~/RiderProjects/<projekt>` |
|
||||
| Publish/Testlauf im Benutzerkontext | `~/<projekt>-test` |
|
||||
| Publish/Testlauf im Benutzerkontext | `~/<projekt>-test` (voller Projektname, keine Kürzel) |
|
||||
| Installation als Dienst | `/opt/<projekt>` |
|
||||
|
||||
### 4.3 systemd-Dienste
|
||||
@@ -141,7 +141,51 @@ mehr zuordnen kann, und der nächste Test misst gegen fremde Last.
|
||||
Vor dem Belegen prüfen: `ss -tlnp`. Belegte Ports stehen in Abschnitt 6. Wer einen Port dauerhaft
|
||||
belegt, trägt ihn dort ein.
|
||||
|
||||
### 4.5 Erhöhte Rechte
|
||||
### 4.5 X-Displays — feste Nummer je Projekt
|
||||
|
||||
Damit **mehrere Agenten gleichzeitig** Oberflächen testen können, bekommt jedes Projekt ein
|
||||
eigenes virtuelles Display. Zwei Prozesse auf demselben Display sehen die Fenster des jeweils
|
||||
anderen — Klicks landen im falschen Programm, Aufnahmen zeigen fremde Anwendungen.
|
||||
|
||||
| Display | Projekt |
|
||||
|---|---|
|
||||
| `:99` | **PolyTrader** |
|
||||
| `:98` | **Predictalytics** |
|
||||
| `:97` | **ClawdDotNet** |
|
||||
| `:96` | **IBKRTrader** |
|
||||
| `:95` und **absteigend** | künftige Projekte (nächstes freies von oben nach unten) |
|
||||
|
||||
Wer ein neues Projekt aufnimmt, trägt seine Nummer in die Belegungsliste (Abschnitt 6) ein.
|
||||
|
||||
**Belegte Displays prüfen:**
|
||||
|
||||
```bash
|
||||
ls /tmp/.X11-unix/ # X0 = der echte Desktop, X99 = PolyTrader usw.
|
||||
pgrep -a Xvfb # zeigt, welcher Xvfb auf welchem Display läuft
|
||||
```
|
||||
|
||||
**Verwaiste Sockets** — beide Befehle gemeinsam lesen: Steht in `/tmp/.X11-unix/` ein `X98`, zu
|
||||
dem `pgrep` keinen Prozess zeigt, ist das ein Überbleibsel eines abgestürzten oder hart beendeten
|
||||
Xvfb. Die Nummer wirkt dann belegt, obwohl sie frei ist. Aufräumen:
|
||||
|
||||
```bash
|
||||
sudo rm -f /tmp/.X11-unix/X98
|
||||
```
|
||||
|
||||
*(Genau so entstanden: ein `xvfb-run -a`, das sich :98 nahm, weil :99 gerade lief — siehe die
|
||||
Warnung in 4.7.)*
|
||||
|
||||
⚠️ **Drei Regeln, damit der Parallelbetrieb wirklich trägt:**
|
||||
|
||||
1. **`DISPLAY` in jedem Skript setzen** (`export DISPLAY=:98`). Fehlt die Variable, landet man auf
|
||||
`:0` — dem echten Desktop — und stört den Menschen, der dort gerade arbeitet.
|
||||
2. **Nie `pkill Xvfb` ohne Displaynummer.** Das erschlägt die Sitzungen aller anderen Projekte.
|
||||
Immer `pkill -f "Xvfb :98"`. Dasselbe gilt für die eigene Anwendung: `pkill -f` mit einem zu
|
||||
allgemeinen Muster trifft fremde Prozesse — besser die gemerkte PID beenden.
|
||||
3. **Dateien in `/tmp` mit Projektpräfix.** `/tmp/v_1.png` überschreibt sich gegenseitig; nimm
|
||||
`/tmp/<projekt>_v_1.png`. Gleiches gilt für Logdateien und Skripte.
|
||||
|
||||
### 4.6 Erhöhte Rechte
|
||||
|
||||
`sudo` verlangt normalerweise ein Passwort. Für Testläufe kann es befristet freigeschaltet werden
|
||||
(**ein Mensch, einmalig**):
|
||||
@@ -159,16 +203,21 @@ sudo rm /etc/sudoers.d/99-testing
|
||||
Das hebt den Schutz für das Konto vollständig auf — vertretbar auf einer Test-VM hinter VPN, aber
|
||||
nicht dauerhaft und niemals auf einer Produktivmaschine.
|
||||
|
||||
### 4.6 GUI-Anwendungen ohne Bildschirm testen
|
||||
### 4.7 GUI-Anwendungen ohne Bildschirm testen
|
||||
|
||||
Braucht eine Anwendung X11, scheitert sie über SSH mit `XOpenDisplay failed`. Für einen einzelnen
|
||||
Durchlauf genügt:
|
||||
|
||||
```bash
|
||||
xvfb-run -a ./MeineAnwendung --irgendein-schalter
|
||||
xvfb-run -n <deine-nummer> ./MeineAnwendung --irgendein-schalter
|
||||
```
|
||||
|
||||
### 4.7 Oberflächen selbst begutachten — ohne Bildschirm, ohne fremde Hilfe
|
||||
⚠️ **Nicht `xvfb-run -a` verwenden.** Das `-a` sucht sich selbst ein freies Display und **beginnt
|
||||
dabei bei :99** — also ausgerechnet auf PolyTraders Nummer. Läuft dort gerade nichts, belegt es
|
||||
diese Nummer; startet PolyTrader kurz darauf, kollidieren beide. Mit `-n 98` (bzw. der eigenen
|
||||
Nummer aus 4.5) bleibt die Zuordnung eindeutig.
|
||||
|
||||
### 4.8 Oberflächen selbst begutachten — ohne Bildschirm, ohne fremde Hilfe
|
||||
|
||||
**Ein Agent kann die Oberfläche eigenständig prüfen.** Kein Mensch muss am Bildschirm sitzen und
|
||||
Bildschirmfotos schicken. Das Verfahren hat sich am 26.08.2026 bewährt und **sieben Befunde
|
||||
@@ -182,33 +231,39 @@ Aufnahmen navigieren lässt:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
cd ~/<projekt>-test
|
||||
export DISPLAY=:99
|
||||
# Kopf anpassen - das ist alles, was sich je Projekt unterscheidet:
|
||||
PROJEKT="polytrader"
|
||||
DISP=":99" # eigene Nummer aus Abschnitt 4.5!
|
||||
FENSTER="^PolyTrader$"
|
||||
|
||||
pkill -f "Xvfb :99" 2>/dev/null; sleep 1
|
||||
Xvfb :99 -screen 0 1600x1000x24 >/dev/null 2>&1 &
|
||||
cd ~/$PROJEKT-test
|
||||
export DISPLAY=$DISP
|
||||
|
||||
pkill -f "Xvfb $DISP" 2>/dev/null; sleep 1
|
||||
Xvfb $DISP -screen 0 1600x1000x24 >/dev/null 2>&1 &
|
||||
sleep 3
|
||||
|
||||
nohup ./MeineAnwendung > /tmp/gui.log 2>&1 &
|
||||
nohup ./MeineAnwendung > /tmp/${PROJEKT}_gui.log 2>&1 &
|
||||
APP=$!
|
||||
sleep 25 # Startzeit großzügig bemessen
|
||||
|
||||
# Fenster-ID ermitteln (bestaetigt, dass die Oberflaeche ueberhaupt erscheint)
|
||||
xdotool search --name "^MeinFenstertitel$" | head -1
|
||||
xdotool search --name "$FENSTER" | head -1
|
||||
|
||||
# navigieren und aufnehmen
|
||||
shoot() { sleep 5; import -window root /tmp/v_$1.png; }
|
||||
# navigieren und aufnehmen - Dateinamen mit Projektpraefix, sonst
|
||||
# ueberschreiben sich parallel laufende Projekte gegenseitig
|
||||
shoot() { sleep 5; import -window root /tmp/${PROJEKT}_$1.png; echo " $1"; }
|
||||
shoot 1_start
|
||||
xdotool mousemove 127 205 click 1; shoot 2_zweite_ansicht
|
||||
xdotool mousemove 127 237 click 1; shoot 3_dritte_ansicht
|
||||
|
||||
kill $APP 2>/dev/null; sleep 2; pkill -f "Xvfb :99" 2>/dev/null
|
||||
kill $APP 2>/dev/null; sleep 2; pkill -f "Xvfb $DISP" 2>/dev/null
|
||||
```
|
||||
|
||||
Danach die Bilder abholen und ansehen:
|
||||
|
||||
```bash
|
||||
scp testvm:'/tmp/v_*.png' .
|
||||
scp testvm:'/tmp/polytrader_*.png' .
|
||||
```
|
||||
|
||||
**Was sich dabei bewährt hat:**
|
||||
@@ -224,9 +279,10 @@ scp testvm:'/tmp/v_*.png' .
|
||||
- **Kontraste nachmessen statt schätzen.** Ob Text lesbar ist, lässt sich ausrechnen — Pixelfarben
|
||||
auslesen und das WCAG-Verhältnis bestimmen (4,5:1 für normalen Text). So wird aus „wirkt blass"
|
||||
ein belegter Befund.
|
||||
- **Nur eine Instanz gleichzeitig.** Läuft der systemd-Dienst noch, schreiben zwei Prozesse in
|
||||
dieselbe Datenbank und es entstehen Fehler, die nichts mit der Oberfläche zu tun haben. Vorher
|
||||
`sudo systemctl stop <projekt>`.
|
||||
- **Nur eine Instanz des eigenen Projekts gleichzeitig.** Läuft der systemd-Dienst noch, schreiben
|
||||
zwei Prozesse in dieselbe Datenbank und es entstehen Fehler, die nichts mit der Oberfläche zu tun
|
||||
haben. Vorher `sudo systemctl stop <projekt>`. (Ein **anderes** Projekt auf seinem eigenen
|
||||
Display stört dagegen nicht — dafür ist die Trennung aus 4.5 da.)
|
||||
- **Auf Zeichen achten, die falsch aussehen.** Fehlt eine Icon-Schriftart, ersetzt Fontconfig sie
|
||||
stillschweigend durch etwas anderes — ein Kalendersymbol wird dann zu einer sinnlosen Zahl. Das
|
||||
fällt nur im Bild auf, nie im Log.
|
||||
@@ -261,6 +317,23 @@ nutzen, Port 3389 ist offen) — nötig ist es für die Sichtprüfung nicht.
|
||||
|---|---|---|---|---|
|
||||
| `polytrader.service` | `polytrader` | `/opt/polytrader` | PolyTrader | 26.08.2026 |
|
||||
|
||||
**Verzeichnisse**
|
||||
|
||||
| Projekt | Publish-Verzeichnis | Dienst |
|
||||
|---|---|---|
|
||||
| PolyTrader | `~/polytrader-test` | `/opt/polytrader` |
|
||||
|
||||
**X-Displays** (Vergabe siehe 4.5)
|
||||
|
||||
| Display | Projekt | Stand |
|
||||
|---|---|---|
|
||||
| `:0` | echter Desktop — **nie belegen** | |
|
||||
| `:99` | PolyTrader | 26.08.2026 |
|
||||
| `:98` | Predictalytics | reserviert |
|
||||
| `:97` | ClawdDotNet | reserviert |
|
||||
| `:96` | IBKRTrader | reserviert |
|
||||
| `:95` abwärts | frei für künftige Projekte | |
|
||||
|
||||
**Ports** (Stand 26.08.2026)
|
||||
|
||||
| Port | Belegt durch |
|
||||
@@ -279,6 +352,10 @@ nutzen, Port 3389 ist offen) — nötig ist es für die Sichtprüfung nicht.
|
||||
## 7. Aufräumen nach dem Test
|
||||
|
||||
```bash
|
||||
# Virtuelles Display beenden (falls noch offen) - NUR das eigene!
|
||||
pkill -f "Xvfb :<deine-nummer>"
|
||||
rm -f /tmp/<projekt>_*.png /tmp/<projekt>_gui.log
|
||||
|
||||
# Dienst abschalten und entfernen
|
||||
sudo systemctl disable --now <projekt>
|
||||
sudo rm -f /etc/systemd/system/<projekt>.service /etc/logrotate.d/<projekt>
|
||||
|
||||
Reference in New Issue
Block a user