CLI de gcsfuse

En esta página, se describen los comandos de línea de comandos de gcsfuse usados para interactuar con Cloud Storage FUSE.

Sinopsis

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Donde:

• GLOBAL_OPTIONS son las opciones que controlan cómo se configura la activación y cómo se comporta Cloud Storage FUSE.

• BUCKET_NAME es el nombre del bucket que se activará. Por ejemplo, my-mount-bucket. Opcional. Excluye el nombre de un bucket de este comando para realizar la activación dinámica.

• MOUNT_POINT es el directorio local donde se activará el bucket. Por ejemplo, /path/to/mount/point.

Descripción

La CLI de gcsfuse se usa para activar buckets de Cloud Storage como sistemas de archivos en una máquina local.

Opciones globales

Opciones globales	Descripción
--anonymous-access BOOLEAN	Inhabilita la autenticación para las solicitudes. Esta marca se debe configurar si usas un extremo personalizado que no admite la autenticación. Esta marca también se debe configurar si usas Cloud Storage FUSE con buckets públicos. El valor predeterminado es false.
--app-name VALUE	El nombre de la aplicación de la activación.
--billing-project VALUE	Especifica un proyecto para usarlo en la facturación cuando se accede al bucket activado. Esta marca a menudo es obligatoria cuando se activa un bucket habilitado con los pagos del solicitante. El proyecto predeterminado no es ninguno.
--client-protocol VALUE	Especifica el protocolo que se usa para comunicarse con el backend de Cloud Storage. El valor puede ser http1 para HTTP/1.1 o http2 para HTTP/2. El valor predeterminado es http1.
--config-file VALUE	Especifica la ruta de acceso al archivo de configuración que deseas usar para configurar los comportamientos de Cloud Storage FUSE. Por ejemplo, --config-file /etc/gcsfuse.yaml
--custom-endpoint VALUE	Especifica un extremo personalizado alternativo para recuperar datos. El extremo personalizado debe admitir los recursos y las operaciones equivalentes al extremo JSON de Cloud Storage, https://storage.googleapis.com/storage/v1. Si no se especifica un extremo personalizado, Cloud Storage FUSE usa el extremo global de la API de JSON de Cloud Storage, https://storage.googleapis.com/storage/v1. Si la autenticación no es compatible con el extremo personalizado que especificas, establece la marca --anonymous-access en true para omitir la autenticación.
--debug_fuse_errors	Si se excluye, se evalúa como falso y evita que los errores de FUSE se registren en la consola (si se usa --foreground) o en el archivo de registro (si se usa --log-file).
--debug_fuse	Habilita el resultado de depuración relacionado con FUSE. Si se especifica esta opción, el nivel de gravedad de los registros se establece de forma automática en trace, que incluye registros de seguimiento, registros de depuración, registros de información, registros de advertencia y registros de errores.
--debug_gcs	Imprime información sobre el tiempo y la solicitud de Cloud Storage. Si se especifica esta opción, el nivel de gravedad de los registros se establece de forma automática en trace, que incluye registros de seguimiento, registros de depuración, registros de información, registros de advertencia y registros de errores.
--debug-invariants	Se genera un error cuando se infringen las invariables internas.
--debug_mutex	Imprime mensajes de depuración cuando una exclusión se mantiene por mucho tiempo. Si se especifica esta opción, el nivel de gravedad de los registros se establece de forma automática en trace, que incluye registros de seguimiento, registros de depuración, registros de información, registros de advertencia y registros de errores.
--dir-mode VALUE	Bits de permisos para directorios, en octal. El valor predeterminado es 755.
--enable-nonexistent-type-cache	Crea una entrada de tipo caché con el tipo NonexistentType si no se encuentra un archivo en Cloud Storage. Si el archivo se crea en Cloud Storage, pero la entrada NonexistentType del archivo se almacena en caché, Cloud Storage FUSE no puede solicitar ese archivo hasta que la entrada NonexistentType se quite del tipo caché.
--experimental-enable-json-read	Le especifica a Cloud Storage FUSE que use la API de JSON de Cloud Storage en las operaciones de lectura. De forma predeterminada, las operaciones de lectura se realizan con la API de XML de Cloud Storage.
--experimental-opentelemetry-collector-address VALUE	Exporta las métricas al recopilador de OpenTelemetry en la dirección especificada. Experimental.
--file-mode VALUE	Especifica los bits de permisos para los archivos, en octal. El valor predeterminado es 644.
--foreground	Ejecuta el comando gcsfuse en primer plano.
--gid VALUE	Especifica el propietario del identificador de grupo (GID) de todos los inodos. El valor predeterminado del GID es -1.
--help o -h	Muestra ayuda sobre Cloud Storage FUSE.
--http-client-timeout VALUE	Especifica el tiempo que el cliente HTTP de Cloud Storage FUSE puede esperar para obtener una respuesta del servidor antes de que se agote el tiempo de espera. El valor predeterminado es 0s, que indica que no hay tiempo de espera.
--implicit-dirs	Incluye de manera implícita carpetas y carpetas administradas. Consulta la documentación de archivos y directorios en GitHub para obtener más información.
--key-file VALUE	Especifica una ruta de acceso absoluta al archivo de claves JSON de las credenciales para autenticar solicitudes a Cloud Storage. De forma predeterminada, Cloud Storage FUSE usa credenciales predeterminadas de la aplicación para autenticar solicitudes.
--limit-bytes-per-sec VALUE	Especifica el límite de ancho de banda en el que Cloud Storage FUSE puede leer datos de Cloud Storage, medido en un período de 30 segundos. El valor límite predeterminado es -1, que especifica que no hay ningún límite.
--limit-ops-per-sec VALUE	Especifica un límite para las operaciones realizadas por segundo, medido en un período de 30 segundos. El valor límite predeterminado es -1, que especifica que no hay ningún límite.
--log-file VALUE	Especifica el archivo para almacenar registros que Fluentd puede analizar. Cuando no se proporciona, los registros de texto sin formato se imprimen en stdout cuando Cloud Storage FUSE se ejecuta en primer plano o en syslog cuando Cloud Storage FUSE se ejecuta en segundo plano.
--log-format VALUE	Especifica el formato del archivo de registro. El valor puede ser text o json. El valor predeterminado es json.
--max-conns-per-host VALUE	Especifica la cantidad máxima de conexiones TCP permitidas por servidor. Esto entra en vigor cuando --client-protocol se establece en http1. El valor predeterminado es 0, que especifica que no hay un límite en las conexiones de TCP, excepto las limitaciones que define las especificaciones de tu máquina.
--max-idle-conns-per-host VALUE	Especifica la cantidad máxima de conexiones inactivas permitidas por servidor. El valor predeterminado es 100.
--max-retry-sleep VALUE	Especifica la duración máxima que Cloud Storage FUSE puede suspender en un bucle de reintentos con retirada exponencial. Una vez que la duración de retirada excede la duración máxima especificada, el reintento continúa con la duración máxima especificada. El valor límite predeterminado es 30s (30 segundos).
-o VALUE	Especifica opciones de activación adicionales específicas del sistema. La mayoría de las opciones de activación genéricas en FUSE (como rw y suid) son compatibles con Cloud Storage FUSE y se pueden pasar junto con la marca -o. Consulta la documentación de FUSE para Linux para obtener más detalles.
-o ro	Activa un bucket como de solo lectura.
--only-dir VALUE	Activa solo un directorio específico dentro de un bucket.
--rename-dir-limit VALUE	Permite cambiar el nombre de los directorios que contienen menos subordinados que el límite especificado. El valor límite predeterminado es 0.
--retry-multiplier VALUE	Especifica el tiempo de espera entre dos reintentos consecutivos.
--reuse-token-from-url	Si se incluye, se evalúa como verdadero y especifica que se debe usar el token adquirido de --token-url. Si se excluye, se evalúa como falso y especifica que el token adquirido de --token-url no se debe volver a usar.
--sequential-read-size-mb VALUE	Especifica el tamaño de fragmento de los datos que se descargarán desde Cloud Storage, en megabytes (MB).
--stackdriver-export-interval VALUE	Exporta métricas a Stackdriver con el intervalo especificado. El valor predeterminado es 0s, que no especifica ninguna exportación.
--stat-cache-capacity VALUE	Obsoleto.. Especifica la cantidad de entradas que puede contener la caché de estadísticas. Esto afecta el consumo de memoria. El valor predeterminado es 4096. En lugar de esta marca, usa el campo metadata-cache: stat-cache max-size en un archivo de configuración para definir el tamaño máximo de la caché de estadísticas. Para obtener más información, consulta el archivo de configuración de Cloud Storage FUSE.
--stat-cache-ttl VALUE	Obsoleto.. Especifica por cuánto tiempo se deben almacenar en caché los resultados StatObject y los atributos de inodo. El valor predeterminado es 60s. En lugar de esta marca, usa el campo metadata-cache: ttl-secs en un archivo de configuración para especificar el tiempo de actividad (TTL) de las entradas de metadatos de las cachés de estadísticas y de tipo. Para obtener más información, consulta el archivo de configuración de Cloud Storage FUSE.
--type-cache-ttl VALUE	Obsoleto.. Especifica por cuánto tiempo se debe almacenar en caché la asignación entre nombres y archivos o directorios en inodos de directorio. El valor predeterminado es 60s. En su lugar, usa el campo metadata-cache: ttl-secs para especificar el tiempo de actividad (TTL) de las entradas de metadatos de las cachés de estadísticas y de tipo. Para obtener más información, consulta el archivo de configuración de Cloud Storage FUSE.
--temp-dir value VALUE	Especifica una ruta de acceso al directorio temporal en el que las operaciones de escritura se publican en etapa de pruebas antes de subirse a Cloud Storage. El valor predeterminado es el predeterminado del sistema, que es probable que sea /tmp.
--token-url VALUE	Especifica una URL para obtener un token de acceso cuando --key-file está ausente.
--uid VALUE	Especifica el propietario del identificador de usuario (UID) de todos los inodos. El valor de UID predeterminado es -1.
--version o -v	Muestra la versión de Cloud Storage FUSE que instalaste.