Werkzeuge

Rediacc bündelt vier Werkzeuge für die tägliche Arbeit an Ihren Maschinen und Repositories: Dateisynchronisation über SSH, ein SSH-Terminal, VS Code-Integration und CLI-Updates. Alle vier Tools arbeiten über SSH. Auf der Fernseite ist kein Agent oder Daemon erforderlich. Wenn Sie für diese Aufgaben ein GUI benötigen, sind Sie auf dieser Seite falsch.

Dateisynchronisation (sync)

Übertragen Sie Dateien zwischen Ihrer Workstation und einem entfernten Repository mittels rsync über SSH.

Dateien hochladen

--local akzeptiert einen oder mehrere Pfade. Jeder Pfad kann eine Datei oder ein Verzeichnis sein. Dateien landen bei <remote>/<basename>; Verzeichnisinhalte werden in <remote>/ zusammengeführt. Für eine einzelne Datei verwenden Sie vorzugsweise --remote-file, um dem Ziel explizit den Dateipfad zu geben.

# Verzeichnis (Inhalt in Fernverzeichnis zusammengeführt)
rdc repo sync upload my-app --local ./src --remote /app/src

# Einzelne Datei in ein Fernverzeichnis (Basename erhalten)
rdc repo sync upload my-app --local ./config.yml --remote /app/conf

# Einzelne Datei mit explizitem Zielpfad
rdc repo sync upload my-app --local ./config.yml --remote-file /app/conf/config.yml

# Mehrere Quellen in einem Aufruf
rdc repo sync upload my-app --local a.yml b.yml ./assets --remote /app

--remote und --remote-file schließen sich gegenseitig aus. --remote-file erfordert genau einen --local-Pfad, der auf eine Datei zeigt.

--mirror kann nicht mit einer Dateiquelle kombiniert werden; es würde Nachbardateien im Fernverzeichnis löschen.

Dateien herunterladen

Verwenden Sie --remote für ein Verzeichnis (Standard) oder --remote-file für eine einzelne Datei. Die beiden Flags schließen sich gegenseitig aus.

# Verzeichnis
rdc repo sync download my-app --remote /app/data --local ./data

# Einzelne Datei - --local muss ein vorhandenes Verzeichnis sein
rdc repo sync download my-app --remote-file /app/conf/config.yml --local ./local-conf

Synchronisierungsstatus prüfen

rdc repo sync status my-app

Optionen

Option	Beschreibung
-m, --machine <name>	Zielmaschine
<ref> (positional)	Ziel-Repository-Ref: name, name:tag, optional @machine
--local <paths...>	Ein oder mehrere lokale Datei-/Verzeichnispfade (Upload) oder lokales Zielverzeichnis (Download)
--remote <path>	Entferntes Verzeichnis (relativ zum Repository-Einbindungspunkt)
--remote-file <path>	Entfernter Dateipfad für einzelne Datei-Uploads oder Downloads (Alternative zu --remote)
--dry-run	Änderungen anzeigen, ohne zu übertragen
--mirror	Quelle auf Ziel spiegeln, zusätzliche Dateien löschen (nur Verzeichnisquellen)
--verify	Prüfsummen nach der Übertragung verifizieren
--confirm	Interaktive Bestätigung mit Detailansicht
--exclude <patterns...>	Dateimuster ausschließen
--skip-router-restart	Neustart des Route-Servers nach der Operation überspringen

SSH-Terminal (term)

Öffnen Sie eine interaktive SSH-Sitzung zu einer Maschine oder in die Umgebung eines Repositories.

Kurzschreibweise

Der schnellste Weg, sich zu verbinden:

rdc term connect server-1                    # Mit einer Maschine verbinden
rdc term connect my-app             # Mit einem Repository verbinden

Befehl ausführen

Führen Sie einen Befehl aus, ohne eine interaktive Sitzung zu öffnen:

rdc term connect server-1 -c "uptime"
rdc term connect my-app -c "docker ps"

Bei der Verbindung zu einem Repository wird DOCKER_HOST automatisch auf den isolierten Docker-Socket des Repositories gesetzt, sodass docker ps nur die Container dieses Repositories anzeigt.

Connect-Unterbefehl

Oder verwenden Sie den connect-Unterbefehl mit demselben Ergebnis und expliziten Flags:

rdc term connect server-1
rdc term connect my-app

Container-Aktionen

Interagieren Sie direkt mit einem laufenden Container:

# Eine Shell im Container öffnen
rdc repo exec my-app -c <container> -i -- bash

# Container-Logs anzeigen
rdc repo logs my-app -c <container>

# Logs in Echtzeit verfolgen
rdc repo logs my-app -c <container> --follow

# Container-Statistiken anzeigen
rdc repo exec my-app -c <container> -i -- bash --container-action stats

# Einen Befehl im Container ausführen
rdc repo exec my-app -c <container> -- ls -la

Option	Befehl	Beschreibung
-c, --container <name>	beide	Ziel-Container innerhalb des Repositories
--lines <n>	repo logs	Anzahl der anzuzeigenden Log-Zeilen
-f, --follow	repo logs	Logs fortlaufend verfolgen
--timestamps	repo logs	Jede Zeile mit einem Zeitstempel versehen
-i, --interactive	repo exec	stdin offen halten (für eine Shell erforderlich)
-u, --user <user>	repo exec	Als bestimmter Benutzer ausführen

VS Code-Integration (vscode)

Öffnen Sie eine Remote-SSH-Sitzung in VS Code, vorkonfiguriert mit den korrekten SSH-Einstellungen.

Mit einem Repository verbinden

rdc vscode connect my-app

Dieser Befehl:

1. Erkennt Ihre VS Code-Installation
2. Konfiguriert die SSH-Verbindung in ~/.ssh/config
3. Speichert den SSH-Schlüssel für die Sitzung
4. Öffnet VS Code mit einer Remote-SSH-Verbindung zum Repository-Pfad

Konfigurierte Verbindungen auflisten

rdc vscode list

Verbindungen bereinigen

rdc vscode cleanup

Entfernt VS Code SSH-Konfigurationen, die nicht mehr benötigt werden.

Konfiguration überprüfen

rdc vscode check

Überprüft die VS Code-Installation, die Remote-SSH-Erweiterung und aktive Verbindungen.

Voraussetzung: Installieren Sie die Remote - SSH-Erweiterung in VS Code.

VS Code im Browser

Kein lokales VS Code? Starten Sie den Editor direkt aus der Repository-Sandbox und öffnen Sie ihn in jedem Browser:

rdc vscode connect my-app --browser

Dieser Befehl:

1. Installiert den Open-Source-Editor-Server einmalig auf der Maschine (schreibgeschützter gemeinsamer Pfad, mit Prüfsummenverifikation)
2. Startet ihn innerhalb der Repository-Sandbox, sodass der Dateibaum, das integrierte Terminal und alle untergeordneten Prozesse genau das sehen, was das Repository sieht
3. Öffnet einen SSH-Tunnel zu einem lokalen Port und startet Ihren Browser mit einer sitzungsbezogenen Token-URL

Der Server läuft weiter, nachdem Sie den Tunnel schließen; beim erneuten Verbinden wird er wiederverwendet. Verwalten Sie ihn mit:

rdc vscode serve status my-app
rdc vscode serve stop my-app

Option	Beschreibung
--no-open	URL ausgeben statt Browser zu starten
--url-only	Genau eine URL-Zeile auf stdout ausgeben (für Scripting) und den Tunnel halten
--local <port>	Lokalen Tunnel-Port festlegen
--server-provider <id>	Editor-Server-Implementierung: openvscode (Standard) oder code-server
--server-archive <file>	Aus einem vorbereiteten Tarball auf der Maschine installieren (kein Internet erforderlich)

Funktioniert unter Linux, macOS, Windows oder auf einem Tablet. Lokal wird nur ein Browser benötigt.

CLI-Updates (update)

Halten Sie die rdc-CLI auf dem neuesten Stand.

Nach Updates suchen

rdc update --check-only

Update anwenden

rdc update

Updates werden heruntergeladen und direkt angewendet. Die CLI wählt automatisch die richtige Binary für Ihre Plattform (Linux, macOS oder Windows). Die neue Version wird beim nächsten Start wirksam.

Zurücksetzen

rdc update --rollback

Setzt auf die zuvor installierte Version zurück. Nur verfügbar, nachdem ein Update angewendet wurde.

Update-Status

rdc update --status

Zeigt die aktuelle Version, den Update-Kanal und die Auto-Update-Konfiguration an.

Release-Kanäle

rdc update --channel edge      # Kontinuierlich bereitgestellte Produktions-Updates
rdc update --channel stable    # Nach 7-tägiger Erprobung von edge befördert (Standard)
rdc update --status            # Zeigt aktuellen Kanal und Versionsinformationen an