Outils

Rediacc propose quatre outils pour travailler quotidiennement avec vos machines et dépôts : synchronisation de fichiers via SSH, terminal SSH, intégration VS Code et mises à jour automatiques du CLI. Les quatre outils fonctionnent sur SSH. Aucun agent ni daemon n’est requis côté distant. Si vous avez besoin d’une interface graphique pour cela, vous êtes sur la mauvaise page.

Synchronisation de fichiers (sync)

Transférez des fichiers entre votre poste de travail et un dépôt distant via rsync sur SSH.

Envoyer des fichiers

--local accepte un ou plusieurs chemins. Chaque chemin peut être un fichier ou un répertoire. Les fichiers sont placés à <remote>/<basename>; les contenus des répertoires fusionnent dans <remote>/. Pour un seul fichier, préférez --remote-file pour spécifier explicitement le chemin de destination.

# Répertoire (contents merged into remote)
rdc repo sync upload -m server-1 -r my-app --local ./src --remote /app/src

# Single file dropped into a remote directory (basename preserved)
rdc repo sync upload -m server-1 -r my-app --local ./config.yml --remote /app/conf

# Single file, explicit destination path
rdc repo sync upload -m server-1 -r my-app --local ./config.yml --remote-file /app/conf/config.yml

# Multiple sources in one call
rdc repo sync upload -m server-1 -r my-app --local a.yml b.yml ./assets --remote /app

--remote et --remote-file s’excluent mutuellement. --remote-file requiert exactement un seul chemin --local qui pointe vers un fichier.

--mirror ne peut pas être combiné avec une source fichier; cela supprimerait les fichiers frères dans le répertoire distant.

Télécharger des fichiers

Utilisez --remote pour un répertoire (par défaut) ou --remote-file pour un seul fichier. Les deux options s’excluent mutuellement.

# Répertoire
rdc repo sync download -m server-1 -r my-app --remote /app/data --local ./data

# Single file: --local must be an existing directory
rdc repo sync download -m server-1 -r my-app --remote-file /app/conf/config.yml --local ./local-conf

Vérifier l’état de la synchronisation

rdc repo sync status -m server-1 -r my-app

Options

Option	Description
-m, --machine <name>	Machine cible
-r, --repository <name>	Dépôt cible
--local <paths...>	Un ou plusieurs chemins locaux de fichier/répertoire (envoi) ou répertoire local de destination (téléchargement)
--remote <path>	Répertoire distant (relatif au point de montage du dépôt)
--remote-file <path>	Chemin du fichier distant pour les envois ou téléchargements de fichier unique (alternative à --remote)
--dry-run	Prévisualiser les changements sans transférer
--mirror	Miroir de la source vers la destination, supprimer les fichiers en trop (sources répertoires uniquement)
--verify	Vérifier les sommes de contrôle après le transfert
--confirm	Confirmation interactive avec vue détaillée
--exclude <patterns...>	Exclure des motifs de fichiers
--skip-router-restart	Ne pas redémarrer le serveur de routage après l’opération

Terminal SSH (term)

Ouvrez une session SSH interactive vers une machine ou dans l’environnement d’un dépôt.

Syntaxe abrégée

La manière la plus rapide de se connecter :

rdc term connect -m server-1                    # Se connecter à une machine
rdc term connect -m server-1 -r my-app             # Se connecter à un dépôt

Exécuter une commande

Exécutez une commande sans ouvrir de session interactive :

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

Lors de la connexion à un dépôt, DOCKER_HOST est automatiquement configuré vers le socket Docker isolé du dépôt, de sorte que docker ps n’affiche que les conteneurs de ce dépôt.

Sous-commande connect

Ou utilisez la sous-commande connect pour le même résultat, avec des options explicites :

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

Actions sur les conteneurs

Interagissez directement avec un conteneur en cours d’exécution :

# Ouvrir un shell dans un conteneur
rdc term connect -m server-1 -r my-app --container <container-id>

# Afficher les journaux d'un conteneur
rdc term connect -m server-1 -r my-app --container <container-id> --container-action logs

# Suivre les journaux en temps réel
rdc term connect -m server-1 -r my-app --container <container-id> --container-action logs --follow

# Afficher les statistiques d'un conteneur
rdc term connect -m server-1 -r my-app --container <container-id> --container-action stats

# Exécuter une commande dans un conteneur
rdc term connect -m server-1 -r my-app --container <container-id> --container-action exec -c "ls -la"

Option	Description
--container <id>	ID du conteneur Docker cible
--container-action <action>	Action : terminal (par défaut), logs, stats, exec
--log-lines <n>	Nombre de lignes de journaux à afficher (par défaut : 50)
--follow	Suivre les journaux en continu
--external	Utiliser un terminal externe au lieu du SSH intégré

Intégration VS Code (vscode)

Ouvrez une session SSH distante dans VS Code, préconfigurée avec les bons paramètres SSH.

Se connecter à un dépôt

rdc vscode connect -r my-app -m server-1

Cette commande :

1. Détecte votre installation de VS Code
2. Configure la connexion SSH dans ~/.ssh/config
3. Persiste la clé SSH pour la session
4. Ouvre VS Code avec une connexion Remote SSH vers le chemin du dépôt

Lister les connexions configurées

rdc vscode list

Nettoyer les connexions

rdc vscode cleanup

Supprime les configurations SSH de VS Code qui ne sont plus nécessaires.

Vérifier la configuration

rdc vscode check

Vérifie l’installation de VS Code, l’extension Remote SSH et les connexions actives.

Prérequis : Installez l’extension Remote - SSH dans VS Code.

VS Code dans le navigateur

Pas de VS Code local ? Servez l’éditeur depuis l’intérieur du sandbox du dépôt et ouvrez-le dans n’importe quel navigateur :

rdc vscode connect -r my-app -m server-1 --browser

Cette commande :

1. Installe le serveur d’éditeur open-source sur la machine une seule fois (chemin partagé en lecture seule, vérification de somme de contrôle)
2. Le démarre à l’intérieur du sandbox du dépôt, de sorte que l’arborescence de fichiers, le terminal intégré et chaque processus enfant voient exactement ce que voit le dépôt
3. Ouvre un tunnel SSH vers un port local et lance votre navigateur avec une URL à jeton de session

Le serveur continue de tourner après que vous fermez le tunnel ; la reconnexion le réutilise. Gérez-le avec :

rdc vscode serve status -r my-app -m server-1
rdc vscode serve stop -r my-app -m server-1

Option	Description
--no-open	Afficher l’URL au lieu de lancer le navigateur
--url-only	Afficher exactement une ligne d’URL sur stdout (pour les scripts) et maintenir le tunnel
--local <port>	Choisir le port local du tunnel
--server-provider <id>	Implémentation du serveur d’éditeur : openvscode (par défaut) ou code-server
--server-archive <file>	Installer depuis une archive pré-préparée sur la machine (pas d’internet nécessaire)

Fonctionne depuis Linux, macOS, Windows ou une tablette. La seule exigence locale est un navigateur.

Mises à jour du CLI (update)

Maintenez le CLI rdc à jour.

Vérifier les mises à jour

rdc update --check-only

Appliquer une mise à jour

rdc update

Les mises à jour sont téléchargées et appliquées sur place. Le CLI sélectionne automatiquement le bon binaire pour votre plateforme (Linux, macOS ou Windows). La nouvelle version prend effet au prochain lancement.

Restaurer la version précédente

rdc update --rollback

Revient à la version précédemment installée. Disponible uniquement après l’application d’une mise à jour.

État des mises à jour

rdc update --status

Affiche la version actuelle, le canal de mise à jour et la configuration de la mise à jour automatique.

Canaux de publication

rdc update --channel edge      # Mises à jour continuelles en production
rdc update --channel stable    # Promu à partir d'edge après 7 jours de test (par défaut)
rdc update --status            # Afficher le canal actuel et les informations de version