JuiceFS

Ce guide connecte JuiceFS — le système de fichiers POSIX distribué cloud native — à RustFS comme backend de stockage objet. Vous allez formater un volume dont les chunks de données résident dans un compartiment (bucket) RustFS, le monter localement, puis lire et écrire des fichiers via le point de montage. Le flux a été validé avec juicefs v1.3.1 (édition communautaire, moteur de métadonnées SQLite) et rustfs/rustfs-x86-musl:v2.3.1.

Vous avez besoin du binaire JuiceFS, d’un moteur de métadonnées et de FUSE (fuse3 sous Linux). Ce déploiement est destiné aux tests d’intégration locaux, pas à la production.

Schéma d’architectureCopy Anchor Link

JuiceFS découpe chaque fichier en chunks et les stocke comme objets sous chunks/ dans le compartiment, tandis que le moteur de métadonnées suit les noms, les inodes et la disposition. Le système de fichiers se comporte comme un disque local, mais ne conserve aucune donnée localement.

rc mb rustfs/jfs-demo

juicefs format \
  --storage s3 \
  --bucket http://<your-rustfs-endpoint>:9000/jfs-demo \
  --access-key <your-access-key> \
  --secret-key <your-secret-key> \
  sqlite3:///opt/juicefs/jfs.db \
  rustfs-jfs

Data use s3://<your-rustfs-endpoint>:9000/jfs-demo/rustfs-jfs/
<STATUS> OK, rustfs-jfs is ready

mkdir -p /mnt/jfs
juicefs mount -d sqlite3:///opt/juicefs/jfs.db /mnt/jfs

OK, rustfs-jfs is ready at /mnt/jfs

echo "hello rustfs jfs" > /mnt/jfs/hello.txt
dd if=/dev/urandom of=/mnt/jfs/blob.bin bs=1M count=3
mkdir -p /mnt/jfs/dir1 && echo nested > /mnt/jfs/dir1/nested.txt
cat /mnt/jfs/hello.txt

hello rustfs jfs

/mnt/jfs :
  inode: 1
  files: 2
   dirs: 2
 length: 3.00 MiB

rc ls rustfs/jfs-demo/ -r

rustfs-jfs/chunks/0/0/1_0_17
rustfs-jfs/chunks/0/0/3_0_3145728
rustfs-jfs/chunks/0/0/4_0_7

juicefs umount /mnt/jfs
juicefs destroy --force sqlite3:///opt/juicefs/jfs.db rustfs-jfs
rc rm rustfs/jfs-demo/ --recursive --force

DépannageCopy Anchor Link

unknown option: --daemonCopy Anchor Link

L’option d’arrière-plan prend un seul tiret : juicefs mount -d. Sans elle, le montage reste au premier plan (utile pour le débogage).

fusermount3: mount failed: Permission deniedCopy Anchor Link

Le montage exige le périphérique FUSE. Dans un conteneur, ajoutez --device /dev/fuse --cap-add SYS_ADMIN (ou --privileged) ; sur un hôte, installez fuse3 et vérifiez que /dev/fuse existe.

Le montage reste bloqué ou n’atteint pas le stockageCopy Anchor Link

Le client doit joindre à la fois le moteur de métadonnées et le point de terminaison du compartiment. Comme l’URL du compartiment contient le point de terminaison, vérifiez-la depuis l’hôte de montage avec curl avant le formatage.

Étapes suivantesCopy Anchor Link

• Consultez les notes de compatibilité S3 avant d’adopter d’autres backends de stockage JuiceFS.
• Créez des identifiants de production dédiés avec la gestion des clés d’accès.
• Suivez la documentation JuiceFS pour passer le moteur de métadonnées à Redis et monter le volume depuis plusieurs clients.