Utilidad OCIFS

OCIFS tiene que tener en cuenta varias restricciones de montaje antes de montar un cubo de Object Storage.

Revise las siguientes reglas y restricciones de montaje:

• Tipos de archivo, atributos y tamaño

• Reglas de Nombre

• Sincronización de Datos

Especifique y configure el método de autenticación basado en claves de API para montar cubos de Object Storage con OCIFS.

La autenticación basada en claves de API es el método de autenticación por defecto para OCIFS y se puede utilizar desde una instancia informática de OCI o desde cualquier otro sistema. Este método de autenticación requiere un SDK de OCI local y un archivo de configuración de la CLI. Puede especificar el archivo de configuración mediante la opción config=file con el comando ocifs. Por defecto, el archivo de configuración es ~/.oci/config.

$ ocifs --auth=api_key --config=~/my_config bucket-1 mydir

Antes de montar un cubo de Object Storage mediante el método de autenticación basada en claves de API, asegúrese de que el archivo de configuración de la CLI (~/.oci/config) tenga un perfil [DEFAULT] y las entradas especificadas en la siguiente tabla.

Para obtener más información, consulte Archivo de configuración de SDK y CLI.

En lugar del método de autenticación basado en claves de API por defecto, puede utilizar el método de autenticación de principal de instancia con la utilidad OCIFS.

Utilice el método de autenticación de principal de instancia para OCIFS solo desde una instancia autorizada de Oracle Cloud Infrastructure. Este método de autenticación permite que las instancias especificadas accedan a Object Storage sin un archivo de configuración de la CLI. A continuación, la instancia detecta automáticamente la información para autenticarse.

La autenticación de principal de instancia se debe utilizar para montar un cubo de Object Storage en una instancia informática que se haya configurado como principal de instancia.

Por ejemplo, para montar un cubo de Object Storage, bucket-1, en el directorio mydir mediante la autenticación de principal de instancia:

$ ocifs --auth=instance_principal bucket-1 mydir

Para utilizar la autenticación de principal de instancia, una instancia informática debe formar parte de un grupo dinámico y una política debe permitir que el grupo dinámico gestione Object Storage. Puede utilizar el verbo manage object-family y el tipo de recurso para definir una política que permita la gestión de objetos de Object Storage. Para obtener más información sobre los grupos dinámicos, consulte Gestión de grupos dinámicos.

Por ejemplo, para permitir que una instancia informática (con el ID de instancia ocid1.instance.OCID) utilice la autenticación de principal de instancia:

1. Cree un grupo dinámico dgroup-ocifs con la siguiente regla que coincida con la instancia informática:

   All {instance.id = 'ocid1.instance.OCID'}

2. Cree una política que permita a ese grupo dinámico, dgroup-ocifs, gestionar Object Storage:

   Allow dynamic-group dgroup-ocifs to manage object-family in compartment id ocid1.tenancy.tenancy_ID

Para obtener más información, consulte Llamada a servicios desde una instancia.

En lugar del método de autenticación basado en claves de API por defecto, puede utilizar el método de autenticación de entidad de recurso con OCIFS.

Utilice el método de autenticación de entidad de recurso con OCIFS solo desde una función de Oracle Cloud Infrastructure (OCI) autorizada. Este método de autenticación permite que la función especificada acceda a otro recurso, o almacenamiento de objetos, sin un archivo de configuración de la CLI. A continuación, la función OCI detecta automáticamente la información para autenticarse.

Para utilizar la autenticación de recursos, una función de OCI debe formar parte de un grupo dinámico y una política debe permitir que el grupo dinámico acceda a ese recurso u Object Storage. Para obtener más información sobre los grupos dinámicos, consulte Gestión de grupos dinámicos.

Para obtener información sobre las funciones de OCI que acceden a otros recursos de OCI, consulte Acceso a otros recursos de Oracle Cloud Infrastructure.

Para utilizar el método de autenticación de recursos con OCIFS, introduzca --auth=resource_principal al montar un cubo con el comando ocifs.

Por ejemplo, para montar un cubo de Object Storage, bucket-1, en el directorio mydir mediante la autenticación de entidad de recurso:

$ ocifs --auth=resource_principal bucket-1 mydir

Puede cambiar el directorio de caché de OCIFS con la opción cache=path del comando ocifs.

Por defecto, OCIFS almacena en caché objetos en ~/.ocifs/. Puede cambiar este directorio de caché mediante la opción cache=path. Esta opción establece el directorio de caché en la ruta especificada. La ruta de acceso puede ser una ruta de acceso absoluta o relativa al directorio de inicio del usuario.

$ ocifs --cache=/var/tmp/ocifs-cache bucket-1 mydir

Puede conservar la caché de OCIFS con la opción cache-keep del comando ocifs, incluso si se desmonta el sistema de archivos de OCIFS.

Al desmontar el sistema de archivos OCIFS, se elimina el directorio de caché de OCIFS, a menos que monte el sistema de archivos con la opción cache-keep.

Por ejemplo, para montar un cubo de Object Storage, bucket-1, en el directorio mydir, y conservar la caché después del desmontaje:

$ ocifs --cache-keep bucket-1 mydir

Notas:

• Si utiliza la opción cache-keep, es posible que no pueda volver a montar el sistema de archivos a menos que utilice la opción cache-reuse.
• Mantener los datos en la caché después de desmontar el sistema de archivos puede mejorar el rendimiento la próxima vez que monte el sistema de archivos. Sin embargo, OCIFS no comprueba si hay discrepancias entre los datos de la caché y los datos reales en el cubo de Object Storage.

La opción cache-purge de la utilidad OCIFS permite eliminar datos de la caché de OCIFS para los archivos que se han cerrado durante un período de tiempo especificado.

Por defecto, la caché de OCIFS nunca se depura. Los datos de caché se mantienen en el directorio de caché siempre que se monte el sistema de archivos. El directorio de caché solo se elimina cuando se desmonta el sistema de archivos OCIFS.

Con la opción cache-purge, puede especificar la cantidad de tiempo que los datos permanecen en la caché después de cerrar un archivo. Puede utilizar esto para conservar el espacio en disco, especialmente si no se suele acceder a los archivos. Esto es útil, por ejemplo, si escribe nuevos archivos y no vuelve a acceder a los archivos.

El retraso de depuración de caché de OCIFS se puede especificar como se muestra en la siguiente tabla:

La opción cache-reuse de la utilidad OCIFS permite montar un sistema de archivos OCIFS, incluso si hay un directorio de caché existente que no esté vacío.

Por defecto, OCIFS evita el montaje de un sistema de archivos si tiene un directorio de caché no vacío. Con la opción cache-reuse, puede volver a montar el sistema de archivos y volver a utilizar el directorio de caché existente, si está presente.

Por ejemplo, para montar el cubo de Object Storage, bucket-1, en el directorio mydir y volver a utilizar el directorio de caché existente:

$ ocifs --cache-reuse bucket-1 mydir

Notas:

• Puede tener un directorio de caché que no esté vacío si el sistema de archivos se ha montado previamente con la opción cache-keep o si el proceso ocifs se ha detenido o se ha bloqueado.
• La reutilización de una caché existente puede mejorar el rendimiento, ya que la utilidad OCIFS puede acceder a los datos que ya están en la caché más rápidamente. Sin embargo, no se recomienda utilizar la opción cache-reuse porque OCIFS no comprueba las discrepancias entre los datos de la caché y los datos reales del cubo de Object Storage.

OCIFS permite determinar cuándo utiliza la carga de varios archivos para cargar archivos de gran tamaño en Object Storage. Con la opción mpu-threshold=size de OCIFS, puede especificar el tamaño de archivo por encima del cual se inicia la carga en varias partes.

El valor del umbral de tamaño de carga de varias partes por defecto es 100 Mebibytes (recomendado).

En la siguiente tabla, se muestran los valores de opción mpu-threshold=size admitidos.