Zum Hauptinhalt springen Zur Navigation springen Zur Fußzeile springen

RDC CLI Cheat Sheet

Kurzreferenz für rdc: Konfigurationen, Repos, Maschinen, Dateisynchronisierung und Container. Vollständiger Optionssatz: füge --help zu einem beliebigen Befehl hinzu.

RDC CLI Cheat Sheet

Nicht alle rdc-Befehle sind hier aufgelistet, nur die, die bei jeder Bereitstellung verwendet werden. Für den vollständigen Optionssatz führe einen beliebigen rdc-Befehl mit --help aus. Spezialfälle und selten verwendete Optionen findest du in der vollständigen Referenz.

Repository-Lebenszyklus

BefehlBeschreibung
rdc repo create <repo> -m <machine>Neues Repository auf einer Maschine erstellen
rdc repo up <repo>@<machine>Repository bereitstellen oder aktualisieren
rdc repo down <repo>@<machine>Repository stoppen
rdc repo delete <repo>@<machine>Repository löschen
rdc repo fork <repo>@<machine> --tag <tag>Repository forken (nahezu sofort, BTRFS-Reflink)
rdc repo promote <repo>:<tag>Einen validierten Fork unter dem Namen des übergeordneten Repositorys in Produktion überführen
rdc repo listAlle Repositories mit Name und GUID auflisten
rdc repo resize <repo> --size <size>Das Volume eines gestoppten Repositorys in der Größe anpassen
rdc repo expand <repo> --size <size>Das Volume eines laufenden Repositorys im laufenden Betrieb vergrößern

Per-Repository-Geheimnisse

Schreibgeschützte Anmeldedaten zur Bereitstellungszeit. get gibt nur den Digest zurück. Der Wert wird niemals zurückgegeben. Siehe Repositories § Geheimnisse für das vollständige Handbuch.

BefehlBeschreibung
rdc repo secret set <repo> --key <KEY> --value <val> [--mode env|file] --current ""Neues Geheimnis erstellen (--current "" beim ersten Schreiben)
rdc repo secret set <repo> --key <KEY> --value <val> --current <prev>Vorhandenes Geheimnis überschreiben (Passwort-ähnliche Vorbedingung)
rdc repo secret set <repo> --key <KEY> --value <val> --rotate-secretÜberschreiben ohne Überprüfung des vorherigen Wertes (wird als Rotation protokolliert)
rdc repo secret list <repo>Geheimnisnamen und Lieferungsmodi auflisten (nie Werte, nie Digests)
rdc repo secret get <repo> --key <KEY>Geheimnis-Digest und Modus anzeigen (kein Klartext-Wert, niemals)
rdc repo secret unset <repo> --key <KEY> --current <prev>Geheimnis löschen
rdc repo secret unset <repo> --key <KEY> --rotate-secretLöschen ohne Überprüfung des vorherigen Wertes

Forks erben keine Geheimnisse. Lege sie auf dem Fork explizit mit rdc repo secret set <repo>:<tag> fest.

Sicherung und Wiederherstellung

BefehlBeschreibung
rdc repo push ... --bwlimit <limit>rsync-Bandbreite beim Hochladen begrenzen (z. B. 10M)
rdc repo pull ... --bwlimit <limit>rsync-Bandbreite beim Herunterladen begrenzen
rdc repo push ... --checkpointContainer vor dem Hochladen sichern
rdc backup manifests <repo-ref>Im Chunk-Store gespeicherte Snapshots auflisten
rdc backup browse <repo-ref>Dateien eines Repositorys auflisten (lokal, nur lesend)
rdc backup snapshot <repo>Chunk-Store-Snapshot hochladen: zuerst das vollständige Inventar, danach nur geänderte Zellen
rdc backup snapshot <repo> --dry-runSnapshot planen, ohne hochzuladen; zeigt, was sich bewegen würde
rdc backup verify <repo>Backup-Anker eines Repositorys gegen den Chunk-Store verifizieren
rdc backup usageIm Chunk-Store gespeicherte Bytes gegenüber dem Kontingent anzeigen
rdc backup manifests <repo>Auf dem Server erfasste Snapshot-Manifeste auflisten
rdc storage browse <storage>Speicherinhalte durchsuchen

Repository-Migration

BefehlBeschreibung
rdc repo migrate <repo>@<machine> --to <machine>Repository zwischen Maschinen verschieben
rdc repo migrate ... --provisionZielmaschine vor der Übertragung bereitstellen
rdc repo migrate ... --checkpointVor der Migration sichern
rdc repo migrate ... --skip-dnsDNS-Aktualisierung nach der Migration überspringen
rdc repo migrate ... --bwlimit <limit>Übertragungsbandbreite begrenzen

Sicherungsstrategien

BefehlBeschreibung
rdc backup strategy set <name> --destination <storage> --cron <expr> --mode <hot|cold> --enableBenannte Sicherungsstrategie erstellen oder aktualisieren
rdc backup strategy listAlle definierten Sicherungsstrategien auflisten
rdc backup strategy show <name>Details einer Strategie anzeigen
rdc backup strategy remove <name>Strategie entfernen
rdc backup schedule -m <machine>Konfigurierte Sicherungsstrategien auf einer Maschine bereitstellen

Sicherungsoperationen

BefehlBeschreibung
rdc backup schedule -m <machine>Gebundene Strategien als systemd-Timer bereitstellen
rdc backup schedule -m <machine> --dry-runTimer-Units ohne Bereitstellung anzeigen (Token maskiert)
rdc backup run -m <machine>Alle gebundenen Strategien sofort ausführen
rdc backup run <name> -m <machine>Eine bestimmte Strategie sofort ausführen
rdc backup status -m <machine>Timer-Status und aktuelle Jobergebnisse anzeigen
rdc backup status <name> -m <machine>Status einer bestimmten Strategie anzeigen
rdc backup cancel -m <machine>Laufende Sicherungen abbrechen
rdc backup cancel <name> -m <machine>Eine bestimmte laufende Sicherung abbrechen

Maschinenverwaltung

BefehlBeschreibung
rdc machine status <machine>Vollständiger Maschinenstatus (System, Container, Dienste, Repos, Netzwerk)
rdc machine status <machine> --systemNur Systeminformationen
rdc machine status <machine> --containersNur Container-Liste
rdc machine status <machine> --repositoriesNur Repository-Liste
rdc machine status <machine> --servicesNur Dienste-Liste
rdc machine status <machine> --networkNur Netzwerkinformationen
rdc machine status <machine> --block-devicesNur Block-Geräteinformationen
rdc machine listAlle Maschinen in der Konfiguration auflisten
rdc machine setup <machine>Erstmalige Maschinenbereitstellung ausführen
rdc machine health <machine>Zustand einer Maschine prüfen
rdc machine scan-keys <machine>SSH-Host-Schlüssel nach einem Neuaufbau aktualisieren
rdc machine prune <machine>Ungenutzte Ressourcen von der Maschine entfernen
rdc machine deprovision <machine>Maschine vollständig deprovisionieren

Terminal und Synchronisierung

BefehlBeschreibung
rdc term connect <machine>SSH-Terminal zur Maschine öffnen
rdc term connect <repo>@<machine>SSH-Terminal zum Repository öffnen (setzt DOCKER_HOST)
rdc term connect <machine> -c "<command>"Befehl auf der Maschine ausführen
rdc repo sync upload <repo>@<machine> --local <paths...>Eine oder mehrere lokale Dateien/Verzeichnisse ins Repository hochladen
rdc repo sync upload <repo>@<machine> --local <file> --remote-file <path>Einzelne lokale Datei in einen expliziten Remote-Pfad hochladen
rdc repo sync download <repo>@<machine> --local <dir>Repository-Verzeichnis lokal herunterladen
rdc repo sync download <repo>@<machine> --remote-file <path> --local <dir>Einzelne Remote-Datei in ein lokales Verzeichnis herunterladen
rdc vscode connect <repo>@<machine>VS Code Remote SSH-Sitzung öffnen
rdc vscode listSSH-Konfigurationen auflisten, die von vscode connect erstellt wurden
rdc vscode cleanup --allAlle von vscode connect geschriebenen SSH-Konfigurationen entfernen
rdc repo tunnel <repo> -c <container> --port <port>Einen Container-Port über SSH weiterleiten

Konfiguration

BefehlBeschreibung
rdc config init <name>Benannte Konfigurationsdatei erstellen
rdc config listAlle Konfigurationen auf dieser Maschine auflisten
rdc config set machine <alias>Einen Alias auf eine andere Maschine verweisen lassen
rdc machine add <machine> --ip <host> --user <user>Maschine zur Konfiguration hinzufügen
rdc storage import rclone.confSpeicheranbieter aus rclone-Konfiguration importieren
rdc storage listKonfigurierte Speicheranbieter auflisten
rdc backup strategy set ...Benannte Sicherungsstrategie definieren
rdc --config <name> <command>Benannte Konfigurationsdatei verwenden

Diagnose und Direktzugriff

BefehlBeschreibung
rdc repo logs <repo>@<machine> -c <container> --lines 200 --followContainer-Logs streamen (bevorzugt)
rdc repo exec <repo>@<machine> -c <container> -- <command>Einen Befehl in einem Container ausführen (bevorzugt)
rdc repo exec <repo>@<machine> -c <container> -i -- bashEine interaktive Container-Shell öffnen
rdc term connect <repo>@<machine> -c "docker ps"Container in einem Repository auflisten
rdc term connect <repo>@<machine> -c "docker logs <name>"Container-Logs abrufen
rdc term connect <repo>@<machine> -c "docker exec <name> <cmd>"Befehl in Container ausführen
rdc term connect <repo>@<machine> -c "docker restart <name>"Container neu starten