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
| Befehl | Beschreibung |
|---|---|
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 list | Alle 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.
| Befehl | Beschreibung |
|---|---|
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-secret | Lö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
| Befehl | Beschreibung |
|---|---|
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 ... --checkpoint | Container 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-run | Snapshot planen, ohne hochzuladen; zeigt, was sich bewegen würde |
rdc backup verify <repo> | Backup-Anker eines Repositorys gegen den Chunk-Store verifizieren |
rdc backup usage | Im Chunk-Store gespeicherte Bytes gegenüber dem Kontingent anzeigen |
rdc backup restore <repo> --as <name> --at <snapshot-id> -m <machine> --up | Einen Chunk-Store-Snapshot unter neuem Namen wiederherstellen |
rdc backup retention <repo> | Die Aufbewahrungsrichtlinie anzeigen, die der Server für eine Repository-Lineage durchsetzt |
rdc backup retention preview <repo> | Anzeigen, was der nächste Durchlauf löschen würde und wie viel Speicher er freigibt |
rdc backup retention set <repo> --keep-daily 7 [--stream <id>] | Aufbewahrung für eine Lineage oder einen Backup-Stream festlegen |
rdc backup retention clear <repo> [--stream <id>] | Die Richtlinie entfernen; jeder Snapshot wird behalten |
rdc backup snapshots delete <repo> <snapshot-id> | Einen Snapshot löschen; seine exklusiven Daten gibt die nächste GC frei |
Repository-Migration
| Befehl | Beschreibung |
|---|---|
rdc repo migrate <repo>@<machine> --to <machine> | Repository zwischen Maschinen verschieben |
rdc repo migrate ... --provision | Zielmaschine vor der Übertragung bereitstellen |
rdc repo migrate ... --checkpoint | Vor der Migration sichern |
rdc repo migrate ... --skip-dns | DNS-Aktualisierung nach der Migration überspringen |
rdc repo migrate ... --bwlimit <limit> | Übertragungsbandbreite begrenzen |
Sicherungsstrategien
| Befehl | Beschreibung |
|---|---|
rdc backup strategy set <name> --destination <name> --cron <expr> --mode <hot|cold> --enable | Benannte Sicherungsstrategie erstellen oder aktualisieren |
rdc backup strategy list | Alle 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
| Befehl | Beschreibung |
|---|---|
rdc backup schedule -m <machine> | Gebundene Strategien als systemd-Timer bereitstellen |
rdc backup schedule -m <machine> --dry-run | Timer-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
| Befehl | Beschreibung |
|---|---|
rdc machine status <machine> | Vollständiger Maschinenstatus (System, Container, Dienste, Repos, Netzwerk) |
rdc machine status <machine> --system | Nur Systeminformationen |
rdc machine status <machine> --containers | Nur Container-Liste |
rdc machine status <machine> --repositories | Nur Repository-Liste |
rdc machine status <machine> --services | Nur Dienste-Liste |
rdc machine status <machine> --network | Nur Netzwerkinformationen |
rdc machine status <machine> --block-devices | Nur Block-Geräteinformationen |
rdc machine list | Alle 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
| Befehl | Beschreibung |
|---|---|
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 list | SSH-Konfigurationen auflisten, die von vscode connect erstellt wurden |
rdc vscode cleanup --all | Alle von vscode connect geschriebenen SSH-Konfigurationen entfernen |
rdc repo tunnel <repo> -c <container> --port <port> | Einen Container-Port über SSH weiterleiten |
Konfiguration
| Befehl | Beschreibung |
|---|---|
rdc config init <name> | Benannte Konfigurationsdatei erstellen |
rdc config list | Alle 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 backup strategy set ... | Benannte Sicherungsstrategie definieren |
rdc --config <name> <command> | Benannte Konfigurationsdatei verwenden |
Diagnose und Direktzugriff
| Befehl | Beschreibung |
|---|---|
rdc repo logs <repo>@<machine> -c <container> --lines 200 --follow | Container-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 -- bash | Eine 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 |