CLI-Client (rc)

rc ist der RustFS-Kommandozeilenclient für S3-Objektoperationen und die RustFS-Verwaltung. In dieser Anleitung installieren Sie rc, konfigurieren einen Cluster-Alias und lernen die wichtigsten Befehle zur Einsicht kennen. Die Download-Beispiele verwenden v0.1.30. Prüfen Sie vor der Installation die RustFS-CLI-Releases auf eine neuere Version.

InstallationCopy Anchor Link

LinuxCopy Anchor Link

Die Standardarchive für Linux sind für eine breite Kompatibilität statisch mit musl gelinkt. Wählen Sie die Registerkarte, die zu uname -m passt.

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

Wenn Ihre Umgebung ausdrücklich eine mit glibc gelinkte Binärdatei benötigt, wählen Sie auf der Release-Seite das Archiv linux-amd64-gnu oder linux-arm64-gnu.

macOSCopy Anchor Link

Wählen Sie die Registerkarte, die zum Wert von uname -m passt.

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

Sie können das Paket alternativ über Homebrew installieren:

brew install rustfs/tap/rc

WindowsCopy Anchor Link

Die aktuelle Windows-Version stellt eine AMD64-Binärdatei bereit. Installieren Sie sie über den offiziellen Scoop-Bucket:

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

Installation prüfenCopy Anchor Link

Öffnen Sie ein neues Terminal und prüfen Sie, ob rc verfügbar ist:

rc --version
rc --help

VerwendungCopy Anchor Link

Alias konfigurierenCopy Anchor Link

Ein Alias speichert den RustFS-Endpunkt und die Zugangsdaten, damit Sie sie nicht bei jedem Befehl wiederholen müssen. Ersetzen Sie die Zugangsdaten, bevor Sie den Befehl ausführen:

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

alias set ersetzt einen vorhandenen Alias mit demselben Namen. alias list gibt geheime Zugriffsschlüssel nicht aus.

Integrität des Dienstes prüfenCopy Anchor Link

Prüfen Sie, ob der Dienst läuft und ob die erforderlichen Abhängigkeiten bereit sind:

rc ping local
rc ready local

Cluster einsehenCopy Anchor Link

Nutzen Sie den administrativen Befehl für Clusterinformationen, um Clusterstatus, Server, Laufwerke und Speicherkapazität einzusehen:

rc admin info cluster local

Listen Sie die Serverpools auf, wenn die Bereitstellung mehrere Speicherpools verwendet:

rc admin pool list local

Administrative Befehle erfordern Zugangsdaten mit den entsprechenden Berechtigungen der RustFS Admin API.

Buckets und Objekte einsehenCopy Anchor Link

Bevorzugen Sie für neue Skripte die Befehlsgruppen, die mit dem Substantiv beginnen:

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

Lebenszyklusregeln und Speicherstufen verwaltenCopy Anchor Link

rc fasst Lebenszyklusregeln, entfernte Speicherstufen und Wiederherstellungsanforderungen unter bucket lifecycle zusammen:

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

Mit den rule-Befehlen fügen Sie Bucket-Lebenszyklusregeln hinzu, bearbeiten, entfernen, exportieren oder importieren sie. Mit den tier-Befehlen fügen Sie eine entfernte Stufe hinzu, lesen sie aus, aktualisieren ihre Zugangsdaten oder entfernen sie. Die ältere Form rc ilm bleibt als Kompatibilitätsalias verfügbar. Wir empfehlen für neue Skripte rc bucket lifecycle.

Siehe Lebenszyklusverwaltung für Abläufe zu Regeln und Wiederherstellung und Gestufte Speicherung für Konfiguration und Wartung entfernter Stufen.

Weitere Befehle anzeigenCopy Anchor Link

Verwenden Sie --help auf jeder Befehlsebene, um die Befehle und Optionen Ihrer installierten Version anzuzeigen:

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

Den vollständigen Quellcode und die Befehlsreferenz finden Sie im RustFS-CLI-Repository.