Installer RustFS sur macOS

Vérifier l’architecture du MacCopy Anchor Link

RustFS fournit des binaires distincts pour les Mac Apple silicon (arm64) et Intel (x86_64). Ouvrez Terminal et exécutez :

uname -m

Utilisez le résultat pour choisir le paquet approprié :

Avant de continuer, vérifiez également que :

• Vous avez le droit d’installer ou d’exécuter des applications et d’écrire dans le répertoire de données choisi.
• Les ports TCP 9000 et 9001 sont disponibles, ou vous avez choisi deux autres ports libres.
• Vous avez créé un répertoire de données dédié, par exemple $HOME/rustfs/data.

mkdir -p "$HOME/rustfs/data"

Choisir une méthode d’installationCopy Anchor Link

Télécharger et installer LauncherCopy Anchor Link

1. Ouvrez la page des versions de RustFS Launcher.
2. Sélectionnez la dernière version et développez Assets (fichiers de la version).
3. Téléchargez l’installateur macOS correspondant à votre architecture : AArch64 pour Apple Silicon, ou x86-64 pour Intel. Ne téléchargez Source code (code source) que si vous comptez compiler Launcher vous-même.
4. Ouvrez l’image disque téléchargée et déplacez RustFS Launcher vers Applications (dossier Applications).
5. Ouvrez RustFS Launcher depuis Applications.

Si macOS bloque le premier lancement, confirmez que le paquet provient de la page officielle des versions de rustfs/launcher. Ouvrez ensuite System Settings > Privacy & Security (Réglages Système > Confidentialité et sécurité) et autorisez cette application précise. Ne désactivez pas Gatekeeper globalement.

Configurer LauncherCopy Anchor Link

Configurez les champs de la fenêtre Launcher :

Utilisez Browse (Parcourir) pour sélectionner le répertoire de données, ou faites-le glisser dans Launcher. Launcher exige que le répertoire existe avant le démarrage. Le sélecteur de fichiers macOS affiche le chemin développé, et non la variable littérale $HOME.

Remplacez les identifiants indicatifs par vos propres valeurs. Launcher affiche d’abord les identifiants par défaut d’un test local. Ne les conservez pas sur un Mac accessible à d’autres utilisateurs.

Démarrer et vérifier RustFSCopy Anchor Link

1. Sélectionnez Launch RustFS (démarrer RustFS).
2. Attendez que Launcher indique que le point de terminaison configuré est en ligne.
3. Ouvrez http://localhost:9001 et connectez-vous avec la clé d’accès et la clé secrète que vous avez configurées.
4. Utilisez http://localhost:9000 comme point de terminaison pour les clients compatibles avec S3.

Si vous avez modifié l’hôte ou les ports, utilisez ces valeurs. L’URL de la Console n’est disponible que lorsque Console Endpoint est activé.

Launcher verrouille sa configuration tant qu’il gère un processus en cours d’exécution. Il crée aussi un répertoire logs à côté du répertoire de données. Par exemple, si vous sélectionnez $HOME/rustfs/data, les fichiers journaux du serveur se trouvent sous $HOME/rustfs/logs.

Arrêter ou quitter LauncherCopy Anchor Link

Sélectionnez Stop RustFS (arrêter RustFS) avant de modifier la configuration, de déconnecter un disque de données externe ou d’éteindre macOS.

Fermer la fenêtre de Launcher la masque dans la barre de menus. Cela n’arrête pas RustFS. Pour arrêter le processus géré et quitter Launcher, ouvrez l’icône de la barre de menus de Launcher et sélectionnez Quit (quitter). Sélectionnez Show (afficher), ou sélectionnez l’icône, pour restaurer la fenêtre.

Télécharger le binaire Apple SiliconCopy Anchor Link

Utilisez cette procédure lorsque uname -m renvoie arm64 :

1. Ouvrez la page des versions de RustFS.
2. Sélectionnez la version requise et téléchargez l’archive ZIP macOS AArch64 depuis Assets. Le nom du fichier commence par rustfs-macos-aarch64.
3. Créez un répertoire de programme et extrayez l’archive. Remplacez <version> par la version figurant dans le nom du fichier téléchargé :

mkdir -p "$HOME/rustfs/bin"
unzip "$HOME/Downloads/rustfs-macos-aarch64-<version>.zip" -d "$HOME/rustfs/bin"
chmod +x "$HOME/rustfs/bin/rustfs"
"$HOME/rustfs/bin/rustfs" --help

Si l’archive contient un nom de binaire propre à la plateforme plutôt que rustfs, utilisez ce nom de fichier dans les commandes suivantes, ou renommez-le en $HOME/rustfs/bin/rustfs.

Compiler le binaire Intel à partir du code sourceCopy Anchor Link

Utilisez cette procédure lorsque uname -m renvoie x86_64 et que vous avez besoin d’une version plus récente que v1.0.0-beta.9.

1. Installez les outils de ligne de commande Xcode :

xcode-select --install

2. Installez la chaîne d’outils Rust stable actuelle depuis rustup.rs, puis ouvrez une nouvelle session Terminal.
3. Clonez RustFS et extrayez la version dont vous avez besoin :

git clone https://github.com/rustfs/rustfs.git
cd rustfs
git checkout <release-tag>

4. Compilez la cible macOS Intel avec le script de compilation du dépôt :

./build-rustfs.sh --platform x86_64-apple-darwin

Le script de compilation inclut les ressources de la Console par défaut et vérifie le binaire produit. Utilisez le binaire indiqué à la fin de la sortie de compilation à l’étape suivante.

Démarrer le serveur autonomeCopy Anchor Link

Définissez les identifiants pour la session Terminal en cours et affectez le chemin de votre binaire téléchargé ou compilé :

export RUSTFS_ACCESS_KEY="<your-access-key>"
export RUSTFS_SECRET_KEY="<your-secret-key>"
export RUSTFS_BIN="$HOME/rustfs/bin/rustfs"

"$RUSTFS_BIN" server \
	--address "127.0.0.1:9000" \
	--console-enable true \
	--console-address "127.0.0.1:9001" \
	"$HOME/rustfs/data"

Pour une compilation Intel depuis les sources, remplacez RUSTFS_BIN par le chemin du binaire affiché par build-rustfs.sh. Laissez la fenêtre Terminal ouverte pendant l’exécution de RustFS. Appuyez sur Control+C pour arrêter le serveur.

Vérifier le serveur autonomeCopy Anchor Link

Ouvrez http://localhost:9001 et connectez-vous avec les identifiants configurés. Utilisez http://localhost:9000 comme point de terminaison pour les clients compatibles avec S3. RustFS utilise par défaut l’adressage de type chemin (path-style) : configurez les clients en conséquence.

Pour une vérification de bout en bout, créez un compartiment (bucket) nommé my-bucket, chargez (upload) hello.txt, puis confirmez que l’objet apparaît dans le compartiment.