Object Storage Service:Mount options for ossfs 2.0

Catégorie

Élément de configuration

Obligatoire

Description

Valeur par défaut

Versions prises en charge

Configuration de base du bucket

oss_endpoint

Oui

L'endpoint permettant d'accéder au bucket.

Aucune

v2.0.0 et versions ultérieures

oss_bucket

Oui

Le nom du bucket.

Aucune

v2.0.0 et versions ultérieures

Configuration des identifiants d'accès

oss_access_key_id

Conditionnellement obligatoire

L'AccessKey ID. Requis pour l'authentification par AccessKey.

Aucune

v2.0.0 et versions ultérieures

oss_access_key_secret

Conditionnellement obligatoire

Le secret AccessKey. Requis pour l'authentification par AccessKey.

Aucune

v2.0.0 et versions ultérieures

ram_role

Conditionnellement obligatoire

Le rôle RAM ECS. Requis pour l'authentification par rôle RAM ECS.

Aucune

v2.0.2 et versions ultérieures

credential_process

Conditionnellement obligatoire

La commande permettant d'exécuter un processus externe pour obtenir des identifiants d'accès.

Requis pour l'authentification par processus externe.

Aucune

v2.0.5 et versions ultérieures

Catégorie

Élément de configuration

Obligatoire

Description

Valeur par défaut

Versions prises en charge

Configuration du bucket

oss_bucket_prefix

Non

Monte un dossier spécifique du bucket.

Vide

v2.0.0 et versions ultérieures

oss_region

Non

L'ID de région du bucket, utilisé pour l'algorithme de signature OSS V4. Le système revient à la version V1 si ce paramètre n'est pas spécifié.

Vide

v2.0.0 et versions ultérieures

Configuration du cache

attr_timeout

Non

La durée de vie (TTL) du cache des métadonnées de fichiers, en secondes.

60

v2.0.0 et versions ultérieures

negative_timeout

Non

La durée de vie (TTL) du cache des entrées de répertoire invalides, en secondes.

0

v2.0.0 et versions ultérieures

readdirplus

Non

Active readdirplus. Génère le cache des métadonnées de fichiers de manière synchrone lors de l'opération readdir, au prix d'une consommation mémoire plus élevée.

true

v2.0.0 et versions ultérieures

disk_data_cache_dir

Non

Le chemin du répertoire de cache local. La définition d'une valeur non vide active la mise en cache des données. Pour plus d'informations, consultez la rubrique Cache de données local.

Vide

v2.0.8 et versions ultérieures

disk_data_cache_size

Conditionnellement obligatoire

La capacité maximale du cache, alignée sur des GiB. Elle ne peut pas dépasser l'espace disponible sur le disque ou la partition où réside le répertoire de cache. disk_data_cache_dir peut rester vide. Si disk_data_cache_dir est spécifié, ce paramètre doit être défini avec une valeur valide.

Vide

v2.0.8 et versions ultérieures

disk_data_cache_io_engine

Non

Le moteur d'E/S pour le cache disque. Valeurs valides : psync et libaio.

psync

v2.0.8 et versions ultérieures

Configuration du mode d'écriture

temp_dir

Non

Le chemin du répertoire temporaire local. Doit être un chemin absolu. La définition d'une valeur non vide active le mode d'écriture aléatoire basé sur un répertoire temporaire local, qui prend en charge la sémantique d'écriture POSIX complète, telle que les écritures à des décalages arbitraires et la troncation à n'importe quelle taille. Laissez ce champ vide pour désactiver cette fonctionnalité. Pour plus d'informations, consultez la rubrique Configurer un répertoire temporaire local pour prendre en charge les écritures aléatoires.

Vide

v2.0.9 et versions ultérieures

temp_dir_free_bytes

Non

L'espace disque libre minimum réservé sur le disque où réside le répertoire temporaire, en octets (prend en charge les unités telles que K, M et G). Lorsque l'espace disque libre descend en dessous de ce seuil, les nouvelles écritures renvoient ENOSPC. Si l'espace disque libre est déjà inférieur à cette valeur lors du montage, le montage échoue. Valeur minimale : 64 MiB.

1 GiB

v2.0.9 et versions ultérieures

random_write_max_file_size

Non

La taille logique maximale d'un seul objet en mode d'écriture aléatoire, en octets (prend en charge les unités telles que K, M et G). Les écritures ou troncations dépassant cette limite renvoient EFBIG. La limite physique supérieure correspond à la capacité de téléchargement multipartie d'OSS (10 000 parties × 5 GiB, soit environ 48,8 TiB).

100 GiB

v2.0.9 et versions ultérieures

Configuration des journaux

log_level

Non

Le niveau de journalisation. Les valeurs valides sont info et debug.

info

v2.0.0 et versions ultérieures

log_dir

Non

Le dossier dans lequel les fichiers journaux sont stockés.

/tmp/ossfs2

v2.0.0 et versions ultérieures

log_file_max_size

Non

La taille maximale d'un fichier journal unique, en octets.

67108864

v2.0.3 et versions ultérieures

log_file_max_count

Non

Le nombre maximal de fichiers journaux à conserver.

8

v2.0.3 et versions ultérieures

Mode d'exécution

f

Non

Exécute ossfs au premier plan.

false

v2.0.0 et versions ultérieures

d

Non

Exécute ossfs au premier plan avec les journaux de débogage FUSE activés.

false

v2.0.0 et versions ultérieures

Mode de montage

ro

Non

Monte le système de fichiers en mode lecture seule.

false

v2.0.0 et versions ultérieures

Configuration des permissions

gid

Non

Définit le GID pour tous les fichiers et répertoires situés sous le point de montage.

Le GID de l'utilisateur qui monte le système de fichiers

v2.0.1 et versions ultérieures

uid

Non

Définit l'UID pour tous les fichiers et répertoires situés sous le point de montage.

L'UID de l'utilisateur qui monte le système de fichiers

v2.0.1 et versions ultérieures

file_mode

Non

Définit le mode de permission pour tous les fichiers situés sous le point de montage.

0777

v2.0.1 et versions ultérieures

dir_mode

Non

Définit le mode de permission pour tous les répertoires situés sous le point de montage.

0777

v2.0.1 et versions ultérieures

allow_other

Non

Permet aux utilisateurs autres que root d'accéder aux fichiers situés sous le point de montage. L'accès est vérifié par les permissions de fichier.

true

v2.0.1 et versions ultérieures

Catégorie

Élément de configuration

Obligatoire

Description

Valeur par défaut

Versions prises en charge

Configuration réseau

bind_ips

Non

Liste d'adresses IP source séparées par des virgules pour l'accès à OSS, par exemple 192.168.0.1,192.168.0.2. Contrôle l'interface réseau utilisée afin d'augmenter le débit dans les environnements multi-cartes.

Vide

v2.0.3 et versions ultérieures

http_proxy

Non

Serveur proxy HTTP utilisé pour transférer les requêtes OSS.

Vide

v2.0.8 et versions ultérieures

path_style

Non

Une fois cette option activée, vous pouvez monter le bucket à l'aide d'un domaine PrivateLink.

false

v2.0.10 et versions ultérieures

enable_ipv6

Non

Indique si l'accès à OSS s'effectue via des adresses IPv6.

true

v2.0.10 et versions ultérieures

Configuration du chargement

upload_buffer_size

Non

Taille du tampon (partie) pour le chargement multipartie, exprimée en octets. La taille maximale de fichier accessible en écriture est upload_buffer_size × 10 000.

8388608

v2.0.0 et versions ultérieures

upload_concurrency

Non

Niveau de simultanéité pour les chargements multiparties.

64

v2.0.0 et versions ultérieures

sync_upload

Non

Attend la fin du chargement avant de rendre la main lors de la fermeture du fichier.

true

v2.0.0 et versions ultérieures

Configuration du téléchargement/préchargement

prefetch_concurrency

Non

Niveau de simultanéité global pour le préchargement des téléchargements.

256

v2.0.0 et versions ultérieures

prefetch_concurrency_per_file

Non

Niveau de simultanéité du préchargement des téléchargements par descripteur de fichier.

64

v2.0.0 et versions ultérieures

prefetch_chunk_size

Non

Taille d'un fragment de préchargement, en octets.

8388608

v2.0.0 et versions ultérieures

prefetch_chunks

Non

Nombre de fragments de préchargement. La valeur par défaut est 3 × prefetch_concurrency. Définissez cette valeur sur -1 pour une mémoire de préchargement illimitée par descripteur de fichier.

0 (configuré automatiquement en fonction de prefetch_concurrency)

v2.0.0 et versions ultérieures

Configuration de la gestion de la mémoire

total_mem_limit

Non

Limite totale de mémoire, en octets. Les niveaux de simultanéité du chargement et du préchargement s'ajustent automatiquement à cette limite.

Sans cette option, le préchargement en lecture utilise un tampon de prefetch_chunk_size prefetch_chunks et les écritures utilisent upload_buffer_size upload_concurrency, allouant jusqu'à ~8 Go au total. Assurez-vous que la mémoire disponible est suffisante pour éviter les erreurs OOM (Out Of Memory).

Par défaut, la moitié de la mémoire système pour les systèmes disposant de 16 Go ou moins. Aucune limite pour les systèmes dotés de plus de 16 Go.

0

v2.0.0 et versions ultérieures

max_inode_cache_count

Non

Contrôle le nombre d'entrées de métadonnées mises en cache.

• 0 (par défaut) : aucun contrôle actif. Le système d'exploitation expulse automatiquement les métadonnées.

• Entier positif : ossfs 2,0 expulse les entrées excédentaires lorsque le nombre d'éléments en cache dépasse cette valeur.

0

v2.0.4 et versions ultérieures

Configuration de la vérification des fichiers/métadonnées

enable_crc64

Non

Active la vérification CRC64 pour les écritures de fichiers.

true

v2.0.0 et versions ultérieures

close_to_open

Non

Active la sémantique close-to-open. Envoie une requête GetObjectMeta à l'ouverture du fichier pour garantir des métadonnées en temps réel.

Désactivé par défaut ; dans ce cas, l'ouverture du fichier vérifie le TTL du cache de métadonnées pour décider s'il faut interroger OSS. L'activation de cette option entraîne systématiquement une interrogation d'OSS à l'ouverture du fichier, ce qui augmente considérablement la latence pour les nombreux petits fichiers.

false

v2.0.0 et versions ultérieures

Configuration des opérations sur les fichiers

rename_dir_limit

Non

Nombre maximal de fichiers et de répertoires descendants dans un dossier source pour une opération de renommage. Le dépassement de cette limite entraîne l'échec du renommage.

2000000

v2.0.0 et versions ultérieures

enable_appendable_object

Non

Utilise l'opération AppendObject pour les écritures de fichiers, permettant la lecture et l'écriture simultanées sur le même fichier.

false

v2.0.0 et versions ultérieures

appendable_object_autoswitch_threshold

Non

Lorsque enable_appendable_object est activé, les objets non ajoutables dont la taille est inférieure ou égale à ce seuil (en octets) sont automatiquement convertis en objets ajoutables lors de l'ajout.

0

v2.0.5 et versions ultérieures

enable_symlink

Non

Active la fonctionnalité de lien symbolique. Les liens symboliques ne peuvent être créés qu'à l'intérieur du point de montage à l'aide de chemins relatifs.

false

v2.0.6 et versions ultérieures

Configuration du délai d'expiration des requêtes

oss_request_timeout_ms

Non

Délai d'expiration des requêtes OSS, en millisecondes.

60000

v2.0.0 et versions ultérieures

Configuration du cache

oss_negative_cache_timeout

Non

TTL des éléments de requête OSS 404 mis en cache, en secondes.

0

v2.0.2 et versions ultérieures

oss_negative_cache_size

Non

Nombre d'éléments de requête OSS 404 mis en cache.

10000

v2.0.2 et versions ultérieures

memory_data_cache_size

Non

Alloue à l'avance un cache de lecture fixe afin de réduire l'amplification du préchargement lors des lectures simultanées. Améliore les performances pour le chargement de modèles multi-GPU.

0

v2.0.5 et versions ultérieures

kernel_readdir_cache_timeout

Non

TTL du cache de répertoire du noyau, en secondes. Nécessite un noyau Linux 4.20 ou version ultérieure.

0

v2.0.7 et versions ultérieures