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://get.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) |
--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 <command>1.3 exec
Befehl mit JSON-Eingabe von stdin ausführen
rdc agent exec <command>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 init
Eine neue benannte Konfigurationsdatei erstellen
Im lokalen Modus können Sie Machines direkt hinzufügen:
rdc config init [name] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 | - |
2.2 list
Alle Konfigurationsdateien auflisten
rdc config list2.3 show
Aktuelle Konfigurationsdetails anzeigen
rdc config show2.4 delete
Eine Konfigurationsdatei löschen
rdc config delete <name>2.5 set
Einen Standardwert setzen (Team, Region, Bridge)
rdc config set <key> <value>Tipp: Standardwerte zu setzen bedeutet, dass Sie nicht bei jedem Befehl `--team`, `--region` oder `--bridge` angeben müssen.
2.6 clear
Standardwerte löschen (alle oder einen bestimmten Schlüssel)
rdc config clear [key]2.7 recover
Konfiguration aus Sicherungsdatei (.bak) wiederherstellen
rdc config recover [name] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-y, --yes | Bestätigungsaufforderung überspringen | Nein | - |
2.8 set-ssh
SSH-Konfiguration für die aktuelle Konfiguration aktualisieren
rdc config set-ssh2.9 set-renet
Pfad zur renet-Binärdatei für den lokalen Modus setzen
rdc config set-renet2.10 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.11 machine
Maschinen in der aktuellen Konfiguration verwalten
add
Maschine zur aktuellen Konfiguration hinzufügen
rdc config machine add <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 <name>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 [machine]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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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.12 repository
Repository-Zuordnungen in der aktuellen Konfiguration verwalten
add
Repository-GUID-Zuordnung zur aktuellen Konfiguration hinzufügen
rdc config repository add <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 <name>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 <guid> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Mit anderem Namen wiederherstellen | Nein | - |
purge-archived
Alle archivierten Anmeldedaten dauerhaft löschen
rdc config repository purge-archived2.13 provider
Cloud-Provider für automatische Maschinenbereitstellung verwalten
add
Cloud-Provider hinzufügen
rdc config provider add <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 <name>list
Konfigurierte Cloud-Provider auflisten
rdc config provider list2.14 storage
Speicher-Backends in der aktuellen Konfiguration verwalten
import
Speicher aus einer rclone-Konfigurationsdatei importieren
rdc config storage import <file> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--name <name> | Nur diesen benannten Abschnitt importieren | Nein | - |
remove
Speicher aus der aktuellen Konfiguration entfernen
rdc config storage remove <name>list
Speicher in der aktuellen Konfiguration auflisten
rdc config storage list2.15 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 <machine> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 <machine>push
Infrastrukturkonfiguration auf Maschine übertragen (Traefik-Proxy, Router, Cloudflare DNS). Führen Sie zuerst 'config infra set <machine>' aus
rdc config infra push <machine> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
2.16 cert-cache
Zwischengespeicherte TLS-Zertifikate verwalten
pull
TLS-Zertifikate von einer Maschine herunterladen und zwischenspeichern
rdc config cert-cache pull <machine> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 <machine> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
status
Zwischengespeicherten Zertifikatsbestand anzeigen
rdc config cert-cache statusclear
Zertifikats-Cache entfernen
rdc config cert-cache clear2.17 backup-strategy
Multi-Ziel-Backup-Strategie verwalten
set
Backup-Zeitplan-Einstellungen konfigurieren
rdc config backup-strategy set [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--destination <storage> | Standard-Speicherzielname | Nein | - |
--cron <expression> | Cron-Ausdruck für den Backup-Zeitplan (z.B. "0 2 * * *") | Nein | - |
--enable | Geplante Backups aktivieren | Nein | - |
--disable | Geplante Backups deaktivieren | Nein | - |
show
Aktuelle Backup-Zeitplan-Konfiguration anzeigen
rdc config backup-strategy show3. 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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <oldName> <newName> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
4.4 delete
Eine Machine löschen
rdc machine delete <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
4.9 containers
Laufende Container auf einer Maschine auflisten
rdc machine containers <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 | - |
4.12 vault-status
Parsed-Vault-Status für eine Machine anzeigen
rdc machine vault-status <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
4.13 repos
Auf einer Machine bereitgestellte Repositories auflisten
rdc machine repos <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--force | Bestätigungsaufforderung überspringen | Nein | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
4.17 backup
Maschinen-Backup-Verwaltung
schedule
Backup-Zeitplan auf Remote-Maschine übertragen (systemd-Timer)
rdc machine backup schedule <machine> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
4.18 prune
Verwaiste Datenspeicher-Ressourcen und veraltete Snapshots von einer Maschine entfernen
rdc machine prune <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--dry-run | Anzeigen, was entfernt würde, ohne Änderungen vorzunehmen | Nein | - |
--orphaned-repos | Auch Repo-Images bereinigen, die in keiner Konfiguration enthalten sind | 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 [name] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 [name] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 [name] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--mount | Repository vorher mounten | Nein | - |
--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 [name] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [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.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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <parent> [tag] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Name der Zielmaschine | Ja | - |
--tag <name> | Tag für den Fork (erstellt Name:Tag) | Nein | - |
--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 <fork> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [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.15 autostart
Automatischen Repository-Start beim Hochfahren verwalten
enable
Autostart für ein Repository aktivieren
rdc repo autostart enable [name] [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 | - |
disable
Autostart für ein Repository deaktivieren
rdc repo autostart disable [name] [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 | - |
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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <template> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 [repo] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 | - |
--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 [repo] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 | - |
--debug | Debug-Ausgabe aktivieren (lokaler Modus) | Nein | - |
--skip-router-restart | Neustart des Route-Servers nach Binary-Update überspringen | Nein | - |
6.20 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 | - |
-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.21 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 <path> | Lokaler Verzeichnispfad (Standard: aktuelles Verzeichnis) | Nein | - |
--remote <path> | Remote-Unterverzichnis-Pfad innerhalb des Repository | 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 | - |
--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 | - |
6.22 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.23 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 [machine] [repository] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 | - |
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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
7.3 rename
Einen Speicheranbieter umbenennen
rdc storage rename <oldName> <newName> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-t, --team <name> | Team-Name | Nein | - |
7.4 delete
Einen Speicheranbieter löschen
rdc storage delete <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 <name> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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 <storageName> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-m, --machine <name> | Machine-Name | Ja | - |
--dry-run | Zeigen, was ausgeführt würde, ohne Änderungen vorzunehmen | 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 | - |
--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 <repo> [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
-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 | - |
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 <vmId> [command...] [options]| Option | Beschreibung | Erforderlich | Standard |
|---|---|---|---|
--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> | 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.