Passer au contenu principal Passer à la navigation Passer au pied de page

Application CLI

Guide complet pour utiliser l'interface en ligne de commande Rediacc pour la gestion de la plateforme

Référence CLI Rediacc

Aperçu

La **CLI Rediacc** (`rdc`) est une interface en ligne de commande pour gérer tous les aspects de la plateforme Rediacc — authentification, infrastructure, dépôts, files d'attente, stockage et plus encore.

Guide d'installation

Téléchargez le dernier binaire pour votre plateforme depuis la [page des versions Rediacc](https://www.rediacc.com) ou installez via votre gestionnaire de paquets :

# macOS / Linux
curl -fsSL https://get.rediacc.com | sh

# Or use the packaged binary directly
./rdc --help

Options Globales

Chaque commande prend en charge ces flags globaux :

OptionLibellé
--outputFormat de sortie (table|json|yaml|csv)
--configUtiliser une configuration spécifique pour cette commande
--langRemplacement de langue ({{languages}})
--forceIgnorer les invites de confirmation

1. Utilitaires de l'agent

Utilitaires pour les assistants de codage IA

1.1 capabilities

Lister toutes les commandes disponibles avec leurs arguments et options

rdc agent capabilities

1.2 schema

Afficher le schéma détaillé d'une commande spécifique

rdc agent schema <command>

1.3 exec

Exécuter une commande avec une entrée JSON depuis stdin

rdc agent exec <command>

1.4 generate-reference

Générer la référence des commandes en Markdown pour les compétences Claude

rdc agent generate-reference

2. Gestion de la Configuration

Gérer les fichiers de configuration, machines et connexions SSH

Les fichiers de configuration stockent les informations de connexion (URL API, identifiants, équipe/région/pont par défaut) pour basculer rapidement entre les environnements.

2.1 init

Créer un nouveau fichier de configuration nommé

En mode local, vous pouvez ajouter des machines directement :

rdc config init [name] [options]
OptionLibelléRequisDéfaut
--ssh-key <path>Chemin vers la clé privée SSH (ex. ~/.ssh/id_rsa)Non-
--renet-path <path>Chemin vers le binaire renet (par défaut : renet dans PATH)Non-
--master-password <password>Chiffrer les ressources avec un mot de passe principalNon-
-u, --api-url <url>URL de l'APINon-

2.2 list

Lister tous les fichiers de configuration

rdc config list

2.3 show

Afficher les détails de la configuration actuelle

rdc config show

2.4 delete

Supprimer un fichier de configuration

rdc config delete <name>

2.5 set

Définir une valeur par défaut (équipe, région, pont)

rdc config set <key> <value>

Astuce: Définir des valeurs par défaut évite de passer `--team`, `--region` ou `--bridge` à chaque commande.

2.6 clear

Effacer les valeurs par défaut (toutes ou une clé spécifique)

rdc config clear [key]

2.7 recover

Restaurer la configuration depuis le fichier de sauvegarde (.bak)

rdc config recover [name] [options]
OptionLibelléRequisDéfaut
-y, --yesIgnorer l'invite de confirmationNon-

2.8 set-ssh

Mettre à jour la configuration SSH pour la configuration actuelle

rdc config set-ssh

2.9 set-renet

Définir le chemin vers le binaire renet pour le mode local

rdc config set-renet

2.10 ssh

Gérer la configuration de la clé SSH

set

Définir la clé SSH pour la configuration actuelle

rdc config ssh set [options]
OptionLibelléRequisDéfaut
--key <path>Chemin vers le fichier de clé SSH privéeOui-
--embedIntégrer le contenu de la clé dans la configuration au lieu de stocker le cheminNon-

show

Afficher la configuration actuelle de la clé SSH

rdc config ssh show

remove

Supprimer la clé SSH de la configuration actuelle

rdc config ssh remove

2.11 machine

Gérer les machines dans la configuration actuelle

add

Ajouter une machine à la configuration actuelle

rdc config machine add <name> [options]
OptionLibelléRequisDéfaut
--ip <address>Adresse IP ou nom d'hôte de la machineOui-
--user <username>Nom d'utilisateur SSHOui-
--port <port>Port SSHNon22
--datastore <path>Chemin du magasin de données sur la machineNon/mnt/rediacc

remove

Supprimer une machine de la configuration actuelle

rdc config machine remove <name>

list

Lister les machines dans la configuration actuelle

rdc config machine list

scan-keys

Scanner les clés d'hôte SSH pour les machines de la configuration actuelle

rdc config machine scan-keys [machine]

setup

Provisionner une machine distante pour les dépôts (installe renet, configure Docker, datastore BTRFS). Idempotent. Requis après config machine add et avant repo create

rdc config machine setup <name> [options]
OptionLibelléRequisDéfaut
--datastore <path>Chemin du datastore sur la machine distanteNon/mnt/rediacc
--datastore-size <size>Taille du datastore (ex. : 95%, 100G)Non95%
--debugActiver la sortie de débogage (mode local)Non-

set-ceph

Définir la configuration Ceph RBD pour une machine

rdc config machine set-ceph [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machineOui-
--pool <name>Nom du pool Ceph (ex., rbd)Oui-
--image <name>Nom de l'image RBD (ex., datastore-prod1)Oui-
--cluster <name>Nom du cluster CephNonceph

2.12 repository

Gérer les mappages de dépôts dans la configuration actuelle

add

Ajouter un mappage GUID de dépôt à la configuration actuelle

rdc config repository add <name> [options]
OptionLibelléRequisDéfaut
--guid <guid>GUID du dépôt (UUID des noms de fichiers de sauvegarde)Oui-
--tag <tag>Étiquette du dépôtNonlatest
--credential <credential>Identifiant du dépôt (phrase de passe de chiffrement)Non-
--network-id <id>ID réseau pour l'isolation Docker (2816, 2880, ...). Attribué automatiquement si omisNon-

remove

Supprimer un mappage de dépôt de la configuration actuelle

rdc config repository remove <name>

list

Lister les mappages GUID de dépôts dans la configuration actuelle

rdc config repository list

list-archived

Lister les identifiants de dépôts archivés

rdc config repository list-archived

restore-archived

Restaurer un identifiant de dépôt archivé

rdc config repository restore-archived <guid> [options]
OptionLibelléRequisDéfaut
--name <name>Restaurer avec un nom différentNon-

purge-archived

Supprimer définitivement tous les identifiants archivés

rdc config repository purge-archived

2.13 provider

Gérer les fournisseurs cloud pour le provisionnement automatique de machines

add

Ajouter un fournisseur cloud

rdc config provider add <name> [options]
OptionLibelléRequisDéfaut
--provider <source>Source de fournisseur connue (ex., linode/linode, hetznercloud/hcloud)Non-
--source <source>Source personnalisée de fournisseur OpenTofu (ex., vultr/vultr)Non-
--token <token>Jeton API pour le fournisseur cloudOui-
--region <region>Région par défaut pour les nouvelles machinesNon-
--type <type>Type/taille d'instance par défautNon-
--image <image>Image OS par défautNon-
--ssh-user <user>Nom d'utilisateur SSH pour les nouvelles VMs (par défaut : root)Non-
--resource <type>Personnalisé : type de ressource OpenTofu pour les VMsNon-
--label-attr <attr>Personnalisé : nom d'attribut pour le libellé de la VMNon-
--region-attr <attr>Personnalisé : nom d'attribut pour la régionNon-
--size-attr <attr>Personnalisé : nom d'attribut pour le type d'instanceNon-
--image-attr <attr>Personnalisé : nom d'attribut pour l'image du système d'exploitationNon-
--ipv4-output <attr>Personnalisé : attribut de sortie pour l'adresse IPv4Non-
--ipv6-output <attr>Personnalisé : attribut de sortie pour l'adresse IPv6Non-
--ssh-key-attr <attr>Personnalisé : nom d'attribut pour les clés SSHNon-
--ssh-key-format <format>Personnalisé : format de clé SSH (inline_list ou resource_id)Non-
--ssh-key-resource <type>Personnalisé : type de ressource OpenTofu pour les clés SSHNon-

remove

Supprimer la configuration d'un fournisseur cloud

rdc config provider remove <name>

list

Lister les fournisseurs cloud configurés

rdc config provider list

2.14 storage

Gérer les backends de stockage dans la configuration actuelle

import

Importer des stockages depuis un fichier de configuration rclone

rdc config storage import <file> [options]
OptionLibelléRequisDéfaut
--name <name>Importer uniquement cette section nomméeNon-

remove

Supprimer un stockage de la configuration actuelle

rdc config storage remove <name>

list

Lister les stockages dans la configuration actuelle

rdc config storage list

2.15 infra

Gérer la configuration d'infrastructure (proxy, DNS, certificats)

set

Définir la configuration d'infrastructure pour une machine (spécifique à la machine : IPs, domaine, ports ; partagé : email de certificat, token DNS Cloudflare)

rdc config infra set <machine> [options]
OptionLibelléRequisDéfaut
--public-ipv4 <ip>Adresse IPv4 publique (par machine)Non-
--public-ipv6 <ip>Adresse IPv6 publique (par machine)Non-
--base-domain <domain>Domaine de base pour les applications (par machine)Non-
--cert-email <email>E-mail pour les notifications de certificats TLS (partagé entre machines)Non-
--cf-dns-token <token>Jeton Cloudflare DNS API pour le défi ACME DNS-01 (partagé entre machines)Non-
--tcp-ports <ports>Ports TCP à rediriger (séparés par des virgules, ex., 25,143,465)Non-
--udp-ports <ports>Ports UDP à rediriger (séparés par des virgules, ex., 53)Non-

show

Afficher la configuration d'infrastructure pour une machine

rdc config infra show <machine>

push

Envoyer la configuration d'infrastructure à la machine (proxy Traefik, routeur, Cloudflare DNS). Exécutez d'abord 'config infra set <machine>'

rdc config infra push <machine> [options]
OptionLibelléRequisDéfaut
--debugActiver la sortie de débogage (mode local)Non-

2.16 cert-cache

Gérer les certificats TLS en cache

pull

Télécharger et mettre en cache les certificats TLS depuis une machine

rdc config cert-cache pull <machine> [options]
OptionLibelléRequisDéfaut
--no-pruneNe pas nettoyer les certificats d'ID réseau obsolètesNon-
--debugActiver la sortie de débogage (mode local)Non-

push

Envoyer les certificats TLS en cache vers une machine

rdc config cert-cache push <machine> [options]
OptionLibelléRequisDéfaut
--debugActiver la sortie de débogage (mode local)Non-

status

Afficher l'inventaire des certificats en cache

rdc config cert-cache status

clear

Supprimer le cache de certificats

rdc config cert-cache clear

2.17 backup-strategy

Gérer la stratégie de sauvegarde multi-destination

set

Configurer les paramètres de planification des sauvegardes

rdc config backup-strategy set [options]
OptionLibelléRequisDéfaut
--destination <storage>Nom de destination de stockage par défautNon-
--cron <expression>Expression cron pour la planification des sauvegardes (ex. "0 2 * * *")Non-
--enableActiver les sauvegardes planifiéesNon-
--disableDésactiver les sauvegardes planifiéesNon-

show

Afficher la configuration actuelle de planification des sauvegardes

rdc config backup-strategy show

3. Gestion du stockage de données

Gérer le cycle de vie du datastore Ceph RBD (init, fork, unfork, status)

3.1 init

Initialiser le datastore sur une machine (local ou Ceph RBD)

rdc datastore init [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine (où le datastore Ceph est hébergé)Oui-
--size <size>Taille du datastore (ex. : 5G, 50G, 100G)Oui-
--backend <type>Type de backend : local (par défaut) ou cephNonlocal
--pool <name>Nom du pool Ceph (par défaut : depuis la configuration de la machine, ou rbd)Nonrbd
--image <name>Nom de l'image Ceph RBD (par défaut : depuis la configuration de la machine via set-ceph)Non-
--cluster <name>Nom du cluster Ceph (par défaut : ceph)Nonceph
--forceForcer l'initialisation même si le datastore existe déjà (ATTENTION : reformate le stockage)Non-
--debugActiver la sortie de débogage (mode local)Non-

3.2 fork

Créer une copie COW locale d'un datastore Ceph via snapshot + clone RBD (< 2s). Conservez les noms de snapshot/clone de la sortie pour unfork. Un seul fork par nom de cible ; exécutez unfork avant de refaire un fork

rdc datastore fork [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine (où le datastore Ceph est hébergé)Oui-
--to <name>Suffixe du clone (crée un clone nommé <image>-fork-<name>). Le fork reste sur la machine sourceOui-
--cow-size <size>Taille du fichier de sauvegarde COW (par défaut : auto, croît à la demande)Non-
--debugActiver la sortie de débogage (mode local)Non-

3.3 unfork

Nettoyer un fork : démonter COW, supprimer le clone, supprimer le snapshot

rdc datastore unfork [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine (où le datastore Ceph est hébergé)Oui-
--source <image>Image RBD originale qui a été forkée (de config set-ceph --image, ex. ds-prod)Oui-
--snapshot <name>Snapshot à supprimer (la valeur "Snapshot:" de la sortie fork, ex. fork-<timestamp>)Oui-
--dest <image>Image de clone à supprimer (la valeur "Clone:" de la sortie fork, ex. ds-prod-fork-<machine>)Oui-
--pool <name>Nom du pool Ceph (par défaut : depuis la configuration de la machine)Non-
--mount-point <path>Point de montage du fork à démonter (par défaut : /mnt/rediacc)Non-
--forceContinuer le nettoyage même si des étapes individuelles échouent (ex. : démontage, suppression de snapshot)Non-
--debugActiver la sortie de débogage (mode local)Non-

3.4 status

Afficher le backend, la taille, l'utilisation, l'état de montage et cow_mode (si forké) du datastore

rdc datastore status [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine (où le datastore Ceph est hébergé)Oui-
--debugActiver la sortie de débogage (mode local)Non-

4. Gestion des Machines

Gérer les machines distantes (état, conteneurs, services, santé)

4.1 list

Lister les machines

rdc machine list [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
--search <text>Rechercher dans {{field}}Non-
--sort <field>Trier par champNon-
--descOrdre décroissantNon-

4.2 create

Créer une nouvelle machine

rdc machine create <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-b, --bridge <name>Nom du pontNon-
--vault <json>Données du coffre de la machine en tant que chaîne JSONNon-

4.3 rename

Renommer une machine

rdc machine rename <oldName> <newName> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-

4.4 delete

Supprimer une machine

rdc machine delete <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-f, --forceIgnorer les invites de confirmationNon-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-

4.5 vault

Gestion du coffre-fort machine (adaptateur cloud uniquement)

rdc machine vault

4.6 vault-status

{{t:cli.commands.machine.vault-status.description}}

rdc machine vault-status <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-

4.7 update

Mettre à jour la configuration de la machine

rdc machine update

4.8 health

Vérifier la santé de la machine pour les pipelines CI/CD

La commande health affiche les métriques système, l'état des conteneurs, la stabilité des services et les informations de stockage — utile pour les vérifications de pipeline CI/CD.

rdc machine health <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-

4.9 containers

Lister les conteneurs en cours d'exécution sur une machine

rdc machine containers <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
--health-checkMode de vérification de santé - sort avec le code 2 si des conteneurs ne sont pas sainsNon-

4.10 services

Lister les services systemd sur une machine

rdc machine services <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
--stability-checkMode de vérification de stabilité - sort avec le code 2 si des services échouent/redémarrentNon-

4.11 query

Afficher l'état complet de la machine (système, dépôts, conteneurs, services)

rdc machine query <name> [options]
OptionLibelléRequisDéfaut
--debugActiver la sortie de débogage (mode local)Non-
--systemInclure uniquement les informations systèmeNon-
--repositoriesInclure uniquement les dépôtsNon-
--containersInclure uniquement les conteneursNon-
--servicesInclure uniquement les servicesNon-
--networkInclure uniquement les interfaces réseauNon-
--block-devicesInclure uniquement les périphériques de blocNon-

4.12 vault-status

Afficher l'état du coffre analysé pour une machine

rdc machine vault-status <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-

4.13 repos

Lister les dépôts déployés sur une machine

rdc machine repos <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
--search <text>Filtrer les dépôts par nomNon-

4.14 test-connection

Tester la connexion SSH à une machine et capturer la clé d'hôte

rdc machine test-connection [options]
OptionLibelléRequisDéfaut
--ip <address>Adresse IP ou nom d'hôte de la machineOui-
--user <name>Nom d'utilisateur SSHOui-
-t, --team <name>Nom de l'équipeNon-
-b, --bridge <name>Nom du pontNon-
--port <number>Port SSHNon22
--password <pwd>Mot de passe SSH pour l'authentification initialeNon-
--datastore <path>Chemin du magasin de données sur la machineNon/mnt/rediacc
-m, --machine <name>Nom de la machine (pour mettre à jour le coffre après test)Non-
--saveEnregistrer known_hosts dans le coffre de la machine après test réussiNon-

Astuce: Utilisez `--save-known-hosts` pour persister automatiquement la clé de l'hôte dans le vault de la machine après un test réussi.

4.15 provision

Provisionner une nouvelle machine chez un fournisseur cloud avec OpenTofu

rdc machine provision <name> [options]
OptionLibelléRequisDéfaut
--provider <name>Nom du fournisseur cloud (depuis config provider add)Oui-
--region <region>Remplacer la région par défautNon-
--type <type>Remplacer le type d'instance par défautNon-
--image <image>Remplacer l'image OS par défautNon-
--ssh-user <user>Nom d'utilisateur SSH pour la nouvelle VM (par défaut : root)Non-
--base-domain <domain>Domaine de base pour l'infrastructure (ex. example.com). Implique --infraNon-
--no-infraIgnorer la configuration d'infrastructure (proxy + DNS)Non-
--debugActiver la sortie de débogage (mode local)Non-

4.16 deprovision

Détruire une machine provisionnée dans le cloud et la supprimer de la configuration

rdc machine deprovision <name> [options]
OptionLibelléRequisDéfaut
--forceIgnorer l'invite de confirmationNon-
--debugActiver la sortie de débogage (mode local)Non-

4.17 backup

Gestion des sauvegardes machine

schedule

Envoyer la planification de sauvegarde vers une machine distante (minuteur systemd)

rdc machine backup schedule <machine> [options]
OptionLibelléRequisDéfaut
--debugActiver la sortie de débogage (mode local)Non-

4.18 prune

Supprimer les ressources orphelines du datastore et les instantanés périmés d'une machine

rdc machine prune <name> [options]
OptionLibelléRequisDéfaut
--dry-runAfficher ce qui serait supprimé sans effectuer de modificationsNon-
--orphaned-reposSupprimer aussi les images de dépôts absents de toute configurationNon-
--forceIgnorer les invites de confirmationNon-
--grace-days <days>Période de grâce en jours pour les dépôts récemment archivés (par défaut : 7)Non-
--debugActiver la sortie de débogage (mode local)Non-

5. Serveur MCP

Serveur Model Context Protocol pour les agents IA

5.1 serve

Démarrer le serveur MCP (transport stdio)

rdc mcp serve [options]
OptionLibelléRequisDéfaut
--config <name>Nom de la configuration à utiliser pour toutes les commandesNon-
--timeout <ms>Délai d'expiration par défaut des commandes en millisecondesNon120000
--allow-grandAutoriser les opérations destructives sur les dépôts grand (non fork). Par défaut : mode fork uniquementNon-

6. Cycle de vie des dépôts

Déployer et gérer des dépôts chiffrés sur les machines

6.1 mount

Monter un dépôt (ouvrir le conteneur LUKS)

rdc repo mount [name] [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--checkpointRestaurer depuis un point de contrôle après le montageNon-
--no-dockerNe pas démarrer le démon Docker après le montageNon-
--parallelDémarrer les dépôts simultanémentNon-
--concurrency <n>Nombre maximum de dépôts simultanés (par défaut : 3)Non3
-y, --yesPasser la confirmation pour les opérations par lotsNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.2 unmount

Démonter un dépôt

rdc repo unmount [name] [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--checkpointCréer un point de contrôle avant le démontageNon-
--parallelDémarrer les dépôts simultanémentNon-
--concurrency <n>Nombre maximum de dépôts simultanés (par défaut : 3)Non3
-y, --yesPasser la confirmation pour les opérations par lotsNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.3 up

Déployer ou mettre à jour un dépôt (montage, démarrage des services)

rdc repo up [name] [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--mountMonter le dépôt d'abordNon-
--skip-checkpointIgnorer la restauration du checkpoint CRIU même si des données de checkpoint existent (forcer un démarrage propre)Non-
--tlsDemander un certificat TLS dédié pour ce dépôt (les forks utilisent le certificat partagé de la machine par défaut)Non-
--include-forksÉgalement monter/démarrer les dépôts forkésNon-
--mount-onlyMonter uniquement, sans démarrer les servicesNon-
--parallelDémarrer les dépôts simultanémentNon-
--concurrency <n>Nombre maximum de dépôts simultanés (par défaut : 3)Non3
-y, --yesPasser la confirmation pour les opérations par lotsNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-

6.4 up-all

Déployer tous les dépôts sur une machine

rdc repo up-all

6.5 down

Arrêter les services du dépôt

rdc repo down [name] [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--unmountDémonter le dépôt après l'arrêtNon-
--checkpointCréer un checkpoint CRIU avant l'arrêt (sauvegarder l'état mémoire des processus pour restauration ultérieure via 'repo up')Non-
-y, --yesPasser la confirmation pour les opérations par lotsNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-

6.6 status

Obtenir le statut du dépôt

rdc repo status <name> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.7 list

Lister les dépôts sur une machine

rdc repo list [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.8 create

Créer un nouveau dépôt chiffré

rdc repo create <name> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--size <size>Taille du dépôt (ex. 10G, 100G, 1T)Oui-
--no-dockerNe pas démarrer le démon Docker après la créationNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.9 delete

Supprimer un dépôt (détruit les conteneurs, volumes et l'image chiffrée). L'entrée de configuration est conservée. Utilisez --archive-config pour déplacer les identifiants vers deletedRepositories pour récupération via 'config restore-archived'

rdc repo delete <name> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--archive-configDéplacer l'entrée de configuration vers deletedRepositories pour récupération ultérieureNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-

6.10 fork

Créer un fork CoW (Copy-on-Write) d'un dépôt

rdc repo fork <parent> [tag] [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--tag <name>Tag pour le fork (crée nom:tag)Non-
--checkpointCréer un checkpoint CRIU sur la source avant le fork (capturer l'état mémoire des processus pour restauration sur le fork)Non-
--upMonter et démarrer les services après le fork (fork + mount + up en une seule commande)Non-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.11 takeover

Remplacer les données du dépôt principal par les données d'un fork. Le principal conserve son identité (GUID, networkId, domaines, démarrage automatique, chaîne de sauvegardes) mais obtient les données mises à jour du fork. Les anciennes données de production sont conservées comme fork de sauvegarde. Utilisation : tester la mise à niveau sur le fork → vérifier → prise de contrôle en production.

rdc repo takeover <fork> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--forceIgnorer les avertissements de modificationNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.12 resize

Redimensionner un dépôt hors ligne (supporte l'expansion et la réduction)

rdc repo resize <name> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--size <size>Nouvelle taille du dépôt (ex. 10G, 100G, 1T)Oui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.13 expand

Étendre un dépôt monté en ligne (sans interruption)

rdc repo expand <name> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--size <size>Nouvelle taille du dépôt (ex. 10G, 100G, 1T)Oui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.14 validate

Valider l'intégrité du dépôt

rdc repo validate <name> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.15 autostart

Gérer le démarrage automatique des dépôts au démarrage

enable

Activer le démarrage automatique pour un dépôt

rdc repo autostart enable [name] [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

disable

Désactiver le démarrage automatique pour un dépôt

rdc repo autostart disable [name] [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

list

Lister les dépôts avec le démarrage automatique activé

rdc repo autostart list [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.16 ownership

Changer la propriété du répertoire du dépôt

rdc repo ownership <name> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
--uid <uid>UID du propriétaire (par défaut : 7111)Non-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.17 template

Appliquer un modèle à un dépôt

list

Lister tous les modèles de déploiement intégrés à la CLI

rdc repo template list

apply

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]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machine cibleOui-
-r, --repository <name>Nom du dépôt (se connecte à l'environnement du dépôt)Oui-
--file <path>Chemin vers le fichier de modèle JSONNon-
--grand <name>Nom du grand dépôt (résolution automatique vers le GUID)Non-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.18 push

Pousser un dépôt vers un distant (machine ou stockage). Omettre le nom pour pousser tous les dépôts. Le type de cible est détecté automatiquement depuis la configuration. Pour un transfert machine-à-machine, l'image chiffrée du dépôt est copiée avec le MÊME GUID — c'est une sauvegarde/migration, pas un fork. Pour créer un fork indépendant, utilisez d'abord 'repo fork', puis push. Utilisez --up pour déployer après le push

rdc repo push [repo] [options]
OptionLibelléRequisDéfaut
--to <remote>Nom de la machine ou du stockage de destination (détecté automatiquement depuis la configuration)Non-
--to-machine <machine>Non-
--provision <provider>Provisionner automatiquement la machine cible via le fournisseur cloud si elle n'existe pasNon-
--checkpointCréer un checkpoint CRIU avant la sauvegarde (capture l'état de la mémoire des processus pour la migration à chaud)Non-
--forceForcer l'écrasement de la sauvegarde existanteNon-
--upAprès l'envoi, monter et déployer le dépôt sur la machine cibleNon-
--tag <tag>Tag de déploiement pour le versionnageNon-
-m, --machine <name>Nom de la machineOui-
-w, --watchSurveiller les modificationsNon-
--parallelDémarrer les dépôts simultanémentNon-
--concurrency <n>Nombre maximum de dépôts simultanés (par défaut : 3)Non3
-y, --yesPasser la confirmation pour les opérations par lotsNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.19 pull

Tirer un dépôt depuis un distant (machine ou stockage). Omettre le nom pour tirer tous les dépôts. Le type de source est détecté automatiquement depuis la configuration. Utilisez --up pour déployer après le pull

rdc repo pull [repo] [options]
OptionLibelléRequisDéfaut
--from <remote>Nom de la machine ou du stockage source (détecté automatiquement depuis la configuration)Non-
--from-machine <machine>Non-
--forceForcer l'écrasement du dépôt existantNon-
--upAprès le pull, monter et déployer le dépôt sur cette machineNon-
-m, --machine <name>Nom de la machineOui-
-w, --watchSurveiller les modificationsNon-
--parallelDémarrer les dépôts simultanémentNon-
--concurrency <n>Nombre maximum de dépôts simultanés (par défaut : 3)Non3
-y, --yesPasser la confirmation pour les opérations par lotsNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.20 backup

Gérer les sauvegardes de dépôts

list

Lister les sauvegardes disponibles sur un distant (machine ou stockage)

rdc repo backup list [options]
OptionLibelléRequisDéfaut
--from <remote>Nom de la machine ou du stockage source (détecté automatiquement depuis la configuration)Non-
--from-machine <machine>Non-
-m, --machine <name>Nom de la machineOui-
-w, --watchSurveiller les modificationsNon-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

6.21 sync

Synchroniser les dépôts et fichiers (push/pull en masse, transfert de fichiers)

push

Envoyer les dépôts vers le stockage cloud (omettre le nom pour tout envoyer)

rdc repo sync push

pull

Récupérer les dépôts depuis le stockage cloud (omettre le nom pour tout récupérer)

rdc repo sync pull

upload

Envoyer des fichiers vers un dépôt

rdc repo sync upload [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-m, --machine <name>Nom de la machineOui-
-r, --repository <name>Nom du dépôt (se connecte à l'environnement du dépôt)Non-
--local <path>Chemin du répertoire local (par défaut : répertoire actuel)Non-
--remote <path>Chemin du sous-répertoire distant dans le dépôtNon-
--mirrorMode miroir - supprimer les fichiers distants non présents localementNon-
--verifyVérifier les fichiers à l'aide de sommes de contrôle après synchronisationNon-
--confirmAperçu des modifications et demande de confirmation avant synchronisationNon-
--exclude <patterns...>Motifs à exclure de la synchronisationNon-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-

download

Télécharger des fichiers depuis un dépôt

rdc repo sync download [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-m, --machine <name>Nom de la machineOui-
-r, --repository <name>Nom du dépôt (se connecte à l'environnement du dépôt)Non-
--local <path>Chemin du répertoire local (par défaut : répertoire actuel)Non-
--remote <path>Chemin du sous-répertoire distant dans le dépôtNon-
--mirrorMode miroir - supprimer les fichiers locaux non présents à distanceNon-
--verifyVérifier les fichiers à l'aide de sommes de contrôle après synchronisationNon-
--confirmAperçu des modifications et demande de confirmation avant synchronisationNon-
--exclude <patterns...>Motifs à exclure de la synchronisationNon-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-

status

Vérifier l'état de synchronisation et comparer les fichiers locaux/distants

rdc repo sync status [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-m, --machine <name>Nom de la machineOui-
-r, --repository <name>Nom du dépôt (se connecte à l'environnement du dépôt)Non-
--local <path>Chemin du répertoire local (par défaut : répertoire actuel)Non-
--remote <path>Chemin du sous-répertoire distant dans le dépôtNon-

6.22 snapshot

Gérer les instantanés BTRFS sur les machines distantes

create

Créer un instantané BTRFS d'un dépôt

rdc repo snapshot create

list

Lister les instantanés sur une machine distante

rdc repo snapshot list

delete

Supprimer un instantané d'une machine distante

rdc repo snapshot delete

6.23 tunnel

Créer un tunnel SSH de redirection de port vers le port d'un conteneur sur une machine distante. Détecte automatiquement le conteneur et le port lorsqu'il n'y a pas d'ambiguïté. Le tunnel reste ouvert jusqu'à ce que vous appuyiez sur Ctrl+C

rdc repo tunnel [machine] [repository] [options]
OptionLibelléRequisDéfaut
-c, --container <name>Nom du conteneur (détecté automatiquement s'il n'y en a qu'un en cours d'exécution)Non-
--port <port>Port du conteneur distant à redirigerNon-
--local <port>Port local (par défaut identique au port distant)Non-

7. Gestion du Stockage

Gérer les fournisseurs de stockage et parcourir les fichiers distants

7.1 list

Lister les fournisseurs de stockage

rdc storage list [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
--search <text>Rechercher dans {{field}}Non-
--sort <field>Trier par champNon-
--descOrdre décroissantNon-

7.2 create

Créer un nouveau fournisseur de stockage

rdc storage create <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-

7.3 rename

Renommer un fournisseur de stockage

rdc storage rename <oldName> <newName> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-

7.4 delete

Supprimer un fournisseur de stockage

rdc storage delete <name> [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-f, --forceIgnorer les invites de confirmationNon-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-

7.5 vault

Gestion du coffre-fort de stockage (adaptateur cloud uniquement)

rdc storage vault

7.6 browse

Parcourir les fichiers dans un système de stockage

rdc storage browse <name> [options]
OptionLibelléRequisDéfaut
--path <subpath>Chemin du sous-répertoire à listerNon

7.7 prune

Supprimer les sauvegardes orphelines du stockage qui ne sont plus dans aucune configuration. Sécurisé multi-configuration avec protection par période de grâce.

rdc storage prune <storageName> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machineOui-
--dry-runAfficher les actions prévues sans effectuer de modificationsNon-
--forceIgnorer les invites de confirmationNon-
--grace-days <days>Période de grâce en jours pour les dépôts récemment archivés (par défaut : 7)Non-
--debugActiver la sortie de débogage (mode local)Non-
--skip-router-restartNe pas redémarrer le serveur de routes après la mise à jour du binaireNon-

7.8 pull

Télécharger une sauvegarde depuis le stockage cloud vers une machine

rdc storage pull

8. Intégration VS Code

Ouvrir VS Code Remote SSH vers une machine ou un dépôt

8.1 connect

Se connecter à une machine ou un dépôt dans VS Code

rdc vscode connect [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-m, --machine <name>Nom de la machineNon-
-r, --repository <name>Nom du dépôt (se connecte à l'environnement du dépôt)Non-
-f, --folder <path>Chemin du dossier distant à ouvrirNon-
--url-onlyAfficher l'URI VS Code au lieu de le lancerNon-
-n, --new-windowOuvrir dans une nouvelle fenêtre VS CodeNon-
--skip-env-setupIgnorer la configuration de l'environnement distantNon-
--insidersUtiliser les paramètres VS Code InsidersNon-

8.2 list

Lister les connexions SSH VS Code configurées

rdc vscode list

8.3 cleanup

Supprimer les configurations SSH VS Code

rdc vscode cleanup [options]
OptionLibelléRequisDéfaut
--allSupprimer toutes les configurations SSH rediaccNon-
-c, --connection <name>Supprimer une connexion spécifiqueNon-

8.4 check

Vérifier l'installation et la configuration de VS Code

rdc vscode check [options]
OptionLibelléRequisDéfaut
--insidersUtiliser les paramètres VS Code InsidersNon-

9. Accès Terminal SSH

Accès terminal SSH aux machines et dépôts

9.1 connect

Se connecter à une machine ou un dépôt via SSH

rdc term connect [options]
OptionLibelléRequisDéfaut
-t, --team <name>Nom de l'équipeNon-
-m, --machine <name>Nom de la machineNon-
-r, --repository <name>Nom du dépôt (se connecte à l'environnement du dépôt)Non-
-c, --command <cmd>Exécuter une commande au lieu d'un shell interactifNon-
--container <id>Se connecter à un conteneur Docker spécifiqueNon-
--container-action <action>Action du conteneur : terminal, logs, stats, execNon-
--log-lines <lines>Nombre de lignes de journaux à afficher (par défaut : 50)Non-
--followSuivre la sortie des journauxNon-
--externalForcer le lancement dans une fenêtre de terminal externeNon-
--reset-homeRéinitialiser la couche de répertoire personnel par dépôt pour un nouveau départNon-

10. Gestionnaire de Protocole

Enregistrer et gérer les URL du protocole {{scheme}}://

10.1 register

Enregistrer le gestionnaire de protocole sur le système

rdc protocol register [options]
OptionLibelléRequisDéfaut
--systemEnregistrer au niveau du système (nécessite des privilèges administrateur)Non-
--forceForcer la réinscription même si déjà enregistréNon-

10.2 unregister

Désinscrire le gestionnaire de protocole du système

rdc protocol unregister [options]
OptionLibelléRequisDéfaut
--systemDésinscrire l'enregistrement au niveau du système (nécessite des privilèges administrateur)Non-

10.3 status

Afficher l'état d'enregistrement du gestionnaire de protocole

rdc protocol status

10.4 open

Ouvrir une URL {{scheme}}:// et exécuter l'action

rdc protocol open <url>

10.5 build

Construire une URL {{scheme}}:// à partir de composants

rdc protocol build [options]
OptionLibelléRequisDéfaut
--token <token>Jeton d'authentificationOui-
-t, --team <name>Nom de l'équipeOui-
-m, --machine <name>Nom de la machineOui-
-r, --repository <name>Nom du dépôt (se connecte à l'environnement du dépôt)Non-
-a, --action <action>Action à effectuer ({{actions}})Nondesktop
-p, --params <key=value...>Paramètres supplémentairesNon-

10.6 parse

Analyser une URL {{scheme}}:// et afficher les composants

rdc protocol parse <url>

11. Commandes Rapides (Raccourcis)

11.1 run

Exécuter une fonction (raccourci pour : queue create)

rdc run

11.2 trace

Tracer une tâche (raccourci pour : queue trace)

rdc trace

11.3 cancel

Annuler une tâche (raccourci pour : queue cancel)

rdc cancel

11.4 retry

Réessayer une tâche échouée (raccourci pour : queue retry)

rdc retry

12. Gestion des Abonnements

Gérer les licences machine et l’abonnement

12.1 login

S’authentifier avec un jeton API du portail web

rdc subscription login [options]
OptionLibelléRequisDéfaut
-t, --token <token>Jeton API (rdt_...)Non-
--server <url>URL du serveur de compteNon-

12.2 logout

Supprimer le jeton d'abonnement stocké

rdc subscription logout

12.3 status

Afficher l’état de l’abonnement et de la licence

rdc subscription status

12.4 activation

Gestion de l'activation des machines

status

Afficher l'état d'activation d'une machine

rdc subscription activation status [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machineOui-

12.5 repo

Gestion des licences de dépôts

status

Afficher les licences de dépôts installées sur une machine

rdc subscription repo status [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machineOui-

12.6 refresh

Renouveler la licence de la machine

activation

Actualiser l'activation de la machine sur une machine distante

rdc subscription refresh activation [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machineOui-

repos

Actualiser les licences de dépôts par lots sur une machine distante

rdc subscription refresh repos [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machineOui-

repo

Actualiser la licence du dépôt pour un dépôt spécifique

rdc subscription refresh repo <repo> [options]
OptionLibelléRequisDéfaut
-m, --machine <name>Nom de la machineOui-

13. Mises à jour CLI

Vérifier et appliquer les mises à jour du CLI

rdc update [options]
OptionLibelléRequisDéfaut
--forceForcer la mise à jour même si déjà à jourNon-
--check-onlyVérifier les mises à jour sans téléchargerNon-
--rollbackRevenir à la version précédenteNon-
--statusAfficher l'état et les diagnostics de la mise à jour automatiqueNon-

14. Diagnostics système

Diagnostiquer l'environnement CLI et l'intégration renet

rdc doctor

15. Opérations VM Expérimentales

Opérations VM expérimentales (provisionner, gérer, détruire)

15.1 up

Provisionner un cluster VM localement

rdc ops up [options]
OptionLibelléRequisDéfaut
--forceForcer le redémarrage de toutes les VMNon-
--parallelCréer les VM en parallèleNon-
--basicCluster minimal (pont + 1 worker)Non-
--liteIgnorer le provisionnement des VM (statut uniquement)Non-
--skip-orchestrationIgnorer l'orchestration du clusterNon-
--backend <backend>Backend de virtualisation (kvm|qemu, détection automatique)Non-
--os <name>Système d'exploitation de la VM (ex. ubuntu-24.04, debian-12)Non-
--debugActiver la sortie de débogage (mode local)Non-

15.2 down

Détruire le cluster VM

rdc ops down [options]
OptionLibelléRequisDéfaut
--backend <backend>Backend de virtualisation (kvm|qemu, détection automatique)Non-
--debugActiver la sortie de débogage (mode local)Non-

15.3 status

Afficher l'état du cluster VM

rdc ops status [options]
OptionLibelléRequisDéfaut
--backend <backend>Backend de virtualisation (kvm|qemu, détection automatique)Non-

15.4 ssh

Se connecter en SSH à une VM

rdc ops ssh <vmId> [command...] [options]
OptionLibelléRequisDéfaut
--backend <backend>Backend de virtualisation (kvm|qemu, détection automatique)Non-
--user <user>Nom d'utilisateur SSH pour la connexion à la VMNon-

15.5 setup

Installer les prérequis de virtualisation

rdc ops setup [options]
OptionLibelléRequisDéfaut
--debugActiver la sortie de débogage (mode local)Non-

15.6 check

Vérifier les prérequis de virtualisation

rdc ops check

Messages d'Erreur Courants

Lorsque quelque chose ne va pas, la CLI fournit des messages d'erreur clairs :

ErreurSignification
L'authentification est requise. Exécutez : rdc auth loginVous devez d'abord vous connecter
Aucune configuration active. Créez-en une avec : rdc config init <name>Aucune configuration active — créez-en une avec `rdc config init`
Permission refuséeVotre compte ne dispose pas des permissions requises
Le nom de la machine est requis. Utilisez --machine <name>Spécifiez une machine avec `--machine` ou définissez un défaut de contexte
Le nom de l'équipe est requis. Utilisez --team ou définissez un contexte.Spécifiez une équipe avec `--team` ou définissez un défaut de contexte
Le nom de la région est requis. Utilisez --region ou définissez un contexte.Spécifiez une région avec `--region` ou définissez un défaut de contexte

Formats de Sortie

Toutes les commandes list/get prennent en charge plusieurs formats de sortie via `--output` :

rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table   # default

Cela facilite l'intégration de la CLI Rediacc dans les scripts, les pipelines CI/CD et les workflows d'automatisation.