Arquivo de configuração do Cloud Storage FUSE

Nesta página, descrevemos como usar o arquivo de configuração do Cloud Storage FUSE para definir o comportamento do Cloud Storage FUSE de maneira persistente. Para usar esse arquivo, especifique o caminho para ele na flag --config-file como parte do comando de montagem.

O arquivo de configuração é um YAML que usa o formato e os campos a seguir. Alguns dos campos também podem ser especificados usando opções de linha de comando.

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 configuração

A tabela a seguir descreve os campos que você pode especificar no arquivo de configuração. A menos que seja indicado o contrário, todos os campos são opcionais.

Campo	Descrição
create-empty-file	Um valor booleano que especifica se um arquivo de zero byte será criado no Cloud Storage quando você começar a gravar em um novo arquivo no bucket ativado. Se esse campo não for especificado, o valor padrão será false.
file-path	O caminho para o arquivo de registros em que os registros serão gravados, especificado como uma string. Por exemplo, /var/log Se esse campo não for especificado, os registros serão roteados para stdout quando o Cloud Storage FUSE for executado em primeiro plano e para syslogs quando o Cloud Storage FUSE for executado em segundo plano.
format	O formato em que os registros são gerados, expresso como um tipo enumerado. Os valores são text ou json. Se esse campo não for especificado, o valor padrão será json.
severity	A gravidade dos registros que você quer que o Cloud Storage FUSE gere, expressa como um tipo enumerado. Os níveis de gravidade são ordenados do menor para o maior: trace debug info warning error Ao especificar um nível de gravidade, o Cloud Storage FUSE gera registros com gravidade igual ou maior. Por exemplo, quando você especifica warning, o Cloud Storage FUSE gera registros de avisos e erros. Também é possível especificar off para desativar toda a geração de registros. Se alguma das três opções a seguir também for especificada como parte do seu comando, o nível de gravidade será definido automaticamente como trace: --debug_fuse --debug_gcs --debug_mutex Se esse campo não for especificado, o valor padrão será info.
max-file-size-mb	O tamanho máximo em megabytes (MB) que os arquivos de registro podem alcançar antes de serem rotacionados. O valor mínimo é 1. Se esse campo não for especificado, o valor padrão será 512.
backup-file-count	O número máximo de arquivos de registro rotacionados a serem mantidos, exceto o arquivo ativo em que os registros são gravados. Quando o valor é definido como 0, todos os arquivos de registros rotacionados são mantidos. Se esse campo não for especificado, o valor será 10 por padrão.
compress	Um valor booleano que especifica se os arquivos de registro rotacionados serão compactados usando gzip. Se esse campo não for especificado, o valor padrão será true.
max-size-mb	O tamanho máximo em MiB que o cache de arquivos pode usar. Se presente, max-size-mb habilita o armazenamento em cache de arquivos no Cloud Storage FUSE e é útil se você quer limitar a capacidade total que o cache do Cloud Storage FUSE pode usar no diretório ativado. Especifique -1 para usar toda a capacidade disponível do cache no diretório especificado para cache-dir. Especifique 0 para desativar o cache de arquivos. Se esse campo não for especificado, o valor padrão será -1.
cache-file-for-range-read	Um valor booleano que determina se o objeto completo será transferido por download de maneira assíncrona e armazenado no diretório de cache do Cloud Storage FUSE quando a primeira leitura for feita de um deslocamento diferente de zero. Defina como true se você planeja executar várias leituras aleatórias ou parciais. Se esse campo não for especificado, o valor padrão será false. Se você fizer uma leitura parcial começando no deslocamento 0, o Cloud Storage FUSE sempre fará o download e o armazenamento em cache do objeto completo de maneira assíncrona.
stat-cache-max-size-mb	O tamanho máximo em MiB que o cache de estatísticas pode usar. O cache de estatísticas é sempre mantido por completo na memória. Especifique 32 se a carga de trabalho envolver até 20.000 arquivos. Se a carga de trabalho for maior que 20.000 arquivos, aumente o tamanho em valores de 10 para cada 6.000 arquivos adicionais, uma média de aproximadamente 1.500 bytes por arquivo. Especifique -1 para permitir que o cache de estatísticas use a quantidade de memória necessária. Especifique 0 para desativar o cache de estatísticas. Se esse campo não for especificado, o valor padrão será 32.
ttl-secs	Define o time to live (TTL) de entradas de metadados armazenadas em cache, expresso em segundos. Especifique -1 para ignorar uma expiração de TTL e exibir o arquivo a partir do cache sempre que ele estiver disponível. Especifique 0 para garantir que o arquivo mais atualizado seja lido. O uso desse valor emite uma chamada de metadados "Receber" para garantir que a geração do objeto para o arquivo no cache corresponda ao que está armazenado no Cloud Storage. Para saber mais, consulte Sobre a flag ttl-secs. Se esse campo não for especificado, o valor padrão será 60.
type-cache-max-size-mb	O tamanho máximo em MiB por diretório que o cache de tipos pode usar. O cache de tipos é sempre totalmente mantido na memória. Especifique 4 se o número máximo de arquivos em um único diretório do bucket que você está ativando contiver 20.000 arquivos ou menos. Se o número máximo de arquivos em um único diretório ativado tiver mais de 20.000 arquivos, aumente o valor por 1 para cada 5.000 arquivos, uma média de aproximadamente 200 bytes por arquivo. Especifique -1 para permitir que o cache de tipos use a quantidade de memória necessária. Especifique 0 para desativar o cache de tipos. Se esse campo não for especificado, o valor padrão será 4.
cache-dir	Especifica o diretório para armazenar dados de cache de arquivos. Esse campo precisa ser especificado para ativar o armazenamento em cache de arquivos.