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

Aide-mémoire RDC CLI

Référence rapide des commandes rdc : configurations, dépôts, machines, synchronisation et conteneurs. Ensemble complet d'options : ajoutez --help à toute commande.

Aide-mémoire RDC CLI

Cette aide-mémoire couvre les commandes rdc essentielles au déploiement quotidien, non la liste exhaustive. Pour voir toutes les options, ajoutez --help à n’importe quelle commande. Les cas particuliers et options rarement utilisées figurent dans la documentation complète.

Cycle de vie du dépôt

CommandeDescription
rdc repo create <repo> -m <machine>Créer un nouveau dépôt sur une machine
rdc repo up <repo>@<machine>Déployer ou mettre à jour un dépôt
rdc repo down <repo>@<machine>Arrêter un dépôt
rdc repo delete <repo>@<machine>Supprimer un dépôt
rdc repo fork <repo>@<machine> --tag <tag>Bifurquer un dépôt (quasi-instantané, BTRFS reflink)
rdc repo promote <repo>:<tag>Promouvoir un fork validé en production sous le nom du dépôt parent
rdc repo listLister tous les dépôts avec leur nom et GUID
rdc repo resize <repo> --size <size>Redimensionner le volume d’un dépôt arrêté
rdc repo expand <repo> --size <size>Agrandir sur place le volume d’un dépôt en cours d’exécution

Secrets par dépôt

Identifiants de déploiement en lecture seule. get retourne seulement un digest. La valeur n’est jamais retournée. Consultez Dépôts § Secrets pour le guide complet.

CommandeDescription
rdc repo secret set <repo> --key <KEY> --value <val> [--mode env|file] --current ""Créer un nouveau secret (--current "" pour la première écriture)
rdc repo secret set <repo> --key <KEY> --value <val> --current <prev>Écraser un secret existant (précondition de type passwd)
rdc repo secret set <repo> --key <KEY> --value <val> --rotate-secretÉcraser sans vérifier la valeur précédente (audité comme rotation)
rdc repo secret list <repo>Lister les noms des secrets et modes de livraison (jamais les valeurs, jamais les digests)
rdc repo secret get <repo> --key <KEY>Afficher le digest du secret et le mode (aucune valeur en clair, jamais)
rdc repo secret unset <repo> --key <KEY> --current <prev>Supprimer un secret
rdc repo secret unset <repo> --key <KEY> --rotate-secretSupprimer sans vérifier la valeur précédente

Les bifurcations n’héritent pas des secrets. Définissez-les explicitement sur la bifurcation avec rdc repo secret set <repo>:<tag>.

Sauvegarde et restauration

CommandeDescription
rdc repo push ... --bwlimit <limit>Limiter la bande passante rsync lors de l’envoi (ex. 10M)
rdc repo pull ... --bwlimit <limit>Limiter la bande passante rsync lors de la réception
rdc repo push ... --checkpointCréer un point de contrôle des conteneurs avant l’envoi
rdc backup manifests <repo-ref>Lister les instantanés que le stockage fragmenté contient
rdc backup browse <repo-ref>Lister les fichiers contenus dans un dépôt (local, lecture seule)
rdc backup snapshot <repo>Envoyer un instantané vers le stockage fragmenté : inventaire complet d’abord, cellules modifiées ensuite
rdc backup snapshot <repo> --dry-runPlanifier l’instantané sans l’envoyer ; indique ce qui serait déplacé
rdc backup verify <repo>Vérifier l’ancre de sauvegarde d’un dépôt par rapport au stockage fragmenté
rdc backup usageAfficher les octets stockés dans le stockage fragmenté par rapport à votre quota
rdc backup manifests <repo>Lister les manifestes d’instantanés enregistrés sur le serveur
rdc storage browse <storage>Parcourir le contenu du stockage

Migration de dépôt

CommandeDescription
rdc repo migrate <repo>@<machine> --to <machine>Déplacer un dépôt entre deux machines
rdc repo migrate ... --provisionProvisionner la destination avant le transfert
rdc repo migrate ... --checkpointCréer un point de contrôle avant de migrer
rdc repo migrate ... --skip-dnsIgnorer la mise à jour DNS après la migration
rdc repo migrate ... --bwlimit <limit>Limiter la bande passante de transfert

Stratégies de sauvegarde

CommandeDescription
rdc backup strategy set <name> --destination <storage> --cron <expr> --mode <hot|cold> --enableCréer ou mettre à jour une stratégie de sauvegarde nommée
rdc backup strategy listLister toutes les stratégies définies
rdc backup strategy show <name>Afficher les détails d’une stratégie
rdc backup strategy remove <name>Supprimer une stratégie
rdc backup schedule -m <machine>Déployer les stratégies de sauvegarde configurées sur une machine

Opérations de sauvegarde

CommandeDescription
rdc backup schedule -m <machine>Déployer les stratégies associées comme minuteries systemd
rdc backup schedule -m <machine> --dry-runAperçu des unités de minuterie sans déploiement (tokens masqués)
rdc backup run -m <machine>Exécuter immédiatement toutes les stratégies associées
rdc backup run <name> -m <machine>Exécuter immédiatement une stratégie spécifique
rdc backup status -m <machine>Afficher l’état des minuteries et les résultats récents des tâches
rdc backup status <name> -m <machine>Afficher l’état d’une stratégie spécifique
rdc backup cancel -m <machine>Annuler les sauvegardes en cours
rdc backup cancel <name> -m <machine>Annuler une sauvegarde en cours spécifique

Gestion des machines

CommandeDescription
rdc machine status <machine>État complet de la machine (système, conteneurs, services, dépôts, réseau)
rdc machine status <machine> --systemInformations système uniquement
rdc machine status <machine> --containersListe des conteneurs uniquement
rdc machine status <machine> --repositoriesListe des dépôts uniquement
rdc machine status <machine> --servicesListe des services uniquement
rdc machine status <machine> --networkInformations réseau uniquement
rdc machine status <machine> --block-devicesInformations sur les périphériques de bloc uniquement
rdc machine listLister toutes les machines dans la configuration
rdc machine setup <machine>Exécuter le provisionnement initial de la machine
rdc machine health <machine>Vérifier l’état de santé d’une machine
rdc machine scan-keys <machine>Actualiser les clés d’hôte SSH après une reconstruction
rdc machine prune <machine>Supprimer les ressources inutilisées de la machine
rdc machine deprovision <machine>Déprovisionner complètement une machine

Terminal et synchronisation

CommandeDescription
rdc term connect <machine>Ouvrir un terminal SSH vers la machine
rdc term connect <repo>@<machine>Ouvrir un terminal SSH vers le dépôt (définit DOCKER_HOST)
rdc term connect <machine> -c "<command>"Exécuter une commande sur la machine
rdc repo sync upload <repo>@<machine> --local <paths...>Téléverser un ou plusieurs fichiers/répertoires locaux vers le dépôt
rdc repo sync upload <repo>@<machine> --local <file> --remote-file <path>Téléverser un fichier local unique vers un chemin distant explicite
rdc repo sync download <repo>@<machine> --local <dir>Télécharger un répertoire du dépôt localement
rdc repo sync download <repo>@<machine> --remote-file <path> --local <dir>Télécharger un fichier distant dans un répertoire local
rdc vscode connect <repo>@<machine>Ouvrir une session VS Code Remote SSH
rdc vscode listLister les configurations SSH créées par vscode connect
rdc vscode cleanup --allSupprimer toutes les configurations SSH écrites par vscode connect
rdc repo tunnel <repo> -c <container> --port <port>Rediriger le port d’un conteneur via SSH

Configuration

CommandeDescription
rdc config init <name>Créer un fichier de configuration nommé
rdc config listLister toutes les configurations sur cette machine
rdc config set machine <alias>Faire pointer un alias vers une autre machine
rdc machine add <machine> --ip <host> --user <user>Ajouter une machine à la configuration
rdc storage import rclone.confImporter des fournisseurs de stockage depuis la configuration rclone
rdc storage listLister les fournisseurs de stockage configurés
rdc backup strategy set ...Définir une stratégie de sauvegarde nommée
rdc --config <name> <command>Utiliser un fichier de configuration nommé

Débogage et accès direct

CommandeDescription
rdc repo logs <repo>@<machine> -c <container> --lines 200 --followDiffuser les journaux d’un conteneur (recommandé)
rdc repo exec <repo>@<machine> -c <container> -- <command>Exécuter une commande dans un conteneur (recommandé)
rdc repo exec <repo>@<machine> -c <container> -i -- bashOuvrir un shell interactif dans un conteneur
rdc term connect <repo>@<machine> -c "docker ps"Lister les conteneurs dans un dépôt
rdc term connect <repo>@<machine> -c "docker logs <name>"Récupérer les journaux d’un conteneur
rdc term connect <repo>@<machine> -c "docker exec <name> <cmd>"Exécuter une commande dans un conteneur
rdc term connect <repo>@<machine> -c "docker restart <name>"Redémarrer un conteneur