Rediacc CLI-Referenz
Überblick
Die **Rediacc CLI** (`rdc`) ist eine Befehlszeilenschnittstelle zur Verwaltung aller Aspekte der Rediacc-Plattform — Authentifizierung, Infrastruktur, Repositories, Warteschlangen, Speicher und mehr.
Installationsanleitung
Laden Sie die neueste Version für Ihre Plattform von der [Rediacc-Releases-Seite](https://www.rediacc.com) herunter oder installieren Sie über Ihren Paketmanager:
# macOS / Linux
curl -fsSL https://www.rediacc.com | sh
# Or use the packaged binary directly
./rdc --helpGlobale Optionen
Jeder Befehl unterstützt diese globalen Flags:
| Option | Beschreibung |
|---|---|
--output | Ausgabeformat (table|json|yaml|csv). Standard mit REDIACC_DEFAULT_OUTPUT überschreiben. |
--config | Bestimmte Konfiguration für diesen Befehl verwenden |
--lang | Sprache überschreiben ({{languages}}) |
--force | Bestätigungsaufforderungen überspringen |
1. Agent-Hilfsprogramme
Agent-freundliche Hilfsprogramme für KI-Programmierassistenten
1.1 capabilities
Alle verfügbaren Befehle mit Argumenten und Optionen auflisten
rdc agent capabilities1.2 schema
Detailliertes Schema für einen bestimmten Befehl anzeigen
rdc agent schema [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--command <path> | Ausführen eines Befehls statt interaktiver Shell | Ja | - |
1.3 exec
Befehl mit JSON-Eingabe von stdin ausführen
rdc agent exec [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--command <path> | Ausführen eines Befehls statt interaktiver Shell | Ja | - |
1.4 generate-reference
Befehlsreferenz-Markdown für Claude Skills generieren
rdc agent generate-reference2. Konfigurationsverwaltung
Konfigurationsdateien, Maschinen und SSH-Verbindungen verwalten
Konfigurationsdateien speichern Verbindungsdetails (API-URL, Anmeldedaten, Standard-Team/Region/Bridge), damit Sie schnell zwischen Umgebungen wechseln können.
2.1 prune
Entfernt überflüssigen Ballast aus der lokalen Konfigurationsdatei unter ~/.config/rediacc/<config>.json. Drei Bereiche werden bereinigt, alle rein lokal (keine SSH/renet-Aufrufe): (1) ACME-Zertifikat-Cache-Einträge, deren Anker GUID/Repo/Maschine nicht mehr in der aktiven Konfiguration steht; (2) archivierte Repositories, deren Schonfrist abgelaufen ist (Standard 7 Tage, siehe defaults.pruneGraceDays); (3) verwaiste Querverweise (machine→strategy, strategy→repo). Aktive Ressourcen, Anmeldedaten, Speicher-Tokens und Known-Hosts werden niemals angerührt. Standardverhalten ist Änderungen anwenden; mit --dry-run nur eine Vorschau anzeigen.
rdc config prune [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--dry-run | Vorschau dessen, was entfernt würde, ohne die Konfigurationsdatei zu ändern. Spiegelt die Standard-Aus-Semantik der anderen prune-Befehle. | Nein | - |
--certs-only | Auf den ACME-Zertifikat-Cache-Bereich beschränken. Überspringt Archivbereinigung und Querverweis-Bereinigung. Schließt sich gegenseitig mit --archives-only und --refs-only aus. | Nein | - |
--archives-only | Auf das Bereinigen abgelaufener Archive beschränken. Überspringt Zertifikat-Cache und Querverweis-Bereinigung. Schließt sich mit --certs-only und --refs-only aus. | Nein | - |
--refs-only | Auf verwaiste Querverweise (machine→strategy, strategy→repo excludes/includes) beschränken. Überspringt Zertifikat-Cache und Archive. Schließt sich mit --certs-only und --archives-only aus. | Nein | - |
--purge-archived | ALLE archivierten Repositories unabhängig vom Alter verwerfen, nicht nur die nach Schonfrist. Äquivalent zum Ausführen von 'rdc config repository purge-archived'. Nur verwenden, wenn Sie sicher sind, dass keine der gespeicherten Anmeldedaten zur Wiederherstellung benötigt werden. | Nein | - |
--grace-days <days> | Überschreibt das Archiv-Schonfristfenster (in Tagen) für diesen Aufruf. Greift auf defaults.pruneGraceDays in der Konfiguration zurück, dann auf 7, wenn keines gesetzt ist. | Nein | - |
2.2 init
Eine neue benannte Konfigurationsdatei erstellen
Im lokalen Modus können Sie Machines direkt hinzufügen:
rdc config init [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
--ssh-key <path> | Pfad zum SSH-Private-Key (z. B. ~/.ssh/id_rsa) | Nein | - |
--renet-path <path> | Pfad zur renet-Binärdatei (Standard: renet in PATH) | Nein | - |
--master-password <password> | Ressourcen mit einem Master-Passwort verschlüsseln | Nein | - |
-u, --api-url <url> | API-URL | Nein | - |
--server <url> | Account-Server-URL | Nein | - |
2.3 list
Alle Konfigurationsdateien auflisten
rdc config list2.4 show
Aktuelle Konfigurationsdetails anzeigen
rdc config show [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--reveal | Klartext für sensible Werte anzeigen (nur interaktiv) | Nein | - |
2.5 delete
Eine Konfigurationsdatei löschen
rdc config delete [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
2.6 set
Einen Standardwert setzen (Team, Region, Bridge)
rdc config set [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--key <key> | Konfigurationsschlüssel | Ja | - |
--value <value> | Konfigurationswert | Ja | - |
Tipp: Standardwerte zu setzen bedeutet, dass Sie nicht bei jedem Befehl `--team`, `--region` oder `--bridge` angeben müssen.
2.7 clear
Standardwerte löschen (alle oder einen bestimmten Schlüssel)
rdc config clear [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--key <key> | Konfigurationsschlüssel | Nein | - |
2.8 recover
Konfiguration aus Sicherungsdatei (.bak) wiederherstellen
rdc config recover [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
-y, --yes | Bestätigungsaufforderung überspringen | Nein | - |
2.9 set-ssh
SSH-Konfiguration für die aktuelle Konfiguration aktualisieren
rdc config set-ssh2.10 set-renet
Pfad zur renet-Binärdatei für den lokalen Modus setzen
rdc config set-renet2.11 ssh
SSH-Schlüsselkonfiguration verwalten
set
SSH-Schlüssel für die aktuelle Konfiguration festlegen
rdc config ssh set [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--key <path> | Pfad zur privaten SSH-Schlüsseldatei | Ja | - |
--embed | Schlüsselinhalt in der Konfiguration einbetten statt Pfad zu speichern | Nein | - |
show
Aktuelle SSH-Schlüsselkonfiguration anzeigen
rdc config ssh showremove
SSH-Schlüssel aus der aktuellen Konfiguration entfernen
rdc config ssh remove2.12 remote
Remote-Konfigurationsspeicher-Verbindung verwalten
enable
Diese Konfiguration mit verschlüsseltem Remote-Speicher verknüpfen
rdc config remote enable [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--headless | Gerätecode-Authentifizierung verwenden (für Server ohne GUI) | Nein | - |
--api-url <url> | Account-Server-URL | Nein | - |
disable
Verbindung zum Remote-Speicher trennen und Konfiguration lokal speichern
rdc config remote disablestatus
Remote-Verbindungsstatus anzeigen
rdc config remote statusrefresh
Konfiguration erneut vom Remote-Speicher abrufen
rdc config remote refresh2.13 machine
Maschinen in der aktuellen Konfiguration verwalten
add
Maschine zur aktuellen Konfiguration hinzufügen
rdc config machine add [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--ip <address> | Machine-IP-Adresse oder Hostname | Ja | - |
--user <username> | SSH-Benutzername | Ja | - |
--port <port> | SSH-Port | Nein | 22 |
--datastore <path> | Datastore-Pfad auf Machine | Nein | /mnt/rediacc |
remove
Maschine aus der aktuellen Konfiguration entfernen
rdc config machine remove [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
list
Maschinen in der aktuellen Konfiguration auflisten
rdc config machine listscan-keys
SSH-Hostschlüssel für Maschinen in der aktuellen Konfiguration scannen
rdc config machine scan-keys [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Nein | - |
setup
Remote-Maschine für Repositories einrichten (installiert renet, konfiguriert Docker, BTRFS-Datenspeicher). Idempotent. Erforderlich nach config machine add und vor repo create
rdc config machine setup [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--datastore <path> | Datenspeicherpfad auf Remote-Maschine | Nein | /mnt/rediacc |
--datastore-size <size> | Datenspeichergröße (z.B. 95%, 100G) | Nein | 95% |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
set-ceph
Ceph RBD-Konfiguration für eine Maschine festlegen
rdc config machine set-ceph [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--pool <name> | Ceph-Poolname (z.B. rbd) | Ja | - |
--image <name> | RBD-Imagename (z.B. datastore-prod1) | Ja | - |
--cluster <name> | Ceph-Cluster-Name | Nein | ceph |
2.14 repository
Repository-Zuordnungen in der aktuellen Konfiguration verwalten
add
Repository-GUID-Zuordnung zur aktuellen Konfiguration hinzufügen
rdc config repository add [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--guid <guid> | Repository-GUID (UUID aus Backup-Dateinamen) | Ja | - |
--tag <tag> | Repository-Tag | Nein | latest |
--credential <credential> | Repository-Anmeldedaten (Verschlüsselungspassphrase) | Nein | - |
--network-id <id> | Netzwerk-ID für Docker-Isolierung (2816, 2880, ...). Wird automatisch zugewiesen, wenn nicht angegeben | Nein | - |
remove
Repository-Zuordnung aus der aktuellen Konfiguration entfernen
rdc config repository remove [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
list
Repository-GUID-Zuordnungen in der aktuellen Konfiguration auflisten
rdc config repository listlist-archived
Archivierte Repository-Anmeldedaten auflisten
rdc config repository list-archivedrestore-archived
Archivierte Repository-Anmeldedaten wiederherstellen
rdc config repository restore-archived [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--new-name <name> | Neuer Ressourcenname | Nein | - |
purge-archived
Alle archivierten Anmeldedaten dauerhaft löschen
rdc config repository purge-archived2.15 provider
Cloud-Provider für automatische Maschinenbereitstellung verwalten
add
Cloud-Provider hinzufügen
rdc config provider add [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--provider <source> | Bekannte Anbieterquelle (z.B. linode/linode, hetznercloud/hcloud) | Nein | - |
--source <source> | Benutzerdefinierte OpenTofu-Anbieterquelle (z.B. vultr/vultr) | Nein | - |
--token <token> | API-Token für den Cloud-Provider | Ja | - |
--region <region> | Standardregion für neue Maschinen | Nein | - |
--type <type> | Standard-Instanztyp/-größe | Nein | - |
--image <image> | Standard-Betriebssystem-Image | Nein | - |
--ssh-user <user> | SSH-Benutzername für neue VMs (Standard: root) | Nein | - |
--resource <type> | Benutzerdefiniert: OpenTofu-Ressourcentyp für VMs | Nein | - |
--label-attr <attr> | Benutzerdefiniert: Attributname für VM-Bezeichnung | Nein | - |
--region-attr <attr> | Benutzerdefiniert: Attributname für Region | Nein | - |
--size-attr <attr> | Benutzerdefiniert: Attributname für Instanztyp | Nein | - |
--image-attr <attr> | Benutzerdefiniert: Attributname für Betriebssystem-Image | Nein | - |
--ipv4-output <attr> | Benutzerdefiniert: Ausgabeattribut für IPv4-Adresse | Nein | - |
--ipv6-output <attr> | Benutzerdefiniert: Ausgabeattribut für IPv6-Adresse | Nein | - |
--ssh-key-attr <attr> | Benutzerdefiniert: Attributname für SSH-Schlüssel | Nein | - |
--ssh-key-format <format> | Benutzerdefiniert: SSH-Schlüsselformat (inline_list oder resource_id) | Nein | - |
--ssh-key-resource <type> | Benutzerdefiniert: OpenTofu-Ressourcentyp für SSH-Schlüssel | Nein | - |
remove
Cloud-Provider-Konfiguration entfernen
rdc config provider remove [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
list
Konfigurierte Cloud-Provider auflisten
rdc config provider list2.16 storage
Speicher-Backends in der aktuellen Konfiguration verwalten
import
Speicher aus einer rclone-Konfigurationsdatei importieren
rdc config storage import [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--file <path> | Pfad zur Datei | Ja | - |
--name <name> | Nur diesen benannten Abschnitt importieren | Nein | - |
remove
Speicher aus der aktuellen Konfiguration entfernen
rdc config storage remove [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
list
Speicher in der aktuellen Konfiguration auflisten
rdc config storage list2.17 infra
Infrastrukturkonfiguration verwalten (Proxy, DNS, Zertifikate)
set
Infrastrukturkonfiguration für eine Maschine festlegen (maschinenspezifisch: IPs, Domain, Ports; gemeinsam: Zertifikats-E-Mail, Cloudflare DNS-Token)
rdc config infra set [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--public-ipv4 <ip> | Öffentliche IPv4-Adresse (pro Maschine) | Nein | - |
--public-ipv6 <ip> | Öffentliche IPv6-Adresse (pro Maschine) | Nein | - |
--base-domain <domain> | Basisdomain für Anwendungen (pro Maschine) | Nein | - |
--cert-email <email> | E-Mail für TLS-Zertifikatsbenachrichtigungen (maschinenübergreifend) | Nein | - |
--cf-dns-token <token> | Cloudflare DNS API-Token für ACME DNS-01-Challenge (maschinenübergreifend) | Nein | - |
--tcp-ports <ports> | Weiterzuleitende TCP-Ports (kommagetrennt, z.B. 25,143,465) | Nein | - |
--udp-ports <ports> | Weiterzuleitende UDP-Ports (kommagetrennt, z.B. 53) | Nein | - |
show
Infrastrukturkonfiguration für eine Maschine anzeigen
rdc config infra show [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
push
Infrastrukturkonfiguration auf Maschine übertragen (Traefik-Proxy, Router, Cloudflare DNS). Führen Sie zuerst 'config infra set <machine>' aus
rdc config infra push [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
2.18 cert-cache
Zwischengespeicherte TLS-Zertifikate verwalten
pull
TLS-Zertifikate von einer Maschine herunterladen und zwischenspeichern
rdc config cert-cache pull [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--no-prune | Bereinigung veralteter Netzwerk-ID-Zertifikate überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
push
Zwischengespeicherte TLS-Zertifikate auf eine Maschine hochladen
rdc config cert-cache push [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
status
Zwischengespeicherten Zertifikatsbestand anzeigen
rdc config cert-cache statusclear
Zertifikats-Cache entfernen
rdc config cert-cache clear2.19 field
Feldoperationen der Konfiguration mit Pointer-Adressierung (get/set/unset/rotate/list). JSON-Pointer (RFC 6901), z. B. /credentials/cfDnsApiToken.
get
Einzelnen Konfigurationswert per JSON-Pointer lesen. Sensible Felder werden zensiert, außer mit --reveal (nur interaktiv).
rdc config field get [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--pointer <pointer> | JSON-Pointer zum Feld (z. B. /credentials/cfDnsApiToken) | Ja | - |
--reveal | Klartext für sensible Werte anzeigen (nur interaktives TTY; Audit-Log) | Nein | - |
--digest | SHA-256-Prüfsumme statt des Werts ausgeben (ist für KI-Agenten freigegeben) | Nein | - |
set
Konfigurationswert an einem JSON-Pointer schreiben. Sensible Pfade erfordern --current (Wissensnachweis).
rdc config field set [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--pointer <pointer> | JSON-Pointer zum Feld (z. B. /credentials/cfDnsApiToken) | Ja | - |
--new <value> | Neuer Wert (als JSON interpretiert, falls er mit {, [, ", true, false, null oder einer Zahl beginnt) | Ja | - |
--current <value> | Aktueller Klartextwert — für Änderungen sensibler Pfade erforderlich (Wissensnachweis) | Nein | - |
unset
Konfigurationswert an einem JSON-Pointer löschen. Sensible Pfade erfordern --current.
rdc config field unset [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--pointer <pointer> | JSON-Pointer zum Feld (z. B. /credentials/cfDnsApiToken) | Ja | - |
--current <value> | Aktueller Klartextwert — für Löschungen sensibler Pfade erforderlich | Nein | - |
rotate
Einen sensiblen Wert ohne --current rotieren. Nur interaktives TTY; laut geloggt.
rdc config field rotate [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--pointer <pointer> | JSON-Pointer zum sensiblen Feld (z. B. /credentials/cfDnsApiToken) | Ja | - |
--new <value> | Neuer Wert | Ja | - |
list
Alle registrierten Pointer-Vorlagen mit Art und Commit/Verschlüsselungs-Policy auflisten.
rdc config field list [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--sensitive | Nur sensible (nicht-öffentliche) Vorlagen anzeigen | Nein | - |
2.20 edit
Aktive Konfiguration in $EDITOR als zensiertes JSONC öffnen. Nur für Menschen; Agenten werden abgelehnt.
rdc config edit [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--reveal | Klartext für sensible Werte anzeigen (nur interaktives TTY; Audit-Log) | Nein | - |
--dump | Aktuelle Konfiguration als JSONC an stdout ausgeben, statt den Editor zu öffnen (schreibgeschützt; für Agenten sicher, wenn zensiert) | Nein | - |
--apply <file> | Eine bearbeitete JSONC-Datei anwenden (überspringt das Öffnen von $EDITOR) | Nein | - |
--current-secrets <file> | JSON-Datei mit Pointer→alter-Klartext-Zuordnung für den Wissensnachweis bei --apply | Nein | - |
--editor <cmd> | Editor-Befehl (folgt git-Reihenfolge: --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR) | Nein | - |
2.21 audit
Konfigurations-Audit-Log inspizieren (hash-verkettete JSONL in ~/.config/rediacc/audit.log.jsonl)
log
Kürzliche Audit-Einträge als JSON ausgeben
rdc config audit log [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--since <spec> | Nur Einträge nach (z. B. '24h', '7d', ISO-Zeitstempel) | Nein | - |
--path <glob> | Nach JSON-Pointer-Glob filtern (z. B. /credentials/*) | Nein | - |
--actor <kind> | Nach Akteur-Typ filtern (human|agent) | Nein | - |
tail
Neue Audit-Einträge live streamen (Ctrl+C zum Beenden)
rdc config audit tailverify
Integrität der SHA-256-Hash-Kette über alle Audit-Einträge prüfen
rdc config audit verify2.22 backup-strategy
Benannte Backup-Strategien verwalten (Hot/Cold-Modi, Ziele, Zeitplanung)
set
Backup-Strategie erstellen oder aktualisieren
rdc config backup-strategy set [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Strategiename (erforderlich) | Ja | - |
--destination <name> | Zielname innerhalb der Strategie | Nein | - |
--storage <name> | Speicherkonfigurationsname (rclone-Zugangsdaten) | Nein | - |
--cron <expression> | Cron-Zeitplan (z.B. "0 * * * *" für stündlich) | Nein | - |
--mode <mode> | Backup-Modus: "hot" (ohne Ausfallzeit) oder "cold" (Stoppen, Snapshot, Neustart) | Nein | - |
--bwlimit <limit> | Rclone-Bandbreitenlimit (z.B. "6M", "10M:off", "08:00,3M;22:00,10M") | Nein | - |
--include <repos> | Nur diese Repos sichern (kommagetrennte Namen) | Nein | - |
--exclude <repos> | Diese Repos vom Backup ausschließen (kommagetrennte Namen) | Nein | - |
--folder <path> | Unterordner im Storage-Bucket für dieses Ziel (z. B. hot, cold) | Nein | - |
--enable | Strategie oder Ziel aktivieren | Nein | - |
--disable | Strategie oder Ziel deaktivieren | Nein | - |
remove
Backup-Strategie oder Ziel entfernen
rdc config backup-strategy remove [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Strategiename (erforderlich) | Ja | - |
--destination <name> | Nur dieses Ziel entfernen (andere Ziele bleiben erhalten) | Nein | - |
list
Alle Backup-Strategien auflisten
rdc config backup-strategy listshow
Backup-Strategie-Details anzeigen
rdc config backup-strategy show [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Strategiename (zeigt alle wenn weggelassen) | Nein | - |
3. Datenspeicherverwaltung
Ceph RBD-Datenspeicher-Lebenszyklus verwalten (init, fork, unfork, status)
3.1 init
Datenspeicher auf einer Maschine initialisieren (lokal oder Ceph RBD)
rdc datastore init [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Maschinenname (wo der Ceph-Datenspeicher gehostet wird) | Ja | - |
--size <size> | Datenspeichergröße (z.B. 5G, 50G, 100G) | Ja | - |
--backend <type> | Backend-Typ: local (Standard) oder ceph | Nein | local |
--pool <name> | Ceph-Pool-Name (Standard: aus Maschinenkonfiguration oder rbd) | Nein | rbd |
--image <name> | Ceph RBD-Image-Name (Standard: aus Maschinenkonfiguration über set-ceph) | Nein | - |
--cluster <name> | Ceph-Cluster-Name (Standard: ceph) | Nein | ceph |
--force | Initialisierung erzwingen, auch wenn der Datenspeicher bereits existiert (WARNUNG: formatiert den Speicher neu) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
3.2 fork
Lokale COW-Kopie eines Ceph-Datenspeichers via RBD-Snapshot + Clone erstellen (< 2s). Snapshot-/Clone-Namen aus der Ausgabe für unfork merken. Nur ein Fork pro Zielname; vor erneutem Forken unfork ausführen
rdc datastore fork [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Maschinenname (wo der Ceph-Datenspeicher gehostet wird) | Ja | - |
--to <name> | Clone-Suffix (erstellt Clone mit dem Namen <image>-fork-<name>). Der Fork bleibt auf der Quellmaschine | Ja | - |
--cow-size <size> | COW-Sicherungsdateigröße (Standard: auto, wächst bei Bedarf) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
3.3 unfork
Fork bereinigen: COW aushängen, Clone entfernen, Snapshot entfernen
rdc datastore unfork [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Maschinenname (wo der Ceph-Datenspeicher gehostet wird) | Ja | - |
--source <image> | Originales RBD-Image, das geforkt wurde (von config set-ceph --image, z.B. ds-prod) | Ja | - |
--snapshot <name> | Zu entfernender Snapshot (der "Snapshot:"-Wert aus der Fork-Ausgabe, z.B. fork-<timestamp>) | Ja | - |
--dest <image> | Zu entfernendes Clone-Image (der "Clone:"-Wert aus der Fork-Ausgabe, z.B. ds-prod-fork-<machine>) | Ja | - |
--pool <name> | Ceph-Pool-Name (Standard: aus Maschinenkonfiguration) | Nein | - |
--mount-point <path> | Fork-Einhängepunkt zum Aushängen (Standard: /mnt/rediacc) | Nein | - |
--force | Bereinigung fortsetzen, auch wenn einzelne Schritte fehlschlagen (z.B. Aushängen, Snapshot-Entfernung) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
3.4 status
Datenspeicher-Backend, Größe, Nutzung, Mount-Status und cow_mode (falls geforkt) anzeigen
rdc datastore status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Maschinenname (wo der Ceph-Datenspeicher gehostet wird) | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
4. Maschinenverwaltung
Remote-Maschinen verwalten (Status, Container, Dienste, Health)
4.1 list
Machines auflisten
rdc machine list [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
--search <text> | Suchen in {{field}} | Nein | - |
--sort <field> | Sortieren nach Feld | Nein | - |
--desc | Absteigend sortieren | Nein | - |
4.2 create
Eine neue Machine erstellen
rdc machine create [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
-b, --bridge <name> | Bridge-Name | Nein | - |
--vault <json> | Machine-Vault-Daten als JSON-String | Nein | - |
4.3 rename
Eine Maschine umbenennen
rdc machine rename [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--current-name <name> | Aktueller Ressourcenname | Ja | - |
--new-name <name> | Neuer Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
4.4 delete
Eine Machine löschen
rdc machine delete [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
-f, --force | Bestätigungsaufforderungen überspringen | Nein | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
4.5 vault
Maschinen-Tresor-Verwaltung (nur Cloud-Adapter)
rdc machine vault4.6 vault-status
{{t:cli.commands.machine.vault-status.description}}
rdc machine vault-status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
4.7 update
Machine-Konfiguration aktualisieren
rdc machine update4.8 health
Machine-Zustand für CI/CD-Pipelines prüfen
Der Health-Befehl gibt Systemmetriken, Container-Status, Dienststabilität und Speicherinformationen aus — nützlich für CI/CD-Pipeline-Prüfungen.
rdc machine health [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
4.9 containers
Laufende Container auf einer Maschine auflisten
rdc machine containers [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
--health-check | Zustandsprüfungsmodus - beendet mit Code 2 bei ungesunden Containern | Nein | - |
4.10 services
systemd-Dienste auf einer Machine auflisten
rdc machine services [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
--stability-check | Stabilitätsprüfungsmodus - beendet mit Code 2 bei fehlgeschlagenen/neu startenden Diensten | Nein | - |
4.11 query
Vollständigen Maschinenstatus anzeigen (System, Repos, Container, Dienste)
rdc machine query [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--system | Nur Systeminformationen einbeziehen | Nein | - |
--repositories | Nur Repositories einbeziehen | Nein | - |
--containers | Nur Container einbeziehen | Nein | - |
--services | Nur Dienste einbeziehen | Nein | - |
--network | Nur Netzwerkschnittstellen einbeziehen | Nein | - |
--block-devices | Nur Blockgeräte einbeziehen | Nein | - |
--licenses | Lizenzstatus der Repositorys einbeziehen | Nein | - |
--storage-health | BTRFS-Fragmentierung und reflink-Einsparungen pro Repository anzeigen | Nein | - |
--sync-certs | Auch den ACME-Zertifikats-Cache nach einer Abfrage von der Maschine abrufen | Nein | - |
--strict | Mit Nicht-Null-Code (Code 2) beenden, wenn ein Container den Health-Drift-Schwellenwert überschritten hat | Nein | - |
4.12 vault-status
Parsed-Vault-Status für eine Machine anzeigen
rdc machine vault-status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
4.13 repos
Auf einer Machine bereitgestellte Repositories auflisten
rdc machine repos [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
--search <text> | Repositories nach Name filtern | Nein | - |
4.14 test-connection
SSH-Verbindung zu einer Machine testen und Host-Schlüssel erfassen
rdc machine test-connection [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--ip <address> | Machine-IP-Adresse oder Hostname | Ja | - |
--user <name> | SSH-Benutzername | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
-b, --bridge <name> | Bridge-Name | Nein | - |
--port <number> | SSH-Port | Nein | 22 |
--password <pwd> | SSH-Passwort für erste Authentifizierung | Nein | - |
--datastore <path> | Datastore-Pfad auf Machine | Nein | /mnt/rediacc |
-m, --machine <name> | Machine-Name (zum Aktualisieren des Vault nach Test) | Nein | - |
--save | known_hosts nach erfolgreichem Test im Machine-Vault speichern | Nein | - |
Tipp: Verwenden Sie `--save-known-hosts`, um den Host-Schlüssel nach einem erfolgreichen Test automatisch im Maschinen-Vault zu speichern.
4.15 provision
Neue Maschine bei einem Cloud-Anbieter mit OpenTofu bereitstellen
rdc machine provision [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--provider <name> | Name des Cloud-Anbieters (aus config provider add) | Ja | - |
--region <region> | Standard-Region überschreiben | Nein | - |
--type <type> | Standard-Instanztyp überschreiben | Nein | - |
--image <image> | Standard-Betriebssystem-Image überschreiben | Nein | - |
--ssh-user <user> | SSH-Benutzername für die neue VM (Standard: root) | Nein | - |
--base-domain <domain> | Basisdomain für Infrastruktur (z.B. example.com). Impliziert --infra | Nein | - |
--no-infra | Infrastrukturkonfiguration überspringen (Proxy + DNS) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
4.16 deprovision
Cloud-bereitgestellte Maschine zerstören und aus Konfiguration entfernen
rdc machine deprovision [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--force | Bestätigungsaufforderung überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
4.17 backup
Maschinen-Backup-Verwaltung
list
Backup-Strategien aller Maschinen auflisten
rdc machine backup listschedule
Backup-Zeitplan auf einem Remote-Rechner deployen (systemd-Timer)
rdc machine backup schedule [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--dry-run | Generierte Units anzeigen ohne zu deployen | Nein | - |
--force | Auch fortfahren, wenn gerade ein Backup läuft (neue Unit greift beim nächsten Timer-Tick; laufender Vorgang behält seine alte Unit) | Nein | - |
--reset-failed | Fehlerstatus berührter Dienste nach erfolgreichem Deploy zurücksetzen (standardmäßig aus, bewahrt das Fehlersignal) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
now
Backup sofort auf einem Remote-Rechner auslösen
rdc machine backup now [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--strategy <name> | Strategiename (löst alle aus wenn weggelassen) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
status
Backup-Status und Timer-Zustand auf einem Remote-Rechner anzeigen
rdc machine backup status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--strategy <name> | Details für eine bestimmte Strategie anzeigen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
cancel
Laufendes Backup auf einem Remote-Rechner abbrechen
rdc machine backup cancel [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--strategy <name> | Strategiename (bricht alle ab wenn weggelassen) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
4.18 prune
Verwaiste Datenspeicher-Ressourcen und veraltete Snapshots von einer Maschine entfernen
rdc machine prune [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--dry-run | Anzeigen, was entfernt würde, ohne Änderungen vorzunehmen | Nein | - |
--orphaned-repos | Auch Repo-Images bereinigen, die in keiner Konfiguration enthalten sind | Nein | - |
--prune-unknown | Löscht nur Repos, die der renet .interim/state Mirror nicht klassifizieren kann (nicht in lokaler Konfiguration UND kein fork-markierter Mirror). Strikt enger als --orphaned-repos: Forks ohne Konfiguration werden bewahrt, wenn der Mirror sie identifiziert. Pre-mirror Legacy-Waisen und veraltete Grands mit gelöschtem Konfigurationseintrag fallen beide in diesen Bereich. | Nein | - |
--force-delete-mounted | Setzt die Mount-Sicherheitsprüfung außer Kraft und löscht Repos, auch wenn sie aktuell gemountet sind oder laufende Docker-Container haben. Unterscheidet sich von --force (das nur die Archiv-Schonfrist überschreibt). Gilt sowohl für --orphaned-repos als auch für --prune-unknown. | Nein | - |
--force | Bestätigungsaufforderungen überspringen | Nein | - |
--grace-days <days> | Schonfrist in Tagen für kürzlich archivierte Repos (Standard: 7) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
5. MCP-Server
Model Context Protocol Server für KI-Agenten
5.1 serve
MCP-Server starten (stdio-Transport)
rdc mcp serve [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--config <name> | Konfigurationsname für alle Befehle | Nein | - |
--timeout <ms> | Standard-Befehls-Timeout in Millisekunden | Nein | 120000 |
--allow-grand | Destruktive Operationen auf Grand-Repositories (nicht Fork) erlauben. Standard: Nur-Fork-Modus | Nein | - |
6. Repository-Lebenszyklus
Verschlüsselte Repositories auf Maschinen deployen und verwalten
6.1 mount
Repository mounten (LUKS-Container öffnen)
rdc repo mount [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--checkpoint | Nach dem Mounten von Checkpoint wiederherstellen | Nein | - |
--no-docker | Docker-Daemon nach dem Mounten nicht starten | Nein | - |
--parallel | Repositories parallel starten | Nein | - |
--concurrency <n> | Maximale gleichzeitige Repositories (Standard: 3) | Nein | 3 |
-y, --yes | Bestätigung für Stapeloperationen überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.2 unmount
Repository unmounten
rdc repo unmount [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--checkpoint | Checkpoint vor dem Unmounten erstellen | Nein | - |
--parallel | Repositories parallel starten | Nein | - |
--concurrency <n> | Maximale gleichzeitige Repositories (Standard: 3) | Nein | 3 |
-y, --yes | Bestätigung für Stapeloperationen überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.3 up
Repository deployen oder aktualisieren (Mount, Dienste starten)
rdc repo up [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--skip-checkpoint | CRIU checkpoint-Wiederherstellung überspringen, auch wenn checkpoint-Daten vorhanden sind (Neustart erzwingen) | Nein | - |
--tls | Dediziertes TLS-Zertifikat für dieses Repository anfordern (Forks verwenden standardmäßig das gemeinsame Maschinenzertifikat) | Nein | - |
--include-forks | Auch geforkte Repositories einbinden/starten | Nein | - |
--mount-only | Nur einbinden, keine Dienste starten | Nein | - |
--parallel | Repositories parallel starten | Nein | - |
--concurrency <n> | Maximale gleichzeitige Repositories (Standard: 3) | Nein | 3 |
-y, --yes | Bestätigung für Stapeloperationen überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
6.4 up-all
Alle Repositories auf einer Maschine deployen
rdc repo up-all6.5 down
Repository-Dienste stoppen
rdc repo down [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--unmount | Repository nach dem Stoppen unmounten | Nein | - |
--checkpoint | CRIU checkpoint vor dem Stoppen erstellen (Prozessspeicherzustand für spätere Wiederherstellung via 'repo up' sichern) | Nein | - |
-y, --yes | Bestätigung für Stapeloperationen überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
6.6 status
Repository-Status abrufen
rdc repo status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.7 list
Repositories auf einer Maschine auflisten
rdc repo list [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.8 create
Neues verschlüsseltes Repository erstellen
rdc repo create [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--size <size> | Repository-Größe (z.B. 10G, 100G, 1T) | Ja | - |
--no-docker | Docker-Daemon nach der Erstellung nicht starten | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.9 delete
Repository löschen (zerstört Container, Volumes und verschlüsseltes Image). Konfigurationseintrag bleibt erhalten. Verwenden Sie --archive-config, um Anmeldedaten nach deletedRepositories zu verschieben, zur Wiederherstellung über 'config restore-archived'
rdc repo delete [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--archive-config | Konfigurationseintrag nach deletedRepositories verschieben zur späteren Wiederherstellung | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
6.10 fork
CoW-Fork (Copy-on-Write) eines Repositorys erstellen
rdc repo fork [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--parent <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--tag <name> | Tag für den Fork (erstellt Name:Tag) | Ja | - |
--checkpoint | CRIU checkpoint auf der Quelle vor dem fork erstellen (Prozessspeicherzustand für Wiederherstellung beim fork erfassen) | Nein | - |
--up | Nach dem Fork mounten und Dienste starten (Fork + Mount + Up in einem Befehl) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.11 takeover
Daten des Grand-Repositorys durch Daten eines Forks ersetzen. Das Grand-Repository behält seine Identität (GUID, networkId, Domains, Autostart, Backup-Kette), erhält aber die aktualisierten Daten des Forks. Die alten Produktionsdaten werden als Backup-Fork gespeichert. Verwendung: Upgrade im Fork testen → prüfen → Übernahme in die Produktion.
rdc repo takeover [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--force | Änderungswarnungen überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.12 resize
Repository offline skalieren (unterstützt Vergrößern und Verkleinern)
rdc repo resize [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--size <size> | Neue Repository-Größe (z.B. 10G, 100G, 1T) | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.13 expand
Eingehängtes Repository online erweitern (ohne Ausfallzeit)
rdc repo expand [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--size <size> | Neue Repository-Größe (z.B. 10G, 100G, 1T) | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.14 validate
Repository-Integrität überprüfen
rdc repo validate [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.15 autostart
Automatischen Repository-Start beim Hochfahren verwalten
enable
Autostart für ein Repository aktivieren
rdc repo autostart enable [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
disable
Autostart für ein Repository deaktivieren
rdc repo autostart disable [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
list
Repositories mit aktiviertem Autostart auflisten
rdc repo autostart list [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.16 ownership
Repository-Verzeichnis-Besitz ändern
rdc repo ownership [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--uid <uid> | Besitzer-UID (Standard: 7111) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.17 template
Vorlage auf ein Repository anwenden
list
Alle eingebetteten Bereitstellungsvorlagen der CLI auflisten
rdc repo template listapply
Apply a template to a repository. Use a built-in template name (e.g. app-postgres) or --file for a custom JSON template. The template writes Rediaccfile, docker-compose.yml, and any additional files to the repository mount
rdc repo template apply [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Name der Zielmaschine | Ja | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Ja | - |
--file <path> | Pfad zur JSON-Vorlagendatei | Nein | - |
--grand <name> | Grand-Repository-Name (wird automatisch in GUID aufgelöst) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.18 push
Repository an ein Remote (Rechner oder Speicher) pushen. Namen weglassen, um alle Repos zu pushen. Der Zieltyp wird automatisch aus der Konfiguration erkannt. Bei Rechner-zu-Rechner-Transfer wird das verschlüsselte Repo-Image mit derselben GUID kopiert — dies ist ein Backup/Migration, kein Fork. Für einen unabhängigen Fork verwenden Sie zuerst 'repo fork', dann push. Verwenden Sie --up zum Bereitstellen nach dem Push
rdc repo push [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
--to <remote> | Name des Zielrechners oder Speichers (wird automatisch aus der Konfiguration erkannt) | Nein | - |
--to-machine <machine> | — | Nein | - |
--provision <provider> | Zielrechner automatisch über Cloud-Anbieter bereitstellen, wenn nicht vorhanden | Nein | - |
--checkpoint | CRIU-Checkpoint vor Backup erstellen (erfasst Prozessspeicherstatus für Live-Migration) | Nein | - |
--force | Vorhandenes Backup überschreiben erzwingen | Nein | - |
--up | Nach dem Push das Repository auf dem Zielrechner mounten und bereitstellen | Nein | - |
--tag <tag> | Deployment-Tag für Versionierung | Nein | - |
-m, --machine <name> | Machine-Name | Ja | - |
-w, --watch | Auf Änderungen achten | Nein | - |
--parallel | Repositories parallel starten | Nein | - |
--concurrency <n> | Maximale gleichzeitige Repositories (Standard: 3) | Nein | 3 |
-y, --yes | Bestätigung für Stapeloperationen überspringen | Nein | - |
--bwlimit <limit> | Bandbreitenlimit für rsync-Transfer (z.B. "6M", "10M") | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.19 pull
Repository von einem Remote (Rechner oder Speicher) pullen. Namen weglassen, um alle Repos zu pullen. Der Quelltyp wird automatisch aus der Konfiguration erkannt. Verwenden Sie --up zum Bereitstellen nach dem Pull
rdc repo pull [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Nein | - |
--from <remote> | Name des Quellrechners oder Speichers (wird automatisch aus der Konfiguration erkannt) | Nein | - |
--from-machine <machine> | — | Nein | - |
--force | Vorhandenes Repository überschreiben erzwingen | Nein | - |
--up | Nach dem Pull das Repository auf diesem Rechner mounten und bereitstellen | Nein | - |
-m, --machine <name> | Machine-Name | Ja | - |
-w, --watch | Auf Änderungen achten | Nein | - |
--parallel | Repositories parallel starten | Nein | - |
--concurrency <n> | Maximale gleichzeitige Repositories (Standard: 3) | Nein | 3 |
-y, --yes | Bestätigung für Stapeloperationen überspringen | Nein | - |
--bwlimit <limit> | Bandbreitenlimit für rsync-Transfer (z.B. "6M", "10M") | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.20 migrate
Live-Migration eines Repositorys von einer Maschine zur anderen mit minimaler Ausfallzeit. Zwei-Phasen-rsync: Massentransfer im Betrieb, dann kurzer Stopp für Delta-Sync. Unterstützt CRIU-Checkpoint für Prozessspeicher-Migration und automatische Bereitstellung von Zielmaschinen
rdc repo migrate [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--from <machine> | Name der Quellmaschine | Ja | - |
--to <machine> | Name der Zielmaschine | Ja | - |
--provision <provider> | Automatische Bereitstellung über Cloud-Anbieter (z.B. hetzner, linode) | Nein | - |
--bwlimit <limit> | Bandbreitenlimit für rsync-Transfer (z.B. 10M) | Nein | - |
--checkpoint | CRIU-Live-Migration: Prozessspeicherzustand erfassen und wiederherstellen | Nein | - |
--skip-dns | DNS-Umschaltung nach Migration überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
6.21 backup
Repository-Backups verwalten
list
Verfügbare Backups auf einem Remote (Rechner oder Speicher) auflisten
rdc repo backup list [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--from <remote> | Name des Quellrechners oder Speichers (wird automatisch aus der Konfiguration erkannt) | Nein | - |
--from-machine <machine> | — | Nein | - |
-m, --machine <name> | Machine-Name | Ja | - |
--path <subdir> | Unterverzeichnis innerhalb des Speicher-Roots. Bei Auslassung werden sowohl hot/ als auch cold/ aufgelistet und zusammengeführt. | Nein | - |
-w, --watch | Auf Änderungen achten | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.22 sync
Repositories und Dateien synchronisieren (Massen-Push/Pull, Dateitransfer)
push
Repositories in Cloud-Speicher übertragen (Name weglassen, um alle zu übertragen)
rdc repo sync pushpull
Repositories aus Cloud-Speicher abrufen (Name weglassen, um alle abzurufen)
rdc repo sync pullupload
Dateien in ein Repository hochladen
rdc repo sync upload [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
-m, --machine <name> | Machine-Name | Ja | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Nein | - |
--local <paths...> | Ein oder mehrere lokale Datei- oder Verzeichnispfade (Standard: aktuelles Verzeichnis) | Nein | - |
--remote <path> | Remote-Unterverzichnis-Pfad innerhalb des Repository | Nein | - |
--remote-file <path> | Einzelner entfernter Dateipfad (relativ zum Repository-Root) als Upload-Ziel. Schließt --remote aus. | Nein | - |
--mirror | Spiegelmodus - Remote-Dateien löschen, die nicht lokal vorhanden sind | Nein | - |
--verify | Dateien mit Prüfsummen nach der Synchronisierung überprüfen | Nein | - |
--confirm | Änderungen anzeigen und vor der Synchronisierung um Bestätigung bitten | Nein | - |
--exclude <patterns...> | Von der Synchronisierung auszuschließende Muster | Nein | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
download
Dateien aus einem Repository herunterladen
rdc repo sync download [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
-m, --machine <name> | Machine-Name | Ja | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Nein | - |
--local <path> | Lokaler Verzeichnispfad (Standard: aktuelles Verzeichnis) | Nein | - |
--remote <path> | Remote-Unterverzichnis-Pfad innerhalb des Repository | Nein | - |
--remote-file <path> | Pfad einer entfernten Datei im Repository (Alternative zu --remote für Einzeldatei-Transfers) | Nein | - |
--mirror | Spiegelmodus - lokale Dateien löschen, die nicht auf Remote vorhanden sind | Nein | - |
--verify | Dateien mit Prüfsummen nach der Synchronisierung überprüfen | Nein | - |
--confirm | Änderungen anzeigen und vor der Synchronisierung um Bestätigung bitten | Nein | - |
--exclude <patterns...> | Von der Synchronisierung auszuschließende Muster | Nein | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
status
Synchronisierungsstatus prüfen und lokale/entfernte Dateien vergleichen
rdc repo sync status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
-m, --machine <name> | Machine-Name | Ja | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Nein | - |
--local <path> | Lokaler Verzeichnispfad (Standard: aktuelles Verzeichnis) | Nein | - |
--remote <path> | Remote-Unterverzichnis-Pfad innerhalb des Repository | Nein | - |
--remote-file <path> | Pfad einer entfernten Datei im Repository (Alternative zu --remote für Einzeldatei-Transfers) | Nein | - |
6.23 snapshot
BTRFS-Snapshots auf Remote-Rechnern verwalten
create
BTRFS-Snapshot eines Repositorys erstellen
rdc repo snapshot createlist
Snapshots auf einem Remote-Rechner auflisten
rdc repo snapshot listdelete
Snapshot von einem Remote-Rechner löschen
rdc repo snapshot delete6.24 tunnel
Einen SSH-Port-Forward-Tunnel zum Port eines Containers auf einem Remote-Rechner erstellen. Container und Port werden automatisch erkannt, wenn eindeutig. Der Tunnel bleibt offen, bis Sie Strg+C drücken
rdc repo tunnel [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Nein | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Nein | - |
-c, --container <name> | Containername (automatisch erkannt, wenn nur einer läuft) | Nein | - |
--port <port> | Remote-Container-Port zum Weiterleiten | Nein | - |
--local <port> | Lokaler Port (Standard: gleich wie Remote-Port) | Nein | - |
6.25 secret
Manage per-repo secrets injected at deploy time. Two modes: env (REDIACC_SECRET_<KEY> via compose ${VAR} interpolation) and file (host tmpfs at /var/run/rediacc/secrets/<networkId>/<KEY>, mounted via Docker compose `secrets:` block). Secrets never enter the encrypted LUKS image, so forks inherit none — externals see the fork as a different principal.
get
Read a single secret. Returns a redacted stub (`<redacted:secret>:<digest8>`) under agent context regardless of policy.
rdc repo secret get [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <repository> | Repository-Name (z. B. mail, mail:staging). Ohne Tag wird :latest standardmäßig verwendet. | Ja | - |
--key <KEY> | Geheimnisschlüssel in UPPER_SNAKE_CASE (max. 64 Zeichen). Wird als REDIACC_SECRET_<KEY> für env-Modus oder /run/secrets/<key> in Containern für file-Modus bereitgestellt. | Ja | - |
list
Geheimnisschlüssel und -modi auflisten (niemals Werte, niemals Digests).
rdc repo secret list [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <repository> | Repository-Name (z. B. mail, mail:staging). Ohne Tag wird :latest standardmäßig verwendet. | Ja | - |
set
Geheimnis setzen oder überschreiben. Forks erben nicht; auf dem Fork explizit setzen. Im Agent-Kontext ist eine --current-Digest-Übereinstimmung erforderlich (passwd-Stil).
rdc repo secret set [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <repository> | Repository-Name (z. B. mail, mail:staging). Ohne Tag wird :latest standardmäßig verwendet. | Ja | - |
--key <KEY> | Geheimnisschlüssel in UPPER_SNAKE_CASE (max. 64 Zeichen). Wird als REDIACC_SECRET_<KEY> für env-Modus oder /run/secrets/<key> in Containern für file-Modus bereitgestellt. | Ja | - |
--value <value> | Geheimer Wert. `-` übergeben, um von stdin zu lesen (vermeidet Shell-Verlauf-Offenlegung). | Ja | - |
--mode <mode> | Lieferungsmodus: 'env' (sichtbar in Container-Umgebung, docker inspect) oder 'file' (tmpfs-Datei, niemals in env). Standard: file. | Nein | file |
--current <value> | SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write. | Nein | - |
--rotate-secret | Rotation bestätigen; --current-Vorbedingung überspringen (als Rotation auditiert). Verwenden, wenn absichtlich rotiert wird, ohne den vorherigen Wert zu verifizieren. | Nein | - |
unset
Ein Geheimnis löschen. Im Agent-Kontext ist eine --current-Digest-Übereinstimmung erforderlich.
rdc repo secret unset [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <repository> | Repository-Name (z. B. mail, mail:staging). Ohne Tag wird :latest standardmäßig verwendet. | Ja | - |
--key <KEY> | Geheimnisschlüssel in UPPER_SNAKE_CASE (max. 64 Zeichen). Wird als REDIACC_SECRET_<KEY> für env-Modus oder /run/secrets/<key> in Containern für file-Modus bereitgestellt. | Ja | - |
--current <value> | SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write. | Nein | - |
--rotate-secret | Rotation bestätigen; --current-Vorbedingung überspringen (als Rotation auditiert). Verwenden, wenn absichtlich rotiert wird, ohne den vorherigen Wert zu verifizieren. | Nein | - |
7. Speicherverwaltung
Speicheranbieter verwalten und Remote-Dateien durchsuchen
7.1 list
Speicheranbieter auflisten
rdc storage list [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
--search <text> | Suchen in {{field}} | Nein | - |
--sort <field> | Sortieren nach Feld | Nein | - |
--desc | Absteigend sortieren | Nein | - |
7.2 create
Einen neuen Speicheranbieter erstellen
rdc storage create [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
7.3 rename
Einen Speicheranbieter umbenennen
rdc storage rename [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--current-name <name> | Aktueller Ressourcenname | Ja | - |
--new-name <name> | Neuer Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
7.4 delete
Einen Speicheranbieter löschen
rdc storage delete [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-t, --team <name> | Team-Name | Nein | - |
-f, --force | Bestätigungsaufforderungen überspringen | Nein | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
7.5 vault
Speicher-Tresor-Verwaltung (nur Cloud-Adapter)
rdc storage vault7.6 browse
Dateien in einem Speichersystem durchsuchen
rdc storage browse [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
--path <subpath> | Unterverzeichnispfad zum Auflisten | Nein | “ |
7.7 prune
Verwaiste Backups aus dem Speicher löschen, die in keiner Konfiguration mehr vorhanden sind. Multi-Config-sicher mit Schonfrist-Schutz.
rdc storage prune [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Ausführungsmaschine: führt rclone list/delete-Aufrufe gegen den Speicher aus. Erforderlich, weil Clients rclone nicht lokal installiert haben sollen; Speicheranmeldedaten kommen weiterhin aus Ihrer lokalen Konfiguration. | Ja | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | Nein | - |
--force | Bestätigungsaufforderungen überspringen | Nein | - |
--force-delete-mounted | Setzt die Mount-Sicherheitsprüfung außer Kraft und löscht Cloud-Backups, auch wenn die Quell-GUID aktuell gemountet ist oder einen laufenden Container auf der Ausführungsmaschine hat. Unterscheidet sich von --force (das nur die Schonfrist für archivierte Repos überschreibt). | Nein | - |
--grace-days <days> | Schonfrist in Tagen für kürzlich archivierte Repos (Standard: 7) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
7.8 pull
Ein Backup aus dem Cloud-Speicher auf eine Maschine herunterladen
rdc storage pull8. VS Code-Integration
VS Code Remote SSH zu einer Maschine oder einem Repository öffnen
8.1 connect
Verbinden Sie sich mit einer Machine oder einem Repository in VS Code
rdc vscode connect [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
-m, --machine <name> | Machine-Name | Nein | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Nein | - |
-f, --folder <path> | Pfad zum Remote-Ordner zum Öffnen | Nein | - |
--url-only | Drucke die VS Code-URI statt sie zu starten | Nein | - |
-n, --new-window | In neuem VS Code-Fenster öffnen | Nein | - |
--skip-env-setup | Remote-Umgebungs-Setup überspringen | Nein | - |
--insiders | VS Code Insiders-Einstellungen verwenden | Nein | - |
8.2 list
Konfigurierte VS Code-SSH-Verbindungen auflisten
rdc vscode list8.3 cleanup
Entfernen Sie VS Code-SSH-Konfigurationen
rdc vscode cleanup [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--all | Alle rediacc-SSH-Konfigurationen entfernen | Nein | - |
-c, --connection <name> | Spezifische Verbindung entfernen | Nein | - |
8.4 check
Überprüfen Sie die VS Code-Installation und Konfiguration
rdc vscode check [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--insiders | VS Code Insiders-Einstellungen verwenden | Nein | - |
9. SSH-Terminalzugang
SSH-Terminal-Zugriff auf Machines und Repositories
9.1 connect
Verbinden Sie sich über SSH mit einer Machine oder einem Repository
rdc term connect [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
-m, --machine <name> | Machine-Name | Nein | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Nein | - |
-c, --command <cmd> | Ausführen eines Befehls statt interaktiver Shell | Nein | - |
--container <id> | Mit einem bestimmten Docker-Container verbinden | Nein | - |
--container-action <action> | Container-Aktion: Terminal, Logs, Stats, Exec | Nein | - |
--log-lines <lines> | Anzahl der angezeigten Log-Zeilen (Standard: 50) | Nein | - |
--follow | Logs-Ausgabe folgen | Nein | - |
--external | Erzwinge Start in externem Terminal-Fenster | Nein | - |
--reset-home | Per-Repo Home-Overlay für einen Neustart zurücksetzen | Nein | - |
10. Protokoll-Handler
{{scheme}}://-Protokoll-URLs registrieren und verarbeiten
10.1 register
Registrieren Sie den Protokollhandler systemweit
rdc protocol register [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--system | Systemweit registrieren (erfordert Admin-Rechte) | Nein | - |
--force | Neu-Registrierung erzwingen, auch wenn bereits registriert | Nein | - |
10.2 unregister
Deregistrieren Sie den Protokollhandler vom System
rdc protocol unregister [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--system | Systemweite Registrierung deregistrieren (erfordert Admin-Rechte) | Nein | - |
10.3 status
Registrierungsstatus des Protokollhandlers anzeigen
rdc protocol status10.4 open
Öffnen Sie eine {{scheme}}://-URL und führen Sie die Aktion aus
rdc protocol open <url>10.5 build
Erstellen Sie eine {{scheme}}://-URL aus Komponenten
rdc protocol build [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--token <token> | Authentifizierungs-Token | Ja | - |
-t, --team <name> | Team-Name | Ja | - |
-m, --machine <name> | Machine-Name | Ja | - |
-r, --repository <name> | Repository-Name (verbindet sich mit Repository-Umgebung) | Nein | - |
-a, --action <action> | Aktion ({{actions}}) | Nein | desktop |
-p, --params <key=value...> | Zusätzliche Parameter | Nein | - |
10.6 parse
Analysieren Sie eine {{scheme}}://-URL und zeigen Sie Komponenten
rdc protocol parse <url>11. Schnellbefehle (Shortcuts)
11.1 run
Führen Sie eine Funktion aus (Kurzform: queue create)
rdc run11.2 trace
Eine Aufgabe verfolgen (Kurzbefehl für: queue trace)
rdc trace11.3 cancel
Eine Aufgabe abbrechen (Kurzbefehl für: queue cancel)
rdc cancel11.4 retry
Eine fehlgeschlagene Aufgabe wiederholen (Kurzbefehl für: queue retry)
rdc retry12. Abonnementverwaltung
Maschinenlizenzierung und Abonnement verwalten
12.1 login
Mit einem API-Token aus dem Webportal authentifizieren
rdc subscription login [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --token <token> | API-Token (rdt_...) | Nein | - |
--server <url> | Account-Server-URL | Nein | - |
12.2 logout
Gespeichertes Abonnement-Token löschen
rdc subscription logout12.3 status
Abonnement- und Lizenzstatus anzeigen
rdc subscription status12.4 activation
Maschinenaktivierungsverwaltung
status
Maschinenaktivierungsstatus für eine Maschine anzeigen
rdc subscription activation status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
12.5 repo
Repository-Lizenzverwaltung
status
Installierte Repository-Lizenzen auf einer Maschine anzeigen
rdc subscription repo status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
12.6 refresh
Maschinenlizenz erneuern
activation
Maschinenaktivierung auf Remote-Maschine aktualisieren
rdc subscription refresh activation [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
repos
Repository-Lizenzen auf Remote-Maschine stapelweise aktualisieren
rdc subscription refresh repos [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
repo
Repository-Lizenz für ein bestimmtes Repository aktualisieren
rdc subscription refresh repo [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Ressourcenname | Ja | - |
-m, --machine <name> | Machine-Name | Ja | - |
13. CLI-Updates
CLI-Updates prüfen und anwenden
rdc update [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--force | Update erzwingen, auch wenn bereits aktuell | Nein | - |
--check-only | Nur auf Updates prüfen, ohne herunterzuladen | Nein | - |
--rollback | Auf die vorherige Version zurücksetzen | Nein | - |
--status | Auto-Update-Status und Diagnose anzeigen | Nein | - |
--channel <channel> | Release-Kanal festlegen (stable oder edge) | Nein | - |
14. Systemdiagnose
CLI-Umgebung und Renet-Integration diagnostizieren
rdc doctor15. Experimentelle VM-Operationen
Experimentelle VM-Operationen (bereitstellen, verwalten, zerstören)
15.1 up
VM-Cluster lokal bereitstellen
rdc ops up [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--force | Neustart aller VMs erzwingen | Nein | - |
--parallel | VMs parallel erstellen | Nein | - |
--basic | Minimaler Cluster (Bridge + 1 Worker) | Nein | - |
--lite | VM-Bereitstellung überspringen (nur Status) | Nein | - |
--skip-orchestration | Cluster-Orchestrierung überspringen | Nein | - |
--backend <backend> | Virtualisierungs-Backend (kvm|qemu, automatisch erkannt) | Nein | - |
--os <name> | VM-Betriebssystem (z.B. ubuntu-24.04, debian-12) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
15.2 down
VM-Cluster zerstören
rdc ops down [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--backend <backend> | Virtualisierungs-Backend (kvm|qemu, automatisch erkannt) | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
15.3 status
VM-Cluster-Status anzeigen
rdc ops status [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--backend <backend> | Virtualisierungs-Backend (kvm|qemu, automatisch erkannt) | Nein | - |
15.4 ssh
SSH-Verbindung zu einer VM
rdc ops ssh [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--vm-id <id> | ID der virtuellen Maschine | Ja | - |
-c, --command <cmd> | Ausführen eines Befehls statt interaktiver Shell | Nein | - |
--backend <backend> | Virtualisierungs-Backend (kvm|qemu, automatisch erkannt) | Nein | - |
--user <user> | SSH-Benutzername für VM-Verbindung | Nein | - |
15.5 setup
Virtualisierungsvoraussetzungen installieren
rdc ops setup [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
15.6 check
Virtualisierungsvoraussetzungen überprüfen
rdc ops checkHäufige Fehlermeldungen
Wenn etwas schiefgeht, liefert die CLI klare Fehlermeldungen:
| Fehler | Bedeutung |
|---|---|
| Authentifizierung erforderlich. Ausführen: rdc auth login | Sie müssen sich zuerst anmelden |
| Keine aktive Konfiguration. Erstellen Sie eine mit: rdc config init --name <name> | Keine Konfiguration aktiv — erstellen Sie eine mit `rdc config init` |
| Berechtigung verweigert | Ihr Konto verfügt nicht über die erforderlichen Berechtigungen |
| Machine-Name erforderlich. Verwenden Sie --machine <name> | Geben Sie eine Maschine mit `--machine` an oder setzen Sie einen Kontextstandard |
| Team-Name erforderlich. Verwenden Sie --team oder stellen Sie den Kontext ein. | Geben Sie ein Team mit `--team` an oder setzen Sie einen Kontextstandard |
| Regionsname erforderlich. Verwenden Sie --region oder stellen Sie den Kontext ein. | Geben Sie eine Region mit `--region` an oder setzen Sie einen Kontextstandard |
Ausgabeformate
Alle List/Get-Befehle unterstützen mehrere Ausgabeformate über `--output`:
rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table # defaultDies erleichtert die Integration der Rediacc CLI in Skripte, CI/CD-Pipelines und Automatisierungsworkflows.