Bedienung
Quelle: pkr-lab/pkr-lab-docs/cubi/bedienung.md
Bedienung
Terminal-Verhalten
Cubi bleibt immer in der normalen Terminal-Ansicht:
- kein Alternate Screen, kein Vollbild, kein Löschen des Terminal-Inhalts
- keine externen Programme wie Pager, Editor oder Browser
- alles erscheint inline unter dem aufgerufenen Befehl; der Verlauf bleibt nach dem Beenden vollständig sichtbar
Eine Auswahl zeichnet nur ihren eigenen Bereich neu. Der Text darüber bleibt unverändert. Nach der Entscheidung wird der Bereich durch eine einzelne Zeile ersetzt:
$ cubi argocd
? ArgoCD · Kontext kubernetes › my-app
Ein Abbruch hinterlässt ✖ <Frage> · abgebrochen.
Was früher einen Pager, Editor oder Browser öffnete, geht jetzt inline:
| Vorher | Jetzt |
|---|---|
Lange Ausgaben im Pager (less) |
werden vollständig ins Terminal geschrieben |
Issue-Beschreibung und Kommentare im $EDITOR |
Eingabe im Terminal, eine leere Zeile beendet den Text |
„Im Browser öffnen“ (gh ... --web, gh browse) |
„Link anzeigen“ gibt die URL aus |
gh auth login öffnet den Browser |
Der Browser wird unterdrückt, der Code erscheint im Terminal, die URL ist https://github.com/login/device |
| ArgoCD-Login mit SSO (öffnet den Browser) | entfällt, der Login mit Passwort bleibt |
ssh (Connect, Tailscale) und kubectl exec übernehmen das Terminal, weil genau das ihr Zweck ist. Sie laufen ebenfalls inline im normalen Buffer.
Tasten
| Taste | Wirkung |
|---|---|
| ↑ / ↓ | Eintrag wechseln (am Rand springt der Cursor ans andere Ende) |
| Bild ↑ / Bild ↓ | eine Fensterhöhe springen |
| Pos1 / Ende | zum ersten / letzten Eintrag |
| Enter | bestätigen |
| Esc | abbrechen bzw. eine Ebene zurück |
| Ctrl+C | abbrechen, Cubi beendet sich mit Exit-Code 130 (kein Stacktrace) |
r |
Tabelle neu laden (nur Tabellen) |
Die Hotkeys einer Ansicht (zum Beispiel f Filter) stehen in der Fußzeile der Auswahl. Wird die Fußzeile für das Terminal zu breit, bricht sie auf mehrere Zeilen um.
Bei Abbruch (Esc oder Ctrl+C) stellt Cubi den Cursor und den Terminal-Modus wieder her.
Fenster
Hat eine Liste mehr Einträge, als in ein festes Fenster passen (höchstens 15 Zeilen, bei kleinen Terminals weniger), scrollt der Inhalt innerhalb dieses Fensters. Die Position steht in der Fußzeile (12/57).
Mehrfachauswahl
In einer Mehrfachauswahl kommen drei Tasten dazu:
| Taste | Wirkung |
|---|---|
| Space | aktuellen Eintrag an- oder abwählen |
a |
alle Einträge an- oder abwählen (sind schon alle gewählt, werden alle abgewählt) |
| Enter | bestätigen |
Ausgewählte Einträge tragen [x], die übrigen [ ]. Die Fußzeile zeigt die Anzahl (3 gewählt). Verlangt eine Auswahl mindestens einen Eintrag, bleibt Enter ohne Auswahl wirkungslos und die Meldung „Mindestens 1 Eintrag wählen“ erscheint.
? Apps: Auto-Sync deaktivieren
4 Apps
App Projekt Auto-Sync Gemerkt
[x] app-a default auto (prune, selfHeal) -
❯ [x] app-b default manual auto (prune)
[ ] app-c default auto -
3 gewählt · ↑↓ Bewegen · Space Wählen · a Alle · Enter Bestätigen
nach Enter:
? Apps: Auto-Sync deaktivieren › 2 gewählt: app-a, app-b
Wo es Mehrfachauswahl gibt
| Ort | Aktion |
|---|---|
cubi autosync (auch im ArgoCD-Menü mit s) |
Auto-Sync für mehrere Apps ändern |
cubi feature-testing (auch im ArgoCD-Menü mit t) |
Branch mehrerer Apps auf einen Feature-Branch umstellen |
cubi scale (auch im ArgoCD-Menü mit z) |
mehrere Apps auf 0 oder eine eigene Anzahl Pods stellen (Workloads einzeln wählbar) oder wiederherstellen |
ArgoCD-App-Liste, m |
mehrere Apps in einem Aufruf synchronisieren (vorgewählt: alle OutOfSync-Apps) |
| GitHub, Issue bearbeiten | mehrere Labels hinzufügen oder entfernen, mehrere Personen zuweisen oder entfernen |
Alle übrigen Auswahlen sind Einfachauswahlen, weil die Aktion nur für genau ein Element Sinn ergibt (Verbinden, Namespace/Kontext wechseln, Token rotieren, Pod-Shell und so weiter).
Bestätigungen
Ändernde Aktionen fragen mit (y/N) nach. Die Voreinstellung steht in Großbuchstaben, Enter nimmt sie. y/j bestätigen, n und Esc lehnen ab.
Wenn die Bedienung hakt
| Symptom | Ursache | Lösung |
|---|---|---|
| Terminal zeigt nach einem Abbruch keine Eingabe mehr | Rohmodus nicht zurückgesetzt (zum Beispiel nach kill -9) |
reset oder stty sane |
| Auswahl ist abgeschnitten | Zeilen werden auf die Terminalbreite gekürzt | Terminal verbreitern oder Schrift verkleinern |
cubi benötigt ein interaktives Terminal |
kein TTY | in einem echten Terminal starten |
| Pfeiltasten tun nichts | Terminal sendet unbekannte Sequenzen | andere Terminal-Emulation (TERM=xterm-256color) testen |
| Enter tut nichts in einer Mehrfachauswahl | Mindestens 1 Eintrag wählen |
mit Space wählen |
Mehr in Debugging und Fehlersuche.