Connect
Quelle: pkr-lab/pkr-lab-docs/cubi/connect.md
Connect
SSH-Verbindung zu den VMs und Hosts aus der Konfiguration.
Code: modules/connect.py
Überblick
cubi connect zeigt die Gruppen aus connect: in targets.yaml (zum Beispiel VM und Hosts) und danach die Ziele der gewählten Gruppe. Die Wahl startet ssh <alias>. cubi übergibt dabei das Terminal an ssh (os.execvp), das heißt: cubi ist danach beendet, und nach dem Ende der SSH-Sitzung ist man wieder in der Shell.
Wer das Tailnet nutzt, kommt über Tailscale zum selben Ergebnis, dort aus der Geräteliste.
Ablauf
run()liestconnectaus der Config. Ohne Eintrag:Keine Connect-Ziele in targets.yaml.- Gruppenauswahl, mit Anzahl der Ziele je Gruppe (
3 Ziele). Esc beendet den Bereich. - Zielauswahl:
targets()prüft jeden Eintrag aufnameundssh. Zu jedem Eintrag ruftdescribe()ssh -G <alias>(5 Sekunden Timeout) und zeigtbenutzer@hostnameals Hinweis. Schlägt das fehl, bleibt der Hinweis leer. - Auswahl →
shell.replace(["ssh", alias]).
Zurück aus der Zielauswahl (Esc) führt zur Gruppenauswahl.
Konfiguration
Siehe Konfiguration, Schlüssel connect.<gruppe>[] mit name und ssh. SSH-Optionen (Benutzer, Port, Schlüssel, ProxyJump) stehen in ~/.ssh/config, nicht in cubi.
Randfälle
- Die Hinweise
benutzer@hostnamekommen aus der lokalen SSH-Konfiguration, nicht vom Server. cubi prüft nicht, ob der Host erreichbar ist. - Für jeden Eintrag der gewählten Gruppe läuft ein
ssh -G, bei vielen Zielen ist die Zielauswahl daher einen Moment verzögert. - Es gibt keine Auswahl mehrerer Ziele und keinen Befehl auf dem Ziel, nur die interaktive Sitzung.
Debugging und Fehlersuche
| Meldung | Ursache | Lösung |
|---|---|---|
Keine Connect-Ziele in targets.yaml |
Abschnitt connect fehlt |
Gruppen in targets.yaml ergänzen, siehe Konfiguration |
Keine Ziele in connect.<gruppe> |
Gruppe ist leer oder keine Liste | Einträge als YAML-Liste (- name: …) angeben |
Ungültiger Eintrag in connect.<gruppe>: name und ssh sind Pflicht |
Eintrag ohne name oder ssh |
beide Felder setzen |
ssh ist nicht installiert oder nicht im PATH |
OpenSSH-Client fehlt | sudo apt install openssh-client |
ssh: Could not resolve hostname … (aus ssh, nach dem Wechsel in die Shell) |
Alias fehlt in ~/.ssh/config oder Name nicht auflösbar |
ssh -G <alias> ausführen, Host-Eintrag ergänzen |
Permission denied (publickey) |
Schlüssel nicht hinterlegt | IdentityFile im Host-Eintrag prüfen, Schlüssel auf dem Ziel hinterlegen, siehe SSH-Härtung |
| Hinweis hinter dem Eintrag fehlt | ssh -G schlug fehl oder dauerte über 5 Sekunden |
harmlos; ssh -G <alias> manuell prüfen |
Checkliste „Connect funktioniert nicht“:
ssh <alias>direkt in der Shell: klappt es dort nicht, liegt es nicht an cubi.ssh -G <alias>: stimmenhostname,user,identityfile?- Bei Tailnet-Hosts:
tailscale status, ist das Gerät online? Siehe Tailscale. - Host im lokalen Netz: Erreichbarkeit mit
ping, DNS siehe DNS-Architektur.
Allgemeines: Debugging und Fehlersuche.