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
--anonymous-access BOOLEAN Desativa a autenticação para solicitações. Esse flag deve ser definido se você estiver usando um endpoint personalizado que não é compatível com autenticação. Esta sinalização também deve ser definido se você estiver usando o Cloud Storage FUSE com buckets públicos. O valor padrão é false.
--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. 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 a autenticação não tiver suporte no endpoint personalizado que você especificar, defina a sinalização --anonymous-access como true para ignorar a autenticação.
--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.
--download-chunk-size-mb VALUE Especifica o tamanho de cada solicitação de leitura em MiB que cada worker faz para o Cloud Storage ao fazer o download do objeto no cache de arquivos. O valor padrão é 50.
--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.
--enable-parallel-downloads BOOLEAN Acelera a leitura de arquivos grandes usando o diretório de cache de arquivos como um buffer de pré-busca usando vários workers para fazer o download de arquivos grandes em em paralelo. O valor padrão é false.
Para usar downloads paralelos, ative o armazenamento em cache de arquivos. Para saber mais sobre downloads paralelos e configurar as propriedades de suporte, consulte Melhorar o desempenho de leitura usando downloads paralelos.
--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.
--ignore-interrupts VALUE Instrui o Cloud Storage FUSE a ignorar sinais de interrupção do sistema, como SIGINT acionado por Control+C. Isso impede indicadores de encerramento de operações em andamento. Os valores são true ou false. O valor padrão é true.
--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.
--kernel-list-cache-ttl-secs VALUE Ativa a cache da lista e define o time to live (TTL) em segundos de cache na lista de permissões. O cache da lista é mantido na memória do cache da página, que é controlados pelo kernel com base na memória disponível. O valor padrão é 0, que desativa o armazenamento em cache da lista.

Para definir a sinalização --kernel-list-cache-ttl-secs, especifique um positivo em segundos para manter a resposta da lista de diretórios no do kernel da página. Para ignorar a expiração da entrada e sempre retornar a lista do cache quando disponível, especifique o valor -1:
--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 é 0, que especifica que não há limite nas conexões TCP, com exceção das limitações definidas especificações da máquina.
--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-parallel-downloads-per-file VALUE Especifica o número máximo de workers que podem ser gerados a qualquer momento em todos os jobs de download de arquivos. O padrão é definido como o dobro do número de núcleos de CPU na máquina. Um valor de -1 significa que não há limite.
--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.
--parallel-downloads-per-file VALUE Especifica o número máximo de workers a serem gerados por arquivo para download o objeto do Cloud Storage para o cache de arquivos. O valor padrão é 16.
--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.

Em vez dessa flag, use o método metadata-cache: stat-cache max-size em um arquivo de configuração para definir o tamanho máximo do cache de estatísticas. Para mais informações, consulte a Arquivo de configuração do Cloud Storage FUSE.
--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 é 60s.

Em vez dessa flag, use o campo metadata-cache: ttl-secs. em um arquivo de configuração para especificar Time to live (TTL) de entradas de metadados de caches de tipo e estatística. Para Para mais informações, consulte o arquivo de configuração do Cloud Storage FUSE.
--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.

Em vez disso, use o campo metadata-cache: ttl-secs para especificar Time to live (TTL) de entradas de metadados de caches de tipo e estatística. Para mais informações, consulte a Arquivo de configuração do Cloud Storage FUSE.
--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.