Client CLI (rc)

rc est le client en ligne de commande RustFS pour les opérations sur les objets S3 et l’administration de RustFS. Ce guide installe rc, configure un alias de cluster et présente les principales commandes d’inspection. Les exemples de téléchargement utilisent v0.1.30 ; consultez les versions du CLI RustFS pour une version plus récente avant l’installation.

InstallationCopy Anchor Link

LinuxCopy Anchor Link

Les archives Linux par défaut sont liées statiquement à musl, pour une large compatibilité. Choisissez l’onglet qui correspond à uname -m.

curl -fLO https://github.com/rustfs/cli/releases/download/v0.1.30/rustfs-cli-linux-amd64-v0.1.30.tar.gz
tar -xzf rustfs-cli-linux-amd64-v0.1.30.tar.gz
sudo install -m 0755 rc /usr/local/bin/rc

Si votre environnement exige spécifiquement un binaire lié à glibc, sélectionnez l’archive linux-amd64-gnu ou linux-arm64-gnu sur la page de la version.

macOSCopy Anchor Link

Choisissez l’onglet qui correspond à la valeur renvoyée par uname -m.

curl -fLO https://github.com/rustfs/cli/releases/download/v0.1.30/rustfs-cli-macos-amd64-v0.1.30.tar.gz
tar -xzf rustfs-cli-macos-amd64-v0.1.30.tar.gz
sudo install -m 0755 rc /usr/local/bin/rc

Vous pouvez aussi installer le paquet avec Homebrew :

brew install rustfs/tap/rc

WindowsCopy Anchor Link

La version Windows actuelle fournit un binaire AMD64. Installez-le avec le dépôt de paquets Scoop officiel :

scoop bucket add rustfs https://github.com/rustfs/scoop-bucket
scoop install rustfs/rc

Vérifier l’installationCopy Anchor Link

Ouvrez un nouveau terminal et vérifiez que rc est disponible :

rc --version
rc --help

UtilisationCopy Anchor Link

Configurer un aliasCopy Anchor Link

Un alias mémorise le point de terminaison RustFS et les identifiants, afin que vous n’ayez pas à les répéter pour chaque commande. Remplacez les identifiants avant d’exécuter les commandes :

rc alias set local http://localhost:9000 <your-access-key> <your-secret-key>
rc alias list

alias set remplace un alias existant du même nom. alias list n’affiche pas les clés secrètes.

Vérifier l’état du serviceCopy Anchor Link

Vérifiez si le service est actif et si ses dépendances requises sont prêtes :

rc ping local
rc ready local

Inspecter le clusterCopy Anchor Link

Utilisez la commande d’information administrative du cluster pour inspecter l’état du cluster, les serveurs, les disques et la capacité de stockage :

rc admin info cluster local

Listez les pools de serveurs lorsque le déploiement en utilise plusieurs :

rc admin pool list local

Les commandes d’administration exigent des identifiants disposant des autorisations correspondantes de l’API d’administration RustFS.

Inspecter les compartiments et les objetsCopy Anchor Link

Pour les nouveaux scripts, préférez les groupes de commandes qui placent le nom en premier :

rc bucket list local/
rc object list local/my-bucket
rc object stat local/my-bucket/hello.txt

Gérer les règles de cycle de vie et les niveaux de stockageCopy Anchor Link

rc regroupe les règles de cycle de vie, les niveaux de stockage distants et les demandes de restauration sous bucket lifecycle :

rc bucket lifecycle rule list local/my-bucket
rc bucket lifecycle tier list local
rc bucket lifecycle restore local/my-bucket/hello.txt --days 7

Utilisez les commandes rule pour ajouter, modifier, supprimer, exporter ou importer des règles de cycle de vie de compartiment. Utilisez les commandes tier pour ajouter un niveau distant, l’inspecter, en mettre à jour les identifiants ou le supprimer. L’ancienne forme rc ilm reste disponible comme alias de compatibilité, mais nous recommandons rc bucket lifecycle pour les nouveaux scripts.

Consultez Gestion du cycle de vie pour les flux de règles et de restauration, et Stockage hiérarchisé pour la configuration et la maintenance des niveaux distants.

Découvrir d’autres commandesCopy Anchor Link

Utilisez --help à n’importe quel niveau de commande pour voir les commandes et les options prises en charge par la version installée :

rc --help
rc alias --help
rc admin --help
rc admin info --help
rc bucket --help
rc bucket lifecycle --help
rc object --help

Pour les sources complètes et la référence des commandes, consultez le dépôt du CLI RustFS.