CLI do gcsfuse

Nesta página, descrevemos as opções da linha de comando gcsfuse usadas para interagir com o Cloud Storage FUSE.

Sinopse

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Em que:

  • GLOBAL_OPTIONS são as opções que controlam como a montagem é configurada e o comportamento do Cloud Storage FUSE.

  • BUCKET_NAME é o nome do bucket a ser ativado. Por exemplo, my-mount-bucket. Opcional. Exclua um nome de bucket desse comando para realizar a montagem dinâmica.

  • MOUNT_POINT é o diretório local em que o bucket será ativado. Por exemplo, /path/to/mount/point.

Descrição

A CLI do gcsfuse é usada para ativar buckets do Cloud Storage como sistemas de arquivos em uma máquina local.

Opções globais

Opções globais Descrição
--app-name VALUE O nome do aplicativo da montagem.
--billing-project VALUE Especifica um projeto para usar no faturamento quando o bucket ativado é acessado. Essa sinalização é frequentemente necessária ao ativar um bucket ativado com pagamentos do solicitante. O projeto padrão é nenhum.
--client-protocol VALUE Especifica o protocolo usado para comunicação com o back-end do Cloud Storage. O valor pode ser http1 para HTTP/1.1 ou http2 para HTTP/2. O valor padrão é http1.
--config-file VALUE Especifica o caminho para o arquivo de configuração que você quer usar para configurar os comportamentos do Cloud Storage FUSE. Por exemplo, --config-file /etc/gcsfuse.yaml
--custom-endpoint VALUE Especifica um endpoint personalizado alternativo para buscar dados. Use apenas para testes. O endpoint personalizado precisa ser compatível com os recursos e as operações equivalentes ao endpoint JSON do Cloud Storage, https://storage.googleapis.com/storage/v1. Se um endpoint personalizado não for especificado, o Cloud Storage FUSE usará o endpoint global da API JSON do Cloud Storage, https://storage.googleapis.com/storage/v1. Se um endpoint personalizado for especificado, a autenticação será desativada no endpoint.
--debug_fuse_errors Se excluído, avalia como falso e impede Erros do FUSE sejam registrados no console (se --foreground é usado) ou o arquivo de registro (se --log-file é usado).
--debug_fuse Ativa a saída de depuração relacionada ao FUSE. Se essa opção for especificada, o nível de gravidade dos registros será definido automaticamente como trace, o que inclui registros de rastreamento, depuração, informações, avisos e erros.
--debug_gcs Imprime informações de solicitação e tempo do Cloud Storage. Se essa opção for especificada, o nível de gravidade dos registros será definido automaticamente como trace, o que inclui registros de rastreamento, depuração, informações, avisos e erros.
--debug-invariants Pânico quando as invariantes internas são violadas.
--debug_mutex Imprime mensagens de depuração quando uma mutex é mantida por muito tempo. Se essa opção for especificada, o nível de gravidade dos registros será definido automaticamente como trace, o que inclui registros de rastreamento, depuração, informações, aviso e erro.
--dir-mode VALUE Bits de permissões para diretórios, em octal. O valor padrão é 755.
--enable-nonexistent-type-cache Cria uma entrada de cache de tipo com o tipo NonexistentType se um arquivo não for encontrado no Cloud Storage. Se o arquivo for criado no Cloud Storage, mas a entrada NonexistentType para o arquivo for armazenada em cache, o Cloud Storage FUSE não poderá solicitar esse arquivo até que a entrada NonexistentType seja removida do tipo cache.
--experimental-enable-json-read Especifica o Cloud Storage FUSE para usar a API JSON do Cloud Storage em operações de leitura. Por padrão, as operações de leitura são realizadas com a API XML do Cloud Storage.
--experimental-opentelemetry-collector-address VALUE Exporta métricas para o Coletor do OpenTelemetry no endereço especificado. Experimental.
--file-mode VALUE Especifica bits de permissões para arquivos, em octal. O valor padrão é 644.
--foreground Executa o comando gcsfuse em primeiro plano.
--gid VALUE Especifica o proprietário do Identificador de Grupo (GID) de todos os inodes. O valor padrão do GID é -1.
--help ou -h Exibe ajuda sobre o Cloud Storage FUSE.
--http-client-timeout VALUE Especifica quanto tempo o cliente HTTP do FUSE do Cloud Storage pode aguardar para receber uma resposta do servidor antes de expirar. O valor padrão é 0s, que não indica tempo limite.
--implicit-dirs

Inclui pastas e pastas gerenciadas de maneira implícita.

Consulte a documentação de arquivos e diretórios no GitHub (em inglês) para mais informações.
--key-file VALUE Especifica um caminho absoluto para o arquivo de chave JSON de credencial para autenticar solicitações para o Cloud Storage. Por padrão, o Cloud Storage FUSE usa Application Default Credentials para autenticar solicitações.
--limit-bytes-per-sec VALUE Especifica o limite de largura de banda em que o Cloud Storage FUSE pode ler dados do Cloud Storage, medidos em uma janela de 30 segundos. O valor limite padrão é -1, que não especifica nenhum limite.
--limit-ops-per-sec VALUE Especifica um limite para operações executadas por segundo, medida em uma janela de 30 segundos. O valor limite padrão é -1, que não especifica nenhum limite.
--log-file VALUE Especifica o arquivo para armazenar registros que podem ser analisados por Fluentd. Quando não são fornecidos, os registros de texto simples são exibidos em stdout quando o Cloud Storage FUSE é executado em primeiro plano ou em syslog quando o Cloud Storage FUSE é executado em segundo plano.
--log-format VALUE Especifica o formato do arquivo de registros. O valor pode ser text ou json. O valor padrão é json.
--max-conns-per-host VALUE Especifica o número máximo de conexões TCP permitidas por servidor. Isso entra em vigor quando --client-protocol é definido como http1. O valor padrão é 100.
--max-idle-conns-per-host VALUE Especifica o número máximo de conexões inativas permitidas por servidor. O valor padrão é 100.
--max-retry-sleep VALUE Especifica a duração máxima que o Cloud Storage FUSE pode ficar suspenso em um loop de nova tentativa com espera exponencial. Quando a duração de espera excede a duração máxima especificada, a nova tentativa continua com a duração máxima especificada. O valor limite padrão é 30s (30 segundos).
-o VALUE

Especifica outras opções de ativação específicas do sistema.

A maioria das opções de ativação genéricas no FUSE, como rw e suid, é compatível com o Cloud Storage FUSE e pode ser transmitida com a sinalização -o. Para mais detalhes, consulte a documentação do Linux FUSE (em inglês).
-o ro Monta um bucket como somente leitura.
--only-dir VALUE Ativa apenas um diretório específico em um bucket.
--rename-dir-limit VALUE Permite renomear os diretórios que contêm menos descendentes do que o limite especificado. O valor limite padrão é 0.
--retry-multiplier VALUE Especifica o tempo de espera entre duas tentativas consecutivas.
--reuse-token-from-url Se incluído, avalia como verdadeiro e especifica que o token adquirido de --token-url será usado. Se excluído, avalia como falso e especifica que o token adquirido de --token-url não pode ser reutilizado.
--sequential-read-size-mb VALUE Especifica o tamanho do bloco dos dados a serem baixados do Cloud Storage, em megabytes (MB).
--stackdriver-export-interval VALUE Exporta métricas para o Stackdriver com o intervalo especificado. O valor padrão é 0s, que não especifica a exportação.
--stat-cache-capacity VALUE Descontinuado. Especifica o número de entradas que o cache de estatísticas pode conter. Isso afeta o consumo de memória. O valor padrão é 4096.
--stat-cache-ttl VALUE Descontinuado. Especifica por quanto tempo os resultados de StatObject e os atributos de nó são armazenados em cache. O valor padrão é 1m0s.
--type-cache-ttl VALUE Descontinuado. Especifica por quanto tempo o mapeamento em cache entre nomes e arquivos ou diretórios será armazenado em cache em inodes do diretório. O valor padrão é 60s.
--temp-dir value VALUE Especifica um caminho para o diretório temporário em que as gravações são testadas antes do upload para o Cloud Storage. O valor padrão é o padrão do sistema, provavelmente /tmp.
--token-url VALUE Especifica um URL para receber um token de acesso quando --key-file estiver ausente.
--uid VALUE Especifica o proprietário do identificador de usuário (UID, na sigla em inglês) de todos os nós. O valor do UID padrão é -1.
--version ou -v Exibe a versão do Cloud Storage FUSE instalada.