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: CREATE_EMPTY_FILE logging: file-path: "FILE_PATH" format: FORMAT severity: SEVERITY log-rotate: max-file-size-mb: MAX_FILE_SIZE backup-file-count: BACKUP_FILE_COUNT compress: COMPRESS file-cache: max-size-mb: MAX_SIZE cache-file-for-range-read: CACHE_FILE_FOR_RANGE_READ enable-parallel-downloads: ENABLE_PARALLEL_DOWNLOADS parallel-downloads-per-file: PARALLEL_DOWNLOADS_PER_FILE max-parallel-downloads: MAX_PARALLEL_DOWNLOADS download-chunk-size-mb: DOWNLOAD_CHUNK_SIZE metadata-cache: stat-cache-max-size-mb: STAT_CACHE_MAX_SIZE ttl-secs: TTL_SECS type-cache-max-size-mb: TYPE_CACHE_MAX_SIZE cache-dir: "CACHE_DIR" gcs-auth: anonymous-access: ANONYMOUS_ACCESS file-system: kernel-list-cache-ttl-secs: KERNEL_LIST_CACHE_TTL_SECS ignore-interrupts: IGNORE_INTERRUPTS
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:
Cuando especificas un nivel de gravedad, Cloud Storage FUSE genera registros con una gravedad igual o superior. Por ejemplo, cuando especificas
Si no se especifica este campo, el valor predeterminado es |
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,
Si no se especifica este campo, el valor predeterminado es |
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 Ten en cuenta que si realizas una lectura parcial que comienza en el desplazamiento |
enable-parallel-downloads |
Acelera las lecturas de archivos grandes con el directorio de caché de archivos como un búfer de carga previa mediante el uso de varios trabajadores para descargar archivos grandes en paralelo. El valor predeterminado es Para usar descargas en paralelo, debes habilitar el almacenamiento en caché de archivos. Para obtener más información sobre las descargas en paralelo y configurar sus propiedades compatibles, consulta Cómo mejorar el rendimiento de lectura con descargas en paralelo. |
parallel-downloads-per-file |
Especifica la cantidad máxima de goroutines que se generarán por archivo para descargar el objeto de Cloud Storage en la caché de archivos.
El valor predeterminado es |
max-parallel-downloads |
La cantidad máxima de goroutines que pueden generarse en un momento determinado en todos los trabajos de descarga de archivos. El valor predeterminado es el doble de la cantidad de núcleos de CPU de la máquina. Para omitir un límite, especifica un valor de |
download-chunk-size-mb |
Especifica el tamaño de cada solicitud de lectura en MiB que cada goroutine realiza en Cloud Storage cuando se descarga el objeto en la caché de archivos.
El valor predeterminado es |
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.
Si no se especifica este campo, el valor predeterminado es |
ttl-secs |
Define el tiempo de actividad (TTL) de las entradas de metadatos almacenadas en caché, expresado en segundos.
Si no se especifica este campo, el valor predeterminado es |
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.
Si no se especifica este campo, el valor predeterminado es |
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. |
anonymous-access |
Inhabilita la autenticación para las solicitudes. Establece este campo si usas un extremo personalizado que no admite la autenticación o si usas Cloud Storage FUSE para activar buckets públicos. El valor predeterminado es falso. |
kernel-list-cache-ttl-secs |
Habilita la
caché de listas y
define el tiempo de actividad (TTL) en segundos de las entradas de las listas almacenadas en caché.
El kernel controla la asignación de memoria para la caché de lista según
la memoria disponible. El valor predeterminado es 0 , que inhabilita el almacenamiento en caché de la lista.
Para configurar el campo --kernel-list-cache-ttl-secs , especifica un
valor positivo en segundos de manera que puedas mantener la respuesta de la lista de directorios en la
caché de la página del kernel. Para omitir el vencimiento de la entrada y siempre mostrar la respuesta de lista de la caché cuando esté disponible, ingresa un valor de -1 . |
ignore-interrupts |
Indica a Cloud Storage FUSE que ignore las señales de interrupción del sistema, como SIGINT activada por Control+C . Esto evita que las señales finalicen las operaciones en tránsito. Los valores son true o false . El valor predeterminado es true . |