Archivo de configuración de Cloud Storage FUSE

En esta página, se describe cómo usar un archivo de configuración de Cloud Storage FUSE para configurar el comportamiento de Cloud Storage FUSE de forma persistente. Para usar el archivo de configuración, especifica la ruta al archivo de configuración en la marca --config-file como parte de tu comando de activación.

El archivo de configuración es un archivo YAML que usa el formato y los campos siguientes. Algunos de los campos también se pueden especificar usando las opciones de la línea de comandos.

write:
  create-empty-file: boolean
logging:
  file-path: "string"
  format: enum
  severity: enum
  log-rotate:
    max-file-size-mb: integer
    backup-file-count: integer
    compress: boolean
file-cache:
  max-size-mb: integer
  cache-file-for-range-read: boolean
metadata-cache:
  stat-cache-max-size-mb: integer
  ttl-secs: integer
  type-cache-max-size-mb: integer
cache-dir: integer

Campos de configuración

En la siguiente tabla, se describen los campos que puedes especificar en tu archivo de configuración. Nota: A menos que se indique lo contrario, todos los campos son opcionales.

Campo	Descripción
create-empty-file	Un valor booleano que especifica si se debe crear o no un archivo de cero bytes en Cloud Storage cuando comienzas a escribir en un archivo nuevo del bucket activado. Si no se especifica este campo, el valor predeterminado es false.
file-path	La ruta de acceso al archivo de registro en el que se escribirán los registros, especificados como una cadena. Por ejemplo, /var/log. Si no se especifica este campo, los registros se enrutan a stdout cuando Cloud Storage FUSE se ejecuta en modo de primer plano y a syslog cuando Cloud Storage FUSE se ejecuta en modo en segundo plano.
format	El formato en el que se generan los registros, expresados como una enumeración. Los valores son text o json. Si no se especifica este campo, el valor predeterminado es json.
severity	La gravedad de los registros que deseas que Cloud Storage FUSE genere, expresado como una enumeración. Los niveles de gravedad se ordenan desde la gravedad más baja a la más alta: trace debug info warning error Cuando especificas un nivel de gravedad, Cloud Storage FUSE genera registros con una gravedad igual o superior. Por ejemplo, cuando especificas warning, Cloud Storage FUSE genera registros para advertencias y errores. También puedes especificar off para desactivar todo el registro. Si alguna de las tres opciones siguientes se especifica como parte de tu comando, el nivel de gravedad se establece de forma automática en trace: --debug_fuse --debug_gcs --debug_mutex Si no se especifica este campo, el valor predeterminado es info.
max-file-size-mb	El tamaño máximo en megabytes (MB) que pueden alcanzar los archivos de registro antes de que se roten. El valor mínimo es 1. Si no se especifica este campo, el valor predeterminado es 512.
backup-file-count	La cantidad máxima de archivos de registro rotados que se conservarán, sin incluir el archivo activo en el que se escriben. Cuando el valor se establece en 0, se conservan todos los archivos de registro rotados. Si no se especifica este campo, el valor predeterminado es 10.
compress	U valor booleano que especifica si los archivos de registro rotados se comprimen con gzip. Si no se especifica este campo, el valor predeterminado es true.
max-size-mb	El tamaño máximo en MiB que puede usar la caché de archivos. Si está presente, max-size-mb habilita el almacenamiento en caché de archivos en Cloud Storage FUSE y es útil si deseas limitar la capacidad total que la caché de Cloud Storage FUSE puede usar dentro de su directorio activado. Especifica -1 para usar toda la capacidad disponible de la caché en el directorio que especificas para cache-dir. Especifica 0 para inhabilitar la caché del archivo. Si no se especifica este campo, el valor predeterminado es -1.
cache-file-for-range-read	Un valor booleano que determina si el objeto completo debe descargarse de forma asíncrona y almacenarse en el directorio de caché de Cloud Storage FUSE cuando la primera lectura se realiza desde una compensación distinta de cero. Esto debe configurarse como true si planeas realizar varias lecturas aleatorias o parciales. Si no se especifica este campo, el valor predeterminado es false. Ten en cuenta que si realizas una lectura parcial que comienza en el desplazamiento 0, Cloud Storage FUSE siempre descarga y almacena en caché el objeto completo de forma asíncrona.
stat-cache-max-size-mb	El tamaño máximo en MiB que puede usar la caché de estadísticas. La caché de estadística siempre se mantiene por completo en la memoria. Especifica 32 si tu carga de trabajo involucra hasta 20,000 archivos. Si tu carga de trabajo supera los 20,000 archivos, aumenta el tamaño en valores de 10 por cada 6,000 archivos adicionales, un promedio de alrededor de 1,500 bytes por archivo. Especifica -1 para permitir que la caché de estadísticas use tanta memoria como sea necesario. Especifica 0 para inhabilitar la caché de estadísticas. Si no se especifica este campo, el valor predeterminado es 32.
ttl-secs	Define el tiempo de actividad (TTL) de las entradas de metadatos almacenadas en caché, expresado en segundos. Especifica -1 para omitir un vencimiento de TTL y entregar el archivo desde la caché cuando esté disponible. Especifica 0 para asegurarte de que se lea el archivo más actualizado. El uso de este valor de emite una llamada de metadatos de Get para garantizar que la generación de objetos del archivo en la caché coincida con lo que se almacena en Cloud Storage. Para obtener más información, consulta Configura la invalidación de caché. Si no se especifica este campo, el valor predeterminado es 60.
type-cache-max-size-mb	El tamaño máximo en MiB por directorio que puede usar el tipo de caché. La caché de tipo siempre se mantiene por completo en la memoria. Especifica 4 si la cantidad máxima de archivos dentro de un solo directorio del bucket que activas contiene 20,000 archivos o menos. Si la cantidad máxima de archivos dentro de un solo directorio que activas contiene más de 20,000 archivos, aumenta el valor en 1 por cada 5,000 archivos, un promedio de 200 bytes por archivo. Especifica -1 para permitir que el tipo de caché use tanta memoria como sea necesario. Especifica 0 para inhabilitar el tipo de caché. Si no se especifica este campo, el valor predeterminado es 4.
cache-dir	Especifica el directorio para almacenar datos de caché de archivos. Este campo se debe especificar para habilitar el almacenamiento en caché de archivos.