Common configuration examples for ossfs 2.0 - Object Storage Service

Para montar un bucket de Object Storage Service (OSS), necesita un archivo de configuración específico para su escenario. Haga referencia a este archivo cuando monte el bucket.

Crear un archivo de configuración

Importante

Cada archivo de configuración solo permite montar un bucket. Para montar varios buckets, debe crear un archivo de configuración independiente para cada uno. Puede personalizar los nombres y las rutas de los archivos.

Puede usar cualquier nombre y ruta para el archivo de configuración de ossfs 2.0. Por ejemplo, cree un archivo llamado /etc/ossfs2.conf.

sudo touch /etc/ossfs2.conf

Configurar las credenciales de acceso

Par de AccessKey

Para ossfs 2.0.1 y versiones posteriores, utilice variables de entorno para configurar el AccessKey pair de un usuario de Resource Access Management (RAM) y así montar un bucket de OSS. Este método es más seguro y práctico. Las credenciales configuradas mediante variables de entorno no necesitan especificarse nuevamente en el archivo de configuración.

Variables de entorno

export OSS_ACCESS_KEY_ID=LTAI******************
export OSS_ACCESS_KEY_SECRET=8CE4**********************

Archivo de configuración

--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
--oss_bucket=bucketName
--oss_access_key_id=AAAI************
--oss_access_key_secret=AAA8x*************************

Rol RAM de instancia

Con ossfs 2.0.2 y versiones posteriores, puede configurar las credenciales de acceso mediante un instance RAM role en el archivo de configuración.

--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
--oss_bucket=bucketName
--ram_role=EcsRamRoleOssTest

Proceso externo

ossfs 2.0.5 y versiones posteriores admiten el uso de un comando para iniciar un proceso externo independiente. Este proceso devuelve su resultado a ossfs a través de la salida estándar.

Importante

Para evitar riesgos de seguridad, asegúrese de que el comando utilizado para generar credenciales no sea accesible para procesos o usuarios no autorizados.
Asegúrese de que el comando que genera las credenciales no escriba información sensible en stderr, ya que esto podría exponer la información a usuarios no autorizados mediante captura o registro.

Credenciales a largo plazo

{
  "AccessKeyId" : "ak",
  "AccessKeySecret" : "sk"
}

Credenciales temporales

{
  "AccessKeyId" : "ak",
  "AccessKeySecret" : "sk",
  "Expiration" : "2025-12-29T07:45:02Z",
  "SecurityToken" : "token"
}

El campo Expiration especifica la hora UTC en formato ISO 8601.

Utilice el siguiente formato para configurar un proceso externo:

--credential_process=user-cmd

Establezca use-cmd según su caso de uso. Los requisitos de configuración son los siguientes:

Si un parámetro o nombre de archivo contiene espacios, encierre la cadena correspondiente entre comillas dobles ("").
Especifique la ruta completa al ejecutable, como /bin/bash, /bin/echo o /bin/curl.
No incluya variables de entorno en el comando, como $HOME.

A continuación se presentan ejemplos comunes:

Para obtener credenciales de un archivo temporal como /etc/creds.txt, utilice la siguiente configuración: --credential_process=/bin/cat /etc/creds.txt.
Para recuperar credenciales de acceso de un servicio personalizado, utilice la siguiente configuración: --credential_process=/bin/curl <custom_service_endpoint>.

Importante

ossfs solo valida que los parámetros tengan un formato JSON válido e incluyan los campos obligatorios. Asegúrese de que el comando que configure genere credenciales de acceso completas y válidas. Por ejemplo, si utiliza un archivo temporal, garantice que las actualizaciones del archivo sean atómicas o emplee mecanismos como flock para aplicar exclusión mutua en las operaciones de lectura y escritura.

Formato del archivo de configuración

Formato

El prefijo -- indica una opción de montaje. <option> es el nombre de la opción y value en [=<value>] es su valor correspondiente. Los corchetes [] indican que el valor es opcional.

--<option>[=<value>]

Ejemplo

# Endpoint of the region where the bucket is located
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# bucket name
--oss_bucket=bucketName
# AccessKey ID and AccessKey secret. (Optional) For ossfs 2.0.1 and later, you can configure access credentials by using environment variables instead of setting them in the configuration file.
--oss_access_key_id=AAAI************
--oss_access_key_secret=AAA8x*************************

Ejemplos de configuración

Nota

Para consultar el endpoint de un bucket, vaya a la página de Buckets, seleccione el bucket deseado y luego haga clic en Overview en el panel de navegación izquierdo. El endpoint se muestra en la sección Port. Los siguientes ejemplos utilizan un bucket en la región China (Hangzhou).

Los endpoints para un bucket en la región China (Hangzhou) son los siguientes: el endpoint público es oss-cn-hangzhou.aliyuncs.com. El endpoint interno para acceder desde una instancia de Elastic Compute Service (ECS) en la red clásica o en una Virtual Private Cloud (VPC) es oss-cn-hangzhou-internal.aliyuncs.com. El endpoint de aceleración de transferencia para cargas y descargas globales es oss-accelerate.aliyuncs.com. El endpoint del acelerador de OSS es cn-hangzhou-internal.oss-data-acc.aliyuncs.com. Todos los endpoints admiten HTTPS.

Abra el archivo de configuración de ossfs 2.0 que creó y configúrelo según los siguientes ejemplos. Todos los ejemplos utilizan un endpoint interno en la región China (Hangzhou). Solo puede usar endpoints internos y endpoints del acelerador de OSS para montar un bucket desde una instancia en una Virtual Private Cloud (VPC) dentro de la misma región. Estos endpoints proporcionan transferencias de datos más rápidas y estables. No se recomienda utilizar ossfs con un endpoint público, ya que la alta latencia y las conexiones a internet inestables pueden causar problemas de rendimiento.

Montar un bucket completo

Monte todos los directorios y archivos de un bucket en un directorio local.

# Endpoint of the region where the bucket is located
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# bucket name
--oss_bucket=bucketName
# AccessKey ID and AccessKey secret (optional for ossfs 2.0.1 and later)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

Montar un directorio específico

Cuando monte un bucket, puede montar únicamente un directorio específico del bucket en un directorio local.

# Endpoint of the region where the bucket is located
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# bucket name
--oss_bucket=bucketName
# Path of the directory in the OSS bucket (optional)
--oss_bucket_prefix=folder-test/folder-prefix/
# AccessKey ID and AccessKey secret (optional for ossfs 2.0.1 and later)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

Montar con un límite de memoria

Al montar un bucket, puede asignar una cantidad específica de memoria al proceso de ossfs 2.0.

Importante

De forma predeterminada, ossfs 2.0 está optimizado para el rendimiento y utiliza hasta aproximadamente 8 GB de memoria para lecturas y escrituras de datos. Si sus recursos de memoria son limitados, configure la opción total_mem_limit para evitar problemas de falta de memoria (OOM).

# Endpoint of the region where the bucket is located
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# bucket name
--oss_bucket=bucketName
# Memory limit in bytes (optional)
--total_mem_limit=4294967296
# AccessKey ID and AccessKey secret (optional for ossfs 2.0.1 and later)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

Montar con registros de depuración

Establezca el nivel de registro en debug y especifique una ruta personalizada para almacenar los registros.

# Endpoint of the region where the bucket is located
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# bucket name
--oss_bucket=bucketName
# Directory to store logs (optional). Ensure the /tmp/log directory exists.
--log_dir=/tmp/log/ossfs2
# Log level (optional)
--log_level=debug
# AccessKey ID and AccessKey secret (optional for ossfs 2.0.1 and later)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

Montar con permisos de acceso

Importante

De forma predeterminada, ossfs 2.0 permite que todos los usuarios lean y escriban todos los archivos. Si requiere permisos más estrictos, utilice las siguientes configuraciones. Estos ejemplos aplican únicamente a ossfs 2.0.1 y versiones posteriores.

Monte todos los directorios del bucket en un directorio local y deniegue el acceso de lectura y escritura a los usuarios que no sean root.

# Endpoint of the region where the bucket is located
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# bucket name
--oss_bucket=bucketName
# Deny access to users other than the mounting user
--allow_other=false
# Global directory permissions
--dir_mode=0755
# Global file permissions
--file_mode=0644
# AccessKey ID and AccessKey secret (optional for ossfs 2.0.1 and later)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

Monte todos los directorios del bucket, otorgando permisos de lectura y escritura a un usuario específico (definido por uid y gid) y permisos de solo lectura a los demás.

# Endpoint of the region where the bucket is located
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# bucket name
--oss_bucket=bucketName
# Global directory permissions
--dir_mode=0755
# Global file permissions
--file_mode=0644
# Specific user UID and GID (use the id command to get the user's UID and GID)
--uid=1000
--gid=1000
# AccessKey ID and AccessKey secret (optional for ossfs 2.0.1 and later)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

Siguientes pasos

Después de instalar y configurar ossfs 2.0, puede montar un bucket en su sistema Linux. Para obtener más información, consulte Mount a bucket.

Temas relacionados

Para obtener más información sobre las opciones de montaje de ossfs 2.0, consulte Mount options.