Configurar montagens de volumes do Cloud Storage para pools de trabalhadores

Nesta página, você aprende a montar um bucket do Cloud Storage como um volume de armazenamento usando as montagens de volumes do Cloud Run.

Montar o bucket como um volume no Cloud Run apresenta o bucket conteúdo como arquivos no sistema de arquivos do contêiner. Depois de ativar o bucket, como um volume, você acessa o bucket como se fosse um diretório no arquivo local do sistema de arquivos, usando as operações e bibliotecas do sistema de arquivos da sua linguagem de programação em vez das bibliotecas de cliente das APIs do Google.

É possível montar o volume como somente leitura e também especificar opções de montagem para o volume.

.

Requisitos de memória

As montagens de volume do Cloud Storage usam a memória do contêiner do Cloud Run para as seguintes atividades:

  • Para todo o armazenamento em cache do Cloud Storage FUSE, o Cloud Run usa a configuração de cache de estatísticas com um Time to live (TTL) de 60 segundos por padrão. O tamanho máximo padrão do cache de estatísticas é 32 MB, e o tamanho máximo padrão do cache de tipo é 4 MiB.

  • Ao ler do Cloud Storage, o Cloud Storage FUSE faz chamadas de API para ler um objeto diretamente, sem fazer o download do arquivo inteiro para um diretório local. O Cloud Storage FUSE estabelece uma conexão TCP e lê todo o objeto do Cloud Storage ou apenas partes do arquivo que você especificar no aplicativo ou no sistema operacional por meio de um deslocamento. Durante a leitura, o Cloud Storage FUSE também consome memórias diferentes de caches de estatística e tipo, como uma matriz de 1 MiB para cada arquivo que ele lê e para goroutines.

  • Ao gravar no Cloud Storage, o Cloud Storage FUSE é compatível com streaming-writes, um caminho de gravação, por padrão. O Cloud Storage FUSE faz upload de dados diretamente para o Cloud Storage sem preparar totalmente o arquivo. Cada arquivo aberto para gravações de streaming consome aproximadamente 64 MiB de memória durante o processo de upload. Isso reduz a latência e o uso de espaço em disco, o que é particularmente benéfico para gravações sequenciais grandes.

Limitações

Como o Cloud Run usa o Cloud Storage FUSE para essa montagem de volume, há algumas coisas a serem lembradas ao montar um bucket do Cloud Storage como um volume:

  • O Cloud Storage FUSE não oferece controle de simultaneidade para várias gravações (bloqueio de arquivo) no mesmo arquivo. Quando várias gravações tentam substituir um arquivo, a última é bem-sucedida e todas as anteriores são perdidas.
  • O Cloud Storage FUSE não é um sistema de arquivos totalmente compatível com POSIX. Para mais detalhes, consulte a documentação do Cloud Storage FUSE.

Caminhos não permitidos

O Cloud Run não permite montar um volume em /dev, /proc ou /sys, ou nos subdiretórios deles.

Antes de começar

Você precisa de um bucket do Cloud Storage para montar como o volume.

Para ter o melhor desempenho de leitura/gravação no Cloud Storage, consulte Como otimizar o desempenho da largura de banda de rede do Cloud Storage FUSE.

Funções exigidas

Para receber as permissões necessárias para configurar as montagens de volume do Cloud Storage, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para receber as permissões de que a identidade de serviço precisa para acessar o arquivo e o bucket do Cloud Storage, peça ao administrador para conceder à identidade de serviço o papel de Leitor de objetos do Storage (roles/storage.objectViewer). Se a identidade de serviço também precisar realizar operações de gravação em um bucket, conceda o papel Usuário de objetos do Storage (roles/storage.objectUser).

Para mais detalhes sobre papéis e permissões do Cloud Storage, consulte IAM para o Cloud Storage.

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o pool de workers do Cloud Run interagir com APIs doGoogle Cloud , como bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Montar um volume do Cloud Storage

É possível montar vários buckets em diferentes caminhos de montagem. Também é possível montar um volume em mais de um contêiner usando caminhos de montagem iguais ou diferentes nos contêineres.

Ao usar vários contêineres, primeiro especifique os volumes e, depois, as montagens de volume de cada contêiner.

É possível configurar um volume do Cloud Storage para um pool de workers do Cloud Run usando o console do Google Cloud , a Google Cloud CLI, o YAML ou o Terraform:

Console

  1. No console do Google Cloud , acesse a página do Cloud Run:

    Acessar o Cloud Run

  2. Selecione Pools de workers no menu de navegação do Cloud Run:

    1. Se você estiver configurando um pool de workers, clique nele e em Editar e implantar nova revisão.

    2. Se você estiver configurando um novo pool de workers, clique em Implantar contêiner e preencha a página inicial do pool de workers. Em seguida, clique em Contêineres, rede, segurança para expandir a página de configuração dos pools de workers.

  3. Clique na guia Volumes.

  4. Clique em Montar volume.

  5. Selecione Bucket do Cloud Storage como o tipo de volume.

  6. Para configurar o volume, faça o seguinte:

    1. No campo Caminho de montagem, insira o caminho em que você quer montar o volume.
    2. Procure e selecione o bucket do Cloud Storage ou um diretório específico em um bucket a ser usado para o volume. Se quiser, crie um novo bucket.
    3. Se você quiser tornar o bucket somente leitura, marque a caixa de seleção Somente leitura.
    4. Opcional: expanda Opções de montagem para especificar as opções de montagem.
    5. Clique em Salvar.
  7. Clique em Criar ou Implantar.

gcloud

  • Para adicionar uma montagem de volume:

    gcloud run worker-pools update WORKER_POOL \
      --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,readonly=READ_ONLY

    Substitua:

    • WORKER_POOL: o nome do pool de workers.
    • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /mnt/my-volume.
    • BUCKET_NAME: o nome do bucket do Cloud Storage.
    • READ_ONLY: true para tornar o volume somente leitura ou false para permitir gravações.
  • Se você estiver usando vários contêineres, primeiro especifique os volumes e, em seguida, as ativações de volume para cada contêiner:

    gcloud run worker-pools update WORKER_POOL \
      --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
      --container=CONTAINER_1 \
      --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH \
      --container=CONTAINER_2 \
      --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH2

YAML

  1. Se você estiver criando um novo pool de workers, pule esta etapa. Se você estiver atualizando um pool de workers, faça o download da configuração YAML correspondente:

    gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
  2. O exemplo a seguir contém a configuração YAML:

    apiVersion: run.googleapis.com/v1
    kind: WorkerPool
    metadata:
      name: WORKER_POOL
    spec:
      template:
        spec:
          containers:
            image: IMAGE_URL
            volumeMounts:
            - name: 
              mountPath: MOUNT_PATH
          volumes:
          - name: VOLUME_NAME
            csi:
              driver: gcsfuse.run.googleapis.com
              readOnly: IS_READ_ONLY
              volumeAttributes:
                bucketName: BUCKET_NAME

    Substitua:

    • WORKER_POOL: o nome do pool de workers do Cloud Run.
    • IMAGE_URL: uma referência à imagem de contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
    • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /mnt/my-volume.
    • VOLUME_NAME: qualquer nome que você queira para o volume. O valor VOLUME_NAME é usado para mapear o volume para a montagem associada.
    • IS_READ_ONLY: True para tornar o volume somente leitura ou False para permitir gravações.
    • BUCKET_NAME pelo nome do bucket do Cloud Storage.
  3. Crie ou atualize o pool de workers usando o seguinte comando:

    gcloud run worker-pools replace worker-pool.yaml

    O comando gcloud run worker-pools replace usa o arquivo worker-pool.yaml por padrão, se ele estiver presente.

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

  resource "google_cloud_run_v2_worker_pool" "default" {
    name     = "WORKER_POOL"
    location = "REGION"

    template {
      containers {
        image = "IMAGE_URL"
        volume_mounts {
          name = "VOLUME_NAME"
          mount_path = "MOUNT_PATH"
        }
      }

      volumes {
        name = "VOLUME_NAME"
        gcs {
          bucket = google_storage_bucket.default.name
          read_only = IS_READ_ONLY
        }
      }
    }
  }

  resource "google_storage_bucket" "default" {
    name     = "BUCKET_NAME"
    location = "REGION"
  }

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • REGION: a região do Google Cloud .
  • IMAGE_URL: uma referência à imagem de contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • VOLUME_NAME: qualquer nome que você queira para o volume. O valor VOLUME_NAME é usado para mapear o volume para a montagem associada.
  • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /mnt/my-volume.
  • IS_READ_ONLY: True para tornar o volume somente leitura ou False para permitir gravações.
  • BUCKET_NAME pelo nome do bucket do Cloud Storage.

Ver a configuração da variável de ambiente para o pool de workers

  1. No console do Google Cloud , acesse o Cloud Run:

    Acessar o Cloud Run

  2. Clique em Pools de workers para exibir a lista de pools de workers implantados.

  3. Clique no pool de workers que você quer examinar para exibir o painel de detalhes.

  4. Clique na guia Contêineres para exibir a configuração do contêiner do pool de workers.

Como ler e gravar em um volume

Se você usar o recurso de montagem de volume do Cloud Run, poderá acessar um volume usando as mesmas bibliotecas na linguagem de programação que você usa para ler e gravar arquivos no sistema de arquivos local.

Isso é especialmente útil se você estiver usando um contêiner existente em que espera os dados sejam armazenados no sistema de arquivos local e usa o sistema de arquivos para acessá-lo.

Os snippets a seguir pressupõem uma montagem de volume com mountPath definido como /mnt/my-volume.

Nodejs

Use o módulo Sistemas de arquivos para criar um novo arquivo ou adicionar ao final de um arquivo existente no volume, /mnt/my-volume:

var fs = require('fs');
fs.appendFileSync('/mnt/my-volume/sample-logfile.txt', 'Hello logs!', { flag: 'a+' });

Python

Grave em um arquivo no volume, /mnt/my-volume:

f = open("/mnt/my-volume/sample-logfile.txt", "a")

Go

Use o pacote os para criar um novo arquivo mantido no volume, /mnt/my-volume:

f, err := os.Create("/mnt/my-volume/sample-logfile.txt")

Java

Use a classe Java.io.File para criar um arquivo de registro no volume, /mnt/my-volume:

import java.io.File;
File f = new File("/mnt/my-volume/sample-logfile.txt");

Configuração de volume usando opções de montagem

Se quiser, use as opções de montagem para configurar várias propriedades da montagem do volume. As opções de montagem disponíveis permitem definir as configurações de cache, montar um diretório específico, ativar o registro de depuração e outros comportamentos.

Especificar opções de montagem

É possível especificar opções de montagem usando o console do Google Cloud , a Google Cloud CLI, o YAML ou o Terraform. As opções de montagem são separadas por ponto e vírgula (;) na Google Cloud CLI e por vírgulas em YAML, conforme mostrado nas seguintes guias:

Console

Para especificar as opções de montagem de um volume:

  1. No console do Google Cloud , acesse a página Pools de workers do Cloud Run:

    Acessar o Cloud Run

  2. Clique no pool de workers e em Editar e implantar nova revisão.

  3. Clique na guia Volumes.

    1. Clique em Editar montagem de volume.
    2. Abra Opções de montagem.
    3. Configure as opções de montagem atualizando os campos apropriados ou adicionando opções de montagem manualmente.
    4. Clique em Salvar.
  4. Clique em Implantar.

gcloud

Para adicionar um volume e montá-lo com opções de montagem:

gcloud run worker-pools update WORKER_POOL \
    --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,readonly=READ_ONLY,mount-options="OPTION_1=VALUE_1;OPTION_N=VALUE_N"

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /cache.
  • BUCKET_NAME: o nome do bucket do Cloud Storage.
  • OPTION_1: a primeira opção de montagem. É possível especificar quantas opções de montagem forem necessárias, com cada opção de montagem e par de valores separados por um ponto e vírgula.
  • VALUE_1: a configuração que você quer para a primeira opção de montagem.
  • OPTION_N: a próxima opção de montagem.
  • VALUE_N: a configuração da próxima opção de montagem.

Opções de montagem usadas com frequência

As opções de montagem são usadas com frequência para:

  • Definir configurações de cache
  • Montar apenas um diretório específico do bucket do Cloud Storage
  • Configurar a propriedade do volume (uid, gid)
  • Desativar diretórios implícitos
  • Especifique os níveis de registro de depuração.

Definir configurações de armazenamento em cache

É possível mudar as configurações de armazenamento em cache do volume definindo as opções de montagem relacionadas ao armazenamento em cache. A tabela a seguir lista as configurações, além dos valores padrão do Cloud Run:

Configuração de cache Descrição Padrão
cache-dir O nome do volume na memória a ser usado como o diretório subjacente para persistir arquivos do bucket do Cloud Storage no formato cr-volume:{volume name}. Por exemplo, se você tiver um volume na memória chamado in-memory-1 que queira usar como diretório de cache, especifique cr-volume:in-memory-1. Para instruções sobre como configurar volumes na memória, consulte Configurar montagens de volumes na memória para serviços. Quando você ativa esses recursos, o Cloud Run muda a contabilidade de recursos do processo do Cloud Storage FUSE e a inclui nos limites de memória do contêiner. Para aumentar o limite de memória do contêiner, consulte Configurar limites de memória para serviços.
file-cache-download-chunk-size-mb Especifica o tamanho de cada solicitação de leitura em MiB que cada goroutine faz para o Cloud Storage ao fazer o download do objeto no cache de arquivos. 200
file-cache-enable-parallel-downloads 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 várias partes de um arquivo em paralelo. verdadeiro
file-cache-max-parallel-downloads O número máximo de goroutines que podem ser gerados a qualquer momento em todos os jobs de download de arquivos. O dobro do número de núcleos de CPU na máquina ou 16, o que for maior.
file-cache-parallel-downloads-per-file O número de solicitações de download simultâneas por arquivo. 16
file-cache-cache-file-for-range-read Determina se o download completo do objeto precisa ser feito de modo assíncrono e armazenado no diretório de cache do Cloud Storage FUSE quando a primeira leitura for feita de um deslocamento diferente de zero. falso
enable-buffered-read Ativa o buffer de leitura para pré-buscar dados de objetos. Recomendado para cargas de trabalho que leem arquivos grandes sequencialmente (como modelos de machine learning ou conjuntos de dados) para melhorar significativamente a capacidade de leitura e reduzir a latência de inicialização do contêiner. falso
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, o que afeta o consumo de memória. Especifique um valor de 32 se a carga de trabalho envolver até 20.000 arquivos. Se a carga de trabalho usar mais de 20.000 arquivos, aumente o tamanho em valores de 10 para cada 6.000 arquivos adicionais, em que o cache de estatísticas usa uma média de 1.500 bytes por arquivo.

Para permitir que o cache de estatísticas use a quantidade necessária de memória, especifique um valor de -1. Para desativar o cache de estatísticas, especifique um valor de 0.
32
type-cache-max-size-mb O tamanho máximo em MiB por diretório que o cache de tipos pode usar. O cache de tipo é sempre mantido inteiramente na memória, o que afeta o consumo de memória.

Especifique um valor de 4 se o número máximo de arquivos em um único diretório do bucket que você está montando 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.

Para permitir que o cache de tipos use a quantidade de memória necessária, especifique um valor de -1.

Para desativar o cache de tipos, especifique um valor de 0.
4

O comando da Google Cloud CLI a seguir define metadata-cache-ttl-secs como 120 segundos e aumenta a capacidade do cache de estatísticas e tipos para 52 e 7 MiB, respectivamente:

gcloud run worker-pools update WORKER_POOL \
    -add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,mount-options="metadata-cache-ttl-secs=120;stat-cache-max-size-mb=52;type-cache-max-size-mb=7"

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /cache.
  • BUCKET_NAME: o nome do bucket do Cloud Storage.

Ativar a geração de registros de depuração

Por padrão, o Cloud Storage FUSE registra eventos com Info ou mais. É possível mudar as configurações de geração de registros usando qualquer um dos seguintes níveis de gravidade de registro, listados em ordem crescente:

  • trace
  • debug
  • info
  • warning
  • error
  • Para desativar toda a geração de registros, especifique o valor off.

Ao especificar um nível de gravidade, o Cloud Storage FUSE gera registros para eventos com um nível de gravidade igual ou maior que o especificado. Por exemplo, quando você especifica o nível warning, o Cloud Storage FUSE gera registros de avisos e erros.

Definir a gravidade do registro como níveis superiores a info pode afetar o desempenho e gerar uma grande quantidade de dados de registro. Por isso, recomendamos fazer isso apenas quando necessário. Para compatibilidade com o Cloud Logging, o formato de registro é text, e o formato json não é compatível.

A linha de comando a seguir ativa a geração de registros de depuração:

gcloud run worker-pools update WORKER_POOL \
    --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,mount-options="log-severity=debug"

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • BUCKET_NAME: o nome do bucket do Cloud Storage.
  • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /cache.

Desativar diretórios implícitos

Para que o Cloud Storage se pareça mais com um sistema de arquivos padrão, o Cloud Run ativa diretórios implícitos por padrão ao montar um bucket do Cloud Storage. É possível desativar os diretórios implícitos usando a opção de montagem implicit-dirs. Desativar diretórios implícitos pode melhorar o desempenho e o custo, mas tem prós e contras de compatibilidade.

O recurso de diretórios implícitos permite que o Cloud Run reconheça arquivos pré-existentes do Cloud Storage com nomes que imitam uma estrutura de diretórios, como /mydir/myfile.txt. Se você desativar os diretórios implícitos, o Cloud Run não poderá listar nem ler esses arquivos.

Desativar os diretórios implícitos reduz o número de solicitações ao Cloud Storage, o que pode melhorar o desempenho e o custo do aplicativo. Leia a documentação Arquivos e diretórios do Cloud Storage FUSE para saber mais.

A linha de comando a seguir desativa os diretórios implícitos:

gcloud run worker-pools update WORKER_POOL \
    --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,mount-options="implicit-dirs=false"

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • BUCKET_NAME: o nome do bucket do Cloud Storage.
  • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /cache.

Montar um diretório específico no bucket do Cloud Storage

Por padrão, o Cloud Run monta todo o bucket do Cloud Storage, o que permite que os pools de workers do Cloud Run acessem todo o conteúdo. Em alguns casos, talvez você queira montar apenas um diretório específico. Por exemplo, se o bucket tiver um grande número de arquivos, a montagem de um diretório específico pode melhorar o desempenho.

Também é possível implementar isso para fins de isolamento, em que você precisa que diferentes pools de workers tenham acesso a diferentes diretórios no bucket de armazenamento.

A linha de comando a seguir especifica o diretório a ser montado:

gcloud run worker-pools update WORKER_POOL \
    --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,mount-options="only-dir=images"

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • BUCKET_NAME: o nome do bucket do Cloud Storage.
  • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /cache.

Defina o volume UID e GID

Use as opções de montagem uid e gid para mudar o identificador de usuário e o identificador de grupo do volume. Isso é útil se você quiser definir a propriedade do arquivo para um usuário ou grupo específico que corresponda à identidade de um ou vários contêineres em execução. Por padrão, os volumes pertencem ao usuário raiz.

A linha de comando a seguir define uid e gid:

gcloud run worker-pools update WORKER_POOL \
    --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,mount-options="uid=UID;gid=GID"

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • MOUNT_PATH: o caminho relativo em que você está montando o volume, por exemplo, /cache.
  • BUCKET_NAME: o nome do bucket do Cloud Storage.
  • UID: ID do usuário para definir o volume.
  • GID: ID do grupo para definir o volume.

Definir outras opções de montagem

Confira a seguir a lista completa de todas as opções de montagem compatíveis com o Cloud Run.

Diretório

  • implicit-dirs
  • only-dir
  • rename-dir-limit

Debug

  • debug_fuse_errors
  • debug_fuse
  • debug_gcs
  • debug-invariants
  • debug_mutex

Cache

  • stat-cache-capacity
  • stat-cache-ttl
  • type-cache-ttl
  • enable-nonexistent-type-cache

Permissões

  • uid
  • gid
  • file-mode
  • dir-mode

Outro

  • billing-project
  • client-protocol
  • enable-buffered-read
  • experimental-enable-json-read
  • experimental-opentelemetry-collector-address
  • http-client-timeout
  • limit-bytes-per-sec
  • limit-ops-per-sec
  • max-conns-per-host
  • max-idle-conns-per-host
  • max-retry-sleep
  • -o
  • retry-multiplier
  • sequential-read-size-mb
  • stackdriver-export-interval

Para descrições detalhadas dessas opções, consulte Opções de montagem da linha de comando do Cloud Storage FUSE. A página do Cloud Storage FUSE lista todas as opções disponíveis do FUSE, algumas das quais não são compatíveis com o Cloud Run.

Otimizar o desempenho da largura de banda da rede do Cloud Storage FUSE

Para melhorar a performance de leitura e gravação, conecte seu pool de workers do Cloud Run a uma rede VPC usando a VPC direta e roteie todo o tráfego de saída pela rede VPC. Faça isso usando uma das opções a seguir:

Tempo de inicialização do contêiner e montagens do Cloud Storage FUSE

Usar o Cloud Storage FUSE pode aumentar um pouco o horário de início a frio do contêiner do Cloud Run porque o Cloud Run inicia a montagem do volume antes de iniciar o(s) contêiner(es). Seu contêiner só será iniciado se o Cloud Storage FUSE for montado corretamente.

O Cloud Storage FUSE só monta um volume após estabelecer uma conexão com o Cloud Storage. Qualquer atraso na rede pode afetar o tempo de inicialização do contêiner. Da mesma forma, se a tentativa de conexão falhar, o Cloud Storage FUSE não será montado e o pool de workers do Cloud Run não será iniciado. Além disso, se o Cloud Storage FUSE levar mais de 30 segundos para ser montado, o pool de workers do Cloud Run não vai ser iniciado porque o Cloud Run tem um tempo limite total de 30 segundos para realizar todas as montagens.

Características de desempenho do Cloud Storage FUSE

Se você definir dois volumes, cada um apontando para um bucket diferente, dois processos do Cloud Storage FUSE serão iniciados. As montagens e os processos ocorrem em paralelo.

As operações que usam o Cloud Storage FUSE são afetadas pela largura de banda da rede porque o Cloud Storage FUSE se comunica com o Cloud Storage usando a API Storage. Algumas operações, como listar o conteúdo de um bucket, podem ficar lentas se a largura de banda da rede estiver baixa. Da mesma forma, a leitura de um arquivo grande pode levar tempo, já que também é limitada pela largura de banda da rede.

Quando você grava em um bucket, o Cloud Storage FUSE organiza totalmente o objeto na memória. Isso significa que a gravação de arquivos grandes é limitada pela quantidade de memória disponível para a instância do contêiner (o limite máximo de memória do contêiner é de 32 GiB).

A gravação é transferida para o bucket somente quando você executa um close ou um fsync: o objeto completo é enviado ao bucket. A única exceção para um objeto que é totalmente reenviado para o bucket é no caso de um arquivo com conteúdo anexado quando o arquivo tem 2 MiB ou mais.

Para saber mais, acesse os recursos a seguir:

Limpar e remover volumes e montagens de volume

É possível limpar todos os volumes e montagens ou remover volumes e montagens de volume individuais.

Limpar todos os volumes e montagens de volume

Para limpar todos os volumes e montagens de volume do pool de workers de contêiner único, execute o seguinte comando:

gcloud run worker-pools update WORKER_POOL \
    --clear-volumes \
    --clear-volume-mounts
Se você tiver vários contêineres, siga as convenções da CLI de sidecars para limpar volumes e montagens de volume:

gcloud run worker-pools update WORKER_POOL \
    --container=container1 \
    --clear-volumes \
    --clear-volume-mounts \
    --container=container2 \
    --clear-volumes \
    --clear-volume-mounts

Remover volumes e montagens de volume individuais

Para remover um volume, você também precisa remover todas as montagens de volume que usam esse volume.

Para remover volumes ou montagens de volume individuais, use as flags remove-volume e remove-volume-mount:

gcloud run worker-pools update WORKER_POOL \
    --remove-volume VOLUME_NAME \
    --container=container1 \
    --remove-volume-mount MOUNT_PATH \
    --container=container2 \
    --remove-volume-mount MOUNT_PATH