Section courante

A propos

Section administrative du site

s3fs

Système de fichiers S3
Linux Externe

Syntaxe

s3fs [-C [-h] | [-cdrf bucket] [-p access_key] [-s secret_access_key] ] | [ -o options mountpoint]

Paramètres

Nom Description
Mode commande
-C Ce paramètre permet d'entrer en mode de commande. Ce doit être la première option de la ligne de commande lorsque vous utilisez s3fs en mode commande.
-h Ce paramètre permet d'afficher les informations d'utilisation en mode commande.
-c bucket Ce paramètre permet de créer un compartiment S3.
-d bucket Ce paramètre permet de supprimez le compartiment S3 spécifié et toutes les données qu'il contient. Utilisez-le avec prudence !
-r bucket Ce paramètre permet de réparer de manière interactive un système de fichiers S3 défectueux (pas encore intégré).
-f bucket Ce paramètre permet de formater un compartiment S3 pour le rendre approprié pour le montage.
-k bucket Ce paramètre permet de faire basculer le verrou sur un compartiment. Les compartiments doivent être déverrouillés pour les formater ou les supprimer.
-p access_key Ce paramètre permet de fournir la clef d'accès AWS si elle n'est pas définie dans votre environnement.
-s secret_access_key Ce paramètre permet de fournir la clef d'accès secrète AWS si elle n'est pas définie dans votre environnement.
-o options Ce paramètre permet d'indiquer les options de montage lorsque s3fs fonctionne en mode de montage.
Mode montage
bucket=bucket Ce paramètre permet d'indiquer le nom du compartiment Amazon S3 que vous souhaitez monter (par défaut : aucun).
preserve_cache=[no|yes] Ce paramètre permet d'indiquer l'état du cache. Si la valeur est yes, le cache pour le montage spécifié ne sera pas supprimé lors du démontage, ce qui évitera la nécessité de téléchargements lors d'un remontage ultérieur (par défaut: no).
cachedir=directory Ce paramètre permet de fixer le répertoire de base où les fichiers s3fs mis en cache seront entreposés. Par défaut : «$HOME/.fuse-s3fs-cache/».
host=host_name Ce paramètre permet de remplacer le nom d'hôte par défaut d'Amazon S3. Par défaut : «s3.aws.amazon.com».
lazy_fsdata=[no|yes] Ce paramètre permet de fixer la méthode d'écriture du démontage. Si la valeur est yes, les métadonnées du système de fichiers ne seront réécrites sur S3 que lors du démontage. Par défaut : «yes».
writeback_time=seconds Ce paramètre permet d'indiquer le nombre de secondes d'hystérésis à suspendre lorsqu'on envisage de téléverser un fichier sur S3. Si, après la pause, s3fs détecte que d'autres processus ont ouvert un fichier, le téléversement est reporté. La valeur par défaut est 10.
AWS_ACCESS_KEY_ID=key Ce paramètre permet de fixer le AWS_ACCESS_KEY_ID pour votre compte AWS si vous ne souhaitez pas le placer dans votre environnement. Par défaut : «none».
AWS_SECRET_ACCESS_KEY=key Ce paramètre permet de fixer le AWS_SECRET_ACCESS_KEY pour votre compte AWS si vous ne souhaitez pas le placer dans votre environnement. Si vous ajoutez un montage au fichier «/etc/fstab», il est déconseillé d'utiliser ce paramètre. Cela permettra de publier votre clef secrète et d'autoriser les autres utilisateurs à utiliser votre compte. Par défaut : «none».

Description

Cette commande permet d'effectuer la gestion d'un système de fichiers S3 d'AWS d'Amazon (S3 FUSE). La commande s3fs est une application de système de fichiers FUSE soutenue par le service d'entreposage simple de services Web d'Amazon (soit S3, http://aws.amazon.com). La commande s3fs peut fonctionner en mode commande ou en mode montage (mount). En mode montage, s3fs monte un compartiment Amazon S3 (ayant été correctement formaté) en tant que système de fichiers local. En mode commande, s3fs est capable de manipuler les compartiments d'Amazon S3 de différentes manières utiles.

Remarques

Variables d'environnement

Commande Description
AWS_ACCESS_KEY_ID Cette variable d'environnement permet d'indiquer la clef publique de votre service Web Amazon. Il doit être configuré pour que s3fs puisse vous identifier sur Amazon.
AWS_SECRET_ACCESS_KEY Cette variable d'environnement permet d'indiquer la clef privée de votre service Web Amazon. Il doit être configuré pour que s3fs puisse vous identifier sur Amazon.

Installation

On peut installer la commande s3fs sur la distribution Ubuntu 16.04 à l'aide de la commande suivante :

sudo apt-get install s3fs

Sur de nombreuses distributions Linux, il est nécessaire de compiler la commande s3fs de la façon suivante :

yum install -y gcc libstdc++-devel gcc-c++ fuse fuse-devel curl-devel libxml2-devel mailcap automake openssl-devel git
git clone https://github.com/s3fs-fuse/s3fs-fuse.git
cd s3fs-fuse
./autogen.sh
./configure
make
make install

On peut installer la commande s3fs sur Mac OS X à l'aide de la commande suivante :

brew install s3fs

Exemples

L'exemple suivant permet de monter un compartiment nommé moncompartiment à partir du dossier /chemin/a/monter avec les informations de connexion situé dans le fichier «/etc/passwd-s3fs» :

s3fs moncompartiment /chemin/a/monter -o passwd_file=/etc/passwd-s3fs

L'exemple suivant permet de monter automatique le s3fs lors du démarrage de Linux en ajouter la ligne suivante dans le fichier /etc/fstab en utilisant un clef dans le fichier /etc/fichierdeclef et en utilisant l'utilisateur Apache (s'il vaut 048 dans le fichier /etc/group) :

s3fs#moncompartiment:/dossiers3 /chemin/a/monter fuse rw,allow_other,passwd_file=/etc/fichierdeclef,uid=48,gid=48,umask=0000 0 0


Dernière mise à jour : Samedi, le 10 novembre 2018