Configurations ossfs avancées - Object Storage Service - Centre de documentation Alibaba Cloud

Prérequis

Vous avez installé ossfs 1,0 et configuré ossfs 1,0.

Format de la commande de montage

Format de la commande : ossfs bucket_name /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
Description des paramètres
- ossfs : la commande ossfs.
- bucket_name : le nom du bucket à monter.
- /tmp/ossfs : le répertoire local sur lequel monter le bucket, également appelé point de montage.
- -o : préfixe obligatoire pour les options de montage.
- url=http://oss-cn-hangzhou.aliyuncs.com : l'option de montage url spécifie l'endpoint du bucket cible. Le format de la valeur est http://endpoint.
  
  Pour trouver l'endpoint de votre bucket, accédez à la page Bucket List, sélectionnez votre bucket, puis cliquez sur Overview dans le volet de navigation de gauche. La section Port affiche l'endpoint. Cet exemple utilise un bucket situé dans la région Chine (Hangzhou).
  
  D'autres endpoints sont disponibles pour des environnements réseau spécifiques : oss-cn-hangzhou-internal.aliyuncs.com pour l'accès depuis une instance ECS via un réseau classique ou un VPC (interne), oss-accelerate.aliyuncs.com pour le domaine global Transfer Acceleration, et cn-hangzhou-internal.oss-data-acc.aliyuncs.com pour OSS Accelerator. Sélectionnez un endpoint en fonction de votre environnement réseau.
- sigv4 : active la signature V4. Ajoutez -osigv4 à votre commande de montage. Par défaut, ossfs utilise la signature V1. Si vous ajoutez cette option de montage, ossfs envoie des requêtes à OSS en utilisant le processus de signature V4.
- region=cn-hangzhou : l'ID de région pour la requête du bucket OSS. Ajoutez -oregion=<region_id> lors du montage du bucket. La valeur par défaut est vide. Cette option est requise lors de l'utilisation des signatures V4 pour spécifier la région de la requête.

Montage de base

Montage à l'aide d'un fichier de configuration

Créez les répertoires de montage.

Exécutez la commande suivante pour créer les répertoires vides /tmp/ossfs-1 et /tmp/ossfs-2 en tant que points de montage pour vos buckets.
```
mkdir /tmp/ossfs-1 /tmp/ossfs-2
```

Exemple de montage.

Exécutez les commandes suivantes pour monter respectivement bucket-test-1 et bucket-test-2, configurés dans le fichier de configuration par défaut, sur les répertoires /tmp/ossfs-1 et /tmp/ossfs-2.

ossfs bucket-test-1 /tmp/ossfs-1/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
ossfs bucket-test-2 /tmp/ossfs-2/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

Le résultat s'affiche comme suit.

root@i-xxx:~# ossfs xxx /tmp/ossfs-1 -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
[NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
    ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
root@i-xxx:~#
root@i-xxx                :~# df -h /tmp/ossfs-1
Filesystem      Size  Used Avail Use% Mounted on
ossfs            16E     0   16E   0% /tmp/ossfs-1

Montage à l'aide d'un rôle RAM ECS

Créez un répertoire de montage.

Exécutez la commande suivante pour créer le répertoire vide /tmp/ossfs à utiliser comme point de montage pour votre bucket.
```
mkdir /tmp/ossfs
```
Exemple de montage.

Remarque
Lors du montage d'ossfs à l'aide d'une URL de métadonnées d'instance, seul le mode d'accès normal est pris en charge. Pour plus d'informations sur les modes d'accès aux métadonnées, reportez-vous à la rubrique Instance metadata.

Exécutez la commande suivante pour monter un bucket nommé bucket1 sur le répertoire local /tmp/ossfs.

Remarque : lorsque vous montez un bucket à l'aide d'un rôle RAM ECS, vous devez spécifier l'URL des métadonnées d'instance avec le paramètre ram_role. L'adresse IP 100.100.100.200 est celle par défaut du service de métadonnées d'instance Alibaba Cloud ECS et ne doit pas être modifiée. Remplacez EcsRamRoleOssTest par le nom du rôle attaché à votre instance ECS. Ne modifiez aucune autre information.
```
ossfs bucket1 /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram_role=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleOssTest -o sigv4 -o region=cn-hangzhou
```

Le résultat s'affiche comme suit.

root@xxx         xxx:~# ossfs  xxx  /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram role=http://100.100.100.200/latest/meta-data/ram/security-credentials/xxx  -o sigv4 -o region=cn-hangzhou
[NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
        ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
root@xxx         xxx:~#
root@xxx         xxx:~# df -h /tmp/ossfs
Filesystem  Size  Used  Avail Use% Mounted on
ossfs       16E   0     16E   0%   /tmp/ossfs

Montage dans des scénarios spécifiques

Vous pouvez monter un répertoire spécifique ou ajouter des options de montage. Pour obtenir la liste des options, reportez-vous aux options de montage. Remarque : avant d'exécuter la commande de montage, assurez-vous que le répertoire de montage local est vide.

Montage d'un répertoire spécifique

Exécutez la commande suivante pour monter le répertoire folder du bucket bucket-ossfs-test sur le répertoire local /tmp/ossfs-folder.

ossfs bucket-ossfs-test:/folder /tmp/ossfs-folder -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

Montage à l'aide d'un fichier de configuration spécifié

Option de montage : utilisez l'option de montage passwd_file pour spécifier le chemin d'accès à un fichier de configuration ossfs 1,0 non par défaut. Définissez les permissions du fichier sur 600.
Exemple de montage

Exécutez la commande suivante pour monter bucket-test-3, configuré dans le fichier de configuration spécifié, sur le répertoire local /tmp/ossfs-3.
```
ossfs bucket-test-3 /tmp/ossfs-3 -o url=http://oss-cn-hangzhou.aliyuncs.com -o passwd_file=/etc/passwd-ossfs-3 -o sigv4 -o region=cn-hangzhou
```

Activation des journaux de débogage lors du montage

Option de montage : l'option de montage dbglevel définit le niveau de journalisation. Les niveaux de journal suivants sont pris en charge : critical, error, warn, info et debug. La valeur par défaut est critical. Par défaut, les journaux sont enregistrés dans /var/log/messages sur les systèmes CentOS et dans /var/log/syslog sur les systèmes Ubuntu. Vous pouvez également utiliser l'option de montage logfile pour spécifier un chemin personnalisé pour le fichier journal.
Exemple de montage 1

Exécutez la commande suivante pour monter bucket-ossfs-test-1 sur le répertoire local /tmp/ossfs-1. Dans cette commande, l'option -d est ajoutée pour activer le journal de débogage libfuse, et l'option de montage dbglevel est utilisée pour définir le niveau de journal sur debug.
```
ossfs bucket-ossfs-test-1 /tmp/ossfs-1 -d -o dbglevel=debug -o sigv4 -o region=cn-hangzhou
```
Exemple de montage 2

Exécutez la commande suivante pour monter bucket-ossfs-test-2 sur le répertoire local /tmp/ossfs-2. Le niveau de journal est défini sur debug et le journal de débogage libfuse est activé. Les messages de journal sont affichés sur le terminal au premier plan à l'aide de l'option -f.
```
ossfs bucket-ossfs-test-2 /tmp/ossfs-2 -d -o dbglevel=debug -f -o sigv4 -o region=cn-hangzhou
```

Configuration des permissions d'accès lors du montage

Par défaut, seul l'utilisateur qui exécute la commande de montage (le propriétaire) peut accéder au répertoire monté. Pour permettre à d'autres utilisateurs d'accéder au point de montage, configurez les paramètres décrits ci-dessous lors du montage du bucket.

Paramètre

Description

allow_other

Permet à tous les utilisateurs d'accéder au répertoire du point de montage lui-même, mais pas aux fichiers contenus dans ce répertoire. Vous devez définir les permissions pour les fichiers séparément. Utilisez la commande chmod pour modifier les permissions des fichiers individuels. Pour appliquer des permissions uniformes à tous les fichiers, configurez l'option umask.

uid

L'UID de l'utilisateur propriétaire du répertoire.

gid

Le GID du groupe propriétaire du répertoire.

umask

Définit le masque de permissions pour les fichiers et les répertoires dans le point de montage. Par exemple, pour définir les permissions dans le point de montage sur 770, ajoutez -o umask=007. Pour définir les permissions sur 700, ajoutez -o umask=077.

Exemple de montage 1

Exécutez la commande suivante pour monter bucket_name sur le répertoire local mount_point et utiliser l'option de montage allow_other pour accorder l'accès à tous les utilisateurs. Cela définit les permissions du répertoire de montage sur 777.
```
ossfs bucket_name mount_point -o url=endpoint -o allow_other -o sigv4 -o region=cn-hangzhou
```
Exemple de montage 2

Exécutez la commande suivante pour monter bucket_name sur le répertoire local mount_point et utiliser l'option de montage umask pour définir les permissions du répertoire de montage et des fichiers qu'il contient sur 770. Cela permet l'accès uniquement aux utilisateurs du même groupe.
```
ossfs bucket_name mount_point -o url=endpoint -o umask=007 -o sigv4 -o region=cn-hangzhou
```
Exemple de montage 3
1. Exécutez la commande suivante pour obtenir l'UID, le GID et les groupes d'un utilisateur spécifique. L'utilisateur www est utilisé dans cet exemple.
```
id www
```
  Le résultat de la commande s'affiche comme suit.
```
root@iZbp1325rf1sja6ye4kbm2Z:~# id www
uid=xxx(www) gid=xxx(www) groups=xxx(www)
```
2. Exécutez la commande suivante pour monter bucket_name sur le répertoire local mount_point et utiliser les options de montage uid et gid pour spécifier l'utilisateur et le groupe. Cette configuration accorde l'accès uniquement aux utilisateurs du même groupe et définit les permissions sur 770. Les valeurs uid et gid sont 1000 dans cet exemple. Avant d'exécuter la commande de montage, remplacez ces valeurs par les valeurs uid et gid de l'utilisateur cible.
```
ossfs bucket_name mount_point -o url=endpoint -o allow_other -o uid=1000 -o gid=1000 -o umask=007 -o sigv4 -o region=cn-hangzhou
```

Conseils utiles

Montage automatique au démarrage

Un bucket monté manuellement n'est pas remonté automatiquement lors du redémarrage du système. Pour activer le montage automatique au démarrage, suivez les étapes ci-dessous. Avant d'activer le montage automatique, assurez-vous que le montage manuel fonctionne. Cela évite les échecs de démarrage de l'ECS. La méthode suivante active le montage automatique après avoir configuré ossfs avec une paire AccessKey.

Écrivez le nom du bucket, l'AccessKey ID, l'AccessKey secret et les autres informations dans le fichier /etc/passwd-ossfs, et définissez les permissions du fichier sur 640.

Pour plus d'informations sur les étapes de configuration, reportez-vous à la rubrique Configurer ossfs 1,0.

Configurez le montage automatique au démarrage.

Remarque

Les exemples suivants montrent comment activer le montage automatique au démarrage pour les distributions et versions courantes. Pour les autres distributions et versions, reportez-vous à la documentation de votre distribution.

Montage avec fstab

Ajoutez la ligne suivante au fichier /etc/fstab :

ossfs#bucket_name mount_point fuse _netdev,url=url,allow_other 0 0

Le tableau suivant décrit les paramètres.

Paramètre

Description

bucket_name

Le nom du bucket à monter. Remplacez bucket_name par le nom de votre bucket.

mount_point

Le répertoire de montage local. Remplacez mount_point par le chemin de votre répertoire de montage local.

url=url

L'endpoint du bucket cible.

0 0

Les options du système de fichiers.

Enregistrez le fichier /etc/fstab. Exécutez la commande mount -a -t fuse. Si aucune erreur n'est signalée, la configuration est correcte.
Une fois l'étape précédente terminée, le montage automatique est activé sur Ubuntu 14.04. Pour CentOS 6.5, vous devez également exécuter la commande suivante :
```
chkconfig netfs on
```

Montage avec un script de démarrage

Créez un fichier nommé ossfs dans le répertoire /etc/init.d/, et copiez le contenu suivant dans le fichier. Remplacez les valeurs de la commande de montage par les informations de votre bucket cible.

#! /bin/bash
#
# ossfs      Automount Aliyun OSS Bucket in the specified direcotry.
#
# chkconfig: 2345 90 10
# description: Activates/Deactivates ossfs configured to start at boot time.
ossfs your_bucket your_mountpoint -ourl=your_url -oallow_other

Accordez les permissions d'exécution au nouveau script ossfs :
```
chmod a+x /etc/init.d/ossfs
```
Une fois la commande exécutée, vous pouvez essayer d'exécuter le script. Si le contenu du script est correct, le bucket OSS est monté sur le répertoire spécifié.
Configurez le script ossfs pour qu'il démarre au démarrage en tant que service :
```
chkconfig ossfs on
```
Après avoir effectué les étapes précédentes, ossfs est automatiquement monté au démarrage.

Important

chkconfig ne redémarre pas automatiquement ossfs s'il se termine de manière inattendue. Il garantit uniquement qu'ossfs démarre automatiquement au démarrage.

Démonter un bucket

Pour démonter un bucket, exécutez la commande suivante. Par exemple, pour démonter le système de fichiers monté sur /tmp/ossfs :

umount /tmp/ossfs

FAQ

Pour monter un bucket OSS sur un système Windows, utilisez Cloud Storage Gateway (CSG). Pour plus d'informations, consultez Utiliser une passerelle de fichiers dans la console Alibaba Cloud et Accéder à un répertoire partagé SMB.
Le montage d'un bucket OSS depuis une instance ECS via un endpoint interne n'engendre aucun frais de trafic. Pour plus d'informations sur les frais de trafic, reportez-vous à la rubrique Frais de trafic.
Si votre instance ECS et votre bucket OSS se trouvent dans des régions différentes et que vous devez monter le bucket entre régions, assurez-vous de la connectivité réseau. Vous pouvez utiliser directement un endpoint public pour monter le bucket. Vous pouvez également permettre à une instance ECS d'accéder à un service OSS dans une autre région via un réseau privé.
Si vous devez créer un site web IIS à l'aide de Cloud Storage Gateway et utiliser OSS pour le stockage des données, reportez-vous à la rubrique Créer un site web IIS à l'aide d'Alibaba Cloud Storage Gateway.
Si vous devez monter un bucket OSS sur un système d'exploitation Windows, reportez-vous à la rubrique Rclone.
Pour plus d'informations sur les problèmes liés au montage et aux permissions, reportez-vous à la rubrique FAQ.