Object Storage Service:Options de montage pour 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

Endpoint d'accès au bucket.

Aucune

v2.0.0 et versions ultérieures

oss_bucket

Oui

Nom du bucket.

Aucune

v2.0.0 et versions ultérieures

Configuration des identifiants d'accès

oss_access_key_id

Conditionnellement obligatoire

AccessKey ID. Requis pour l'authentification par AccessKey.

Aucune

v2.0.0 et versions ultérieures

oss_access_key_secret

Conditionnellement obligatoire

Secret AccessKey. Requis pour l'authentification par AccessKey.

Aucune

v2.0.0 et versions ultérieures

ram_role

Conditionnellement obligatoire

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

Commande exécutant 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

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

Durée de vie (TTL) du cache des métadonnées de fichier, en secondes.

60

v2.0.0 et versions ultérieures

negative_timeout

Non

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 l'option readdirplus. Construit le cache des métadonnées de fichier de manière synchrone lors de l'opération readdir, au prix d'une utilisation mémoire plus élevée.

true

v2.0.0 et versions ultérieures

disk_data_cache_dir

Non

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 Cache de données local.

Vide

v2.0.8 et versions ultérieures

disk_data_cache_size

Conditionnellement obligatoire

Capacité maximale du cache, alignée sur les GiB. Elle ne peut pas dépasser l'espace disponible du disque ou de 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 sur une valeur valide.

Vide

v2.0.8 et versions ultérieures

disk_data_cache_io_engine

Non

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

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 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

Espace disque libre minimal 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

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

Niveau de journalisation. Les valeurs valides sont info et debug.

info

v2.0.0 et versions ultérieures

log_dir

Non

Dossier de stockage des fichiers journaux.

/tmp/ossfs2

v2.0.0 et versions ultérieures

log_file_max_size

Non

Taille maximale d'un seul fichier journal, en octets.

67108864

v2.0.3 et versions ultérieures

log_file_max_count

Non

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 sous le point de montage.

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 sous le point de montage.

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 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 sous le point de montage.

0777

v2.0.1 et versions ultérieures

allow_other

Non

Permet aux utilisateurs non root d'accéder aux fichiers 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 séparée par des virgules des adresses IP source pour l'accès OSS, par exemple 192.168.0.1,192.168.0.2. Contrôle l'interface réseau utilisée pour augmenter le débit dans les environnements multi-cartes réseau.

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

Configuration du téléchargement

upload_buffer_size

Non

Taille du tampon (partie) de téléchargement multipartie 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

Concurrence pour les téléchargements multiparties.

64

v2.0.0 et versions ultérieures

sync_upload

Non

Attend la fin du téléchargement avant de retourner le résultat à la fermeture du fichier.

true

v2.0.0 et versions ultérieures

Configuration du téléchargement/préchargement

prefetch_concurrency

Non

Concurrence globale pour le préchargement des téléchargements.

256

v2.0.0 et versions ultérieures

prefetch_concurrency_per_file

Non

Concurrence pour le 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-la 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. La concurrence de téléchargement et de préchargement s'ajuste 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 d'avoir suffisamment de mémoire 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 disposant 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 de caches dépasse cette valeur.

0

v2.0.4 et versions ultérieures

Vérification des fichiers/Configuration des 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 de fichier vérifie la durée de vie (TTL) du cache de métadonnées pour décider s'il faut interroger OSS. L'activation de cette option interroge toujours OSS à l'ouverture du fichier, ce qui augmente considérablement la latence pour de 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 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 concurrentes 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 inférieurs ou égaux à cette taille (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 en utilisant des 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

Durée de vie (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

Pré-alloue un cache de lecture fixe pour réduire l'amplification du préchargement lors des lectures concurrentes. 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

Durée de vie (TTL) du cache de répertoire du noyau, en secondes. Nécessite le noyau Linux 4.20 ou une version ultérieure.

0

v2.0.7 et versions ultérieures