Object Storage Service:Opciones de montaje

Formato del comando

./ossfs -h

Ejecute este comando desde el directorio que contiene el ejecutable de ossfs (por lo general /usr/local/bin/, aunque puede variar según su instalación).

Opciones comunes

-o option_name[=option_value]  or  -ooption_name[=option_value]

ossfs bucket_name mount_point -ourl=endpoint -ouid=uid -ogid=gid

-ourl=oss-cn-hangzhou.aliyuncs.com
-ourl=http://oss-cn-hangzhou.aliyuncs.com
-ourl=https://oss-cn-hangzhou.aliyuncs.com

# Write the key to the /etc/passwd-ossfs file and set the permissions to 640.
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

# Write the key to the /passwd-path/passwd-ossfs file and set the permissions to 600.
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /passwd-path/passwd-ossfs
chmod 600 /passwd-path/passwd-ossfs

# Define the opasswd_file variable and set its value to /passwd-path/passwd-ossfs.
-opasswd_file=/passwd-path/passwd-ossfs

ossfs bucket_name mount_point -omax_stat_cache_size=0

ossfs bucket_name mount_point -ourl=endpoint -oallow_other

ossfs bucket_name mount_point -odbglevel=info

ossfs bucket_name mount_point -f

ossfs bucket_name mount_point -d

Lista de opciones

En la mayoría de los casos, el formato de las opciones es -ooption_name=option_value o -o option_name=option_value.

• Opciones de ossfs

  Opción	Descripción
  retries	Especifica el número de reintentos después de que falla una solicitud. El valor predeterminado es 2.
  storage_class	Especifica la clase de almacenamiento para los archivos escritos en OSS. Los valores válidos son: Standard (predeterminado): Standard IA: Infrequent Access Archive: Archive Storage Para obtener más información sobre las clases de almacenamiento, consulte Storage classes.
  public_bucket	Especifica si se accede al bucket de forma anónima. Esta opción solo es válida para buckets cuya lista de control de acceso (ACL) es public-read-write. Los valores válidos son: 0 (predeterminado): No acceder al bucket de forma anónima. 1: Acceder al bucket de forma anónima.
  passwd_file	Especifica el archivo que almacena el par de AccessKey del bucket. El archivo predeterminado es /etc/passwd-ossfs.
  connect_timeout	Especifica el tiempo de espera de conexión en segundos. El valor predeterminado es 300 segundos.
  readwrite_timeout	Especifica el tiempo de espera para las solicitudes de lectura o escritura en segundos. El valor predeterminado es 120 segundos.
  max_stat_cache_size	Especifica la cantidad de entradas de metadatos de archivos que se almacenarán en la caché. El valor predeterminado es 100,000, lo que consume aproximadamente 40 MB de espacio adicional.
  readdir_optimize	Cuando se habilita, esta opción optimiza el rendimiento del comando ls al evitar las solicitudes HeadObject para los metadatos de los archivos. Las llamadas a HeadObject solo se realizan si el tamaño de un archivo es 0. Tenga en cuenta que algunas solicitudes HeadObject podrían generarse por otros motivos, como comprobaciones de permisos. Seleccione este parámetro según las características de su aplicación. Para habilitar esta función, agregue -oreaddir_optimize al montar el bucket.
  stat_cache_expire	Especifica el tiempo de expiración de la caché de metadatos de archivos en segundos. El valor predeterminado es 900 segundos.
  no_check_certificate	Deshabilita la verificación del certificado del servidor. Esta opción solo es válida cuando se utiliza el protocolo HTTPS. De forma predeterminada, la verificación de certificados está habilitada. Esta opción no recibe ningún valor. Para usarla, simplemente agregue la opción -ono_check_certificate.
  multireq_max	Especifica el número máximo de solicitudes simultáneas para acceder a los metadatos de los archivos al listarlos. El valor predeterminado es 20.
  parallel_count	Especifica el número de partes concurrentes al cargar un archivo grande en modo multipart upload. El valor predeterminado es 5.
  multipart_size	Especifica el tamaño de cada parte en MB para las cargas multiparte. El valor predeterminado es 10. Este parámetro afecta el tamaño máximo de archivo admitido. El número máximo de partes para una carga multiparte es 10,000. Con el valor predeterminado, el tamaño máximo de archivo admitido es 100 GB. Para admitir archivos más grandes, ajuste este valor según sea necesario.
  url	Especifica el endpoint del bucket.
  umask	Establece la máscara de permisos para los archivos y carpetas del destino de montaje. Por ejemplo, para establecer los permisos de los archivos y carpetas del destino de montaje en 770, agregue -oumask=007. Para establecer los permisos en 700, agregue -oumask=077. Nota Versión 1.91.*: El permiso predeterminado para los archivos es 0640 y para las carpetas es 0750. Versión 1.80.*: El permiso predeterminado tanto para archivos como para carpetas es 0777.
  enable_content_md5	Especifica si se establece CONTENT_MD5 durante una operación de carga. De forma predeterminada, no se establece. Para configurar Content-MD5, agregue la opción -oenable_content_md5.
  ram_role	Utiliza un rol de RAM para acceder a OSS. Cuando se usa este método de acceso, se ignoran el AccessKey ID y el AccessKey secret del archivo de claves.
  listobjectsv2	Si el versionado está habilitado para el bucket, utilice la opción -olistobjectsv2 para listar los archivos.
  notsup_compat_dir	Restringe los tipos de directorios incompatibles. De forma predeterminada, ossfs reconoce dir/, dir y dir_$folder$ como directorios. Si desea restringir ossfs para que reconozca únicamente dir/ como directorio y así reducir las interacciones entre ossfs y el servidor, utilice la opción -onotsup_compat_dir.
  direct_read	Habilita la lectura de datos directamente desde OSS sin almacenarlos en la caché del disco local. De forma predeterminada, ossfs utiliza un directorio temporal local. Para habilitar este modo, use -odirect_read. Nota Si se detecta una operación de escritura, cambio de nombre o truncamiento en un archivo durante una lectura directa, el archivo sale del modo de lectura directa hasta que se vuelve a abrir.
  direct_read_chunk_size	En el modo de lectura directa, especifica la cantidad de datos que se leerán de OSS en una sola solicitud de lectura. La unidad es MB. El valor predeterminado es 4. El rango de valores va de 1 a 32. Esta opción solo aplica cuando -odirect_read está habilitado.
  direct_read_prefetch_thread	En el modo de lectura directa, ossfs realiza prelecturas como tareas asíncronas en segundo plano. Esta opción especifica el número máximo de hilos para las solicitudes de prelectura simultáneas. El valor predeterminado es 64. Esta opción solo aplica cuando -odirect_read está habilitado.
  direct_read_prefetch_chunks	En el modo de lectura directa, especifica la cantidad de fragmentos que se preleerán en la memoria. Esto mejora el rendimiento de ossfs en escenarios de lectura secuencial. El valor predeterminado es 32. Esta opción solo aplica cuando -odirect_read está habilitado.
  direct_read_prefetch_limit	En el modo de lectura directa, ossfs utiliza la memoria para almacenar en caché los datos preleídos de OSS. Esta opción limita la cantidad total de datos que ossfs puede preleer. La unidad es MB. El valor predeterminado es 1024. Esta opción solo aplica cuando -odirect_read está habilitado.
  dbglevel	Establece el nivel de registro. Los niveles de registro admitidos son a continuación: critical (predeterminado) error warn info debug
  curldbg	Habilita el registro de libcurl. De forma predeterminada, está deshabilitado. Para mostrar los registros de libcurl, agregue la opción -ocurldbg.

• Opciones de caché de datos

  Nota

  Para obtener más información sobre los principios de la caché de datos, consulte Data caching.

  Opción	Descripción
  use_cache	Habilita la caché de datos y especifica su ruta. De forma predeterminada, esta función está deshabilitada. Especifique esta opción para configurar la ruta de la caché. Por ejemplo, agregue -ouse_cache=path durante el montaje para habilitar la caché de datos y establecer su ruta en path. Sustituya path por la ruta real, como /tmp/your_foldername.
  ensure_diskfree	Controla la cantidad de espacio en disco reservado. De forma predeterminada, no se reserva espacio. Utilice esta opción para establecer la cantidad de espacio libre en disco que se debe reservar, en MB. Esto evita que el disco se llene y afecte a otras aplicaciones. Por ejemplo, para asegurar que haya como mínimo 1024 MB de espacio libre en el disco, agregue -oensure_diskfree=1024 durante el montaje.
  del_cache	Controla la eliminación de la caché local. De forma predeterminada, la caché no se elimina. Configure esta opción para que ossfs borre la caché de datos local. Por ejemplo, si agrega la opción -odel_cache, ossfs borrará los archivos de caché de la carpeta especificada por use_cache durante las operaciones de montaje y desmontaje.
  max_dirty_data	Cuando el tamaño de un archivo en proceso de escritura supera este valor, el archivo temporal intermedio se carga antes de cerrar el archivo. El valor predeterminado es 5120 MB. Por ejemplo, para cargar un archivo cuando su tamaño supere los 2000 MB, agregue -omax_dirty_data=2000 durante el montaje. Si habilita el versionado en OSS, escribir un archivo grande podría generar archivos intermedios para varias versiones. Establezca esta opción en un valor alto.
  tmpdir	De forma predeterminada, los datos se almacenan temporalmente en la caché del directorio /tmp del disco del sistema. Especifique esta opción para configurar la ruta predeterminada de la caché temporal. Esta opción no se puede usar junto con la opción use_cache. Por ejemplo, agregue -otmpdir=path durante el montaje para establecer la ruta predeterminada de la caché temporal de datos en path. Sustituya path por la ruta real, como /data/your_foldername.
  free_space_ratio	Controla el porcentaje mínimo de espacio libre en disco que se debe mantener después del almacenamiento en caché. Por ejemplo, si el espacio en disco es de 50 GB y configura esta opción como -ofree_space_ratio=20, se reservarán 10 GB de espacio (50 GB × 20%).
  disable_noobj_cache	Esta opción se agregó en ossfs 1.91.6. Deshabilita o habilita el almacenamiento en caché de metadatos noobj. Si está habilitado, la información se almacena en caché incluso si el archivo no existe. El valor predeterminado es false (habilitado). Por ejemplo, agregue -o disable_noobj_cache durante el montaje para deshabilitar el almacenamiento en caché de metadatos noobj. En ossfs 1.91.6 y versiones posteriores, la caché noobj se utiliza de forma predeterminada. Para deshabilitarla, agregue esta opción.

• Opciones de FUSE

  Opción	Descripción
  allow_other	Modifica los permisos del destino de montaje para permitir que todos los usuarios accedan al directorio montado. Esto no incluye los archivos dentro del directorio. Establezca los permisos de dichos archivos por separado. Para modificar los permisos de un archivo específico, utilice el comando chmod. Para establecer los mismos permisos en todos los archivos, configure la opción umask. De forma predeterminada, solo el usuario root puede establecer la opción -oallow_other. La opción no recibe ningún valor. Para usarla, simplemente agregue la opción -oallow_other.
  uid	Especifica el identificador de usuario (UID) del propietario de la carpeta.
  gid	Especifica el identificador de grupo (GID) del propietario de la carpeta.