Esta página foi traduzida pela API Cloud Translation.

Configure montagens de volumes NFS para pools de trabalhadores

Esta página mostra como montar uma partilha de ficheiros NFS como um volume no Cloud Run. Pode usar qualquer servidor NFS, incluindo o seu próprio servidor NFS alojado no local ou numa VM do Compute Engine. Se ainda não tiver um servidor NFS, recomendamos o Filestore, que é uma oferta NFS totalmente gerida da Google Cloud.

A montagem da partilha de ficheiros NFS como um volume no Cloud Run apresenta a partilha de ficheiros como ficheiros no sistema de ficheiros do contentor. Depois de montar a partilha de ficheiros como um volume, acede à mesma como se fosse um diretório no seu sistema de ficheiros local, usando as operações e as bibliotecas do sistema de ficheiros da sua linguagem de programação.

Caminhos não permitidos

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

Limitações

Para escrever num volume NFS, o seu contentor tem de ser executado como raiz. Se o seu contentor apenas ler a partir do sistema de ficheiros, pode ser executado como qualquer utilizador.
O Cloud Run não suporta o bloqueio de NFS. Os volumes NFS são montados automaticamente no modo sem bloqueio.

Antes de começar

Para montar um servidor NFS como um volume no Cloud Run, certifique-se de que tem o seguinte:

Uma rede VPC onde o servidor NFS ou a instância do Filestore está em execução.
Um servidor NFS em execução numa rede VPC, com o seu conjunto de trabalhadores do Cloud Run ligado a essa rede VPC. Se ainda não tiver um servidor NFS, crie um criando uma instância do Filestore.
O conjunto de trabalhadores do Cloud Run está associado à rede VPC onde o servidor NFS está em execução. Para um melhor desempenho, use a VPC direta em vez dos conectores de VPC.
Se estiver a usar um projeto existente, certifique-se de que a configuração da firewall da VPC permite que o Cloud Run alcance o seu servidor NFS. (Se estiver a começar com um novo projeto, esta opção está selecionada por predefinição.) Se estiver a usar o Filestore como servidor NFS, siga a documentação do Filestore para criar uma regra de saída da firewall para permitir que o Cloud Run alcance o Filestore.

Funções necessárias

Para ver uma lista de funções e autorizações de IAM associadas ao Cloud Run, consulte os artigos Funções de IAM do Cloud Run e Autorizações de IAM do Cloud Run. Se o seu conjunto de trabalhadores do Cloud Run interage com Google Cloud APIs, como as bibliotecas de clientes da nuvem, consulte o guia de configuração da identidade do serviço. Para mais informações sobre a atribuição de funções, consulte as autorizações de implementação e faça a gestão do acesso.

Monte um volume NFS

Pode montar vários servidores NFS, instâncias do Filestore ou outros tipos de volumes em diferentes caminhos de montagem.

Se estiver a usar vários contentores, especifique primeiro os volumes e, em seguida, especifique as montagens de volumes para cada contentor.

Configure uma montagem de volume NFS através da Google Cloud consola, da Google Cloud CLI ou do Terraform.

Consola

Na Google Cloud consola, aceda ao Cloud Run:

Aceda ao Cloud Run
Selecione Grupos de trabalhadores no menu e clique em Implementar contentor para configurar um novo grupo de trabalhadores. Se estiver a configurar um conjunto de trabalhadores existente, clique no conjunto de trabalhadores e, de seguida, em Editar e implementar nova revisão.
Se estiver a configurar um novo conjunto de trabalhadores, preencha a página inicial do conjunto de trabalhadores e, em seguida, clique em Recipientes, volumes, rede, segurança para expandir a página de configuração dos conjuntos de trabalhadores.
Clique no separador Volumes.
- Em Volumes, clique em Adicionar volume.
  - No menu pendente Tipo de volume, selecione NFS.
  - No campo Nome do volume, introduza o nome que quer usar para o volume.
  - No campo Servidor NFS, introduza o nome de domínio ou a localização (no formato IP_ADDRESS) da partilha de ficheiros NFS.
  - No campo Caminho, introduza o caminho para o diretório do servidor NFS que quer montar.
  - Clique em Concluído.
- Clique no separador Contentor, localize o contentor que quer montar e expanda os detalhes do contentor.
- Clique no separador Montagens de volumes.
- Clique em Montar volume.
Clique em Criar ou Implementar.

gcloud

Para adicionar um volume e montá-lo:
```
gcloud beta run worker-pools update WORKER_POOL \
--add-volume name=VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH
```
Substitua o seguinte:
- WORKER_POOL: o nome do seu conjunto de trabalhadores.
- VOLUME_NAME: o nome que quer dar ao volume.
- IP_ADDRESS: a localização da partilha de ficheiros NFS.
- NFS_PATH: o caminho para a partilha de ficheiros NFS que começa com uma barra invertida, por exemplo, /example-directory.
- MOUNT_PATH: o caminho relativo onde está a montar o volume, por exemplo, /mnt/my-volume.

Para montar o volume como um volume só de leitura:

--add-volume name=VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH,readonly=true

Se estiver a usar vários contentores, especifique primeiro os volumes e, em seguida, especifique as montagens de volumes para cada contentor:

gcloud beta run worker-pools update WORKER_POOL \
--add-volume name=VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH \
--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

Terraform

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

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

  template {
    containers {
      image = "IMAGE_URL"
      volume_mounts {
        name       = "VOLUME_NAME"
        mount_path = "MOUNT_PATH"
      }
    }
    vpc_access {
      network_interfaces {
        network    = "default"
        subnetwork = "default"
      }
    }

    volumes {
      name = "VOLUME_NAME"
      nfs {
        server    = google_filestore_instance.default.networks[0].ip_addresses[0]
        path      = "NFS_PATH"
        read_only = "IS_READ_ONLY"
      }
    }
  }
}

resource "google_filestore_instance" "default" {
  name     = "cloudrun-worker-pool"
  location = "REGION"
  tier     = "BASIC_HDD"

  file_shares {
    capacity_gb = 1024
    name        = "share1"
  }

  networks {
    network = "default"
    modes   = ["MODE_IPV4"]
  }
}

Substitua o seguinte:

WORKER_POOL: o nome do conjunto de trabalhadores.
REGION: a Google Cloud região, por exemplo, europe-west1.
IMAGE_URL: uma referência à imagem do contentor que contém o conjunto de trabalhadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
VOLUME_NAME: o nome do volume. O valor VOLUME_NAME é usado para mapear o volume para o volume de montagem.
MOUNT_PATH: o caminho relativo onde está a montar o volume, por exemplo, /mnt/my-volume.
NFS_PATH: o caminho para a partilha de ficheiros NFS.
IS_READ_ONLY: True para tornar o volume só de leitura ou False para permitir gravações.

Veja a configuração das variáveis de ambiente para o conjunto de trabalhadores

Na Google Cloud consola, aceda ao Cloud Run:

Aceda ao Cloud Run
Clique em Grupos de trabalhadores para apresentar a lista de grupos de trabalhadores implementados.
Clique no conjunto de trabalhadores que quer examinar para apresentar o respetivo painel de detalhes.
Clique no separador Contentores para apresentar a configuração do contentor do conjunto de trabalhadores.

Resolução de problemas de NFS

Se tiver problemas, verifique o seguinte:

O conjunto de trabalhadores do Cloud Run está ligado à rede VPC em que o servidor NFS se encontra.
Não existem regras de firewall que impeçam o Cloud Run de alcançar o servidor NFS.
Se o seu contentor escrever no seu servidor NFS, certifique-se de que está a ser executado como raiz.

Tempo de arranque do contentor e montagens de volume NFS

A utilização de montagens de volumes NFS pode aumentar ligeiramente o tempo de arranque a frio do contentor do Cloud Run, porque a montagem de volumes é iniciada antes do início dos contentores. O contentor só é iniciado se o NFS for montado com êxito.

Tenha em atenção que o NFS monta com êxito um volume apenas depois de estabelecer uma ligação ao servidor e obter um identificador de ficheiro. Se o Cloud Run não conseguir estabelecer uma ligação ao servidor, o grupo de trabalhadores do Cloud Run não é iniciado.

Além disso, quaisquer atrasos na rede podem ter um impacto no tempo de arranque do contentor, uma vez que o Cloud Run tem um limite de tempo total de 30 segundos para todas as montagens. Se a montagem do NFS demorar mais de 30 segundos, o grupo de trabalhadores do Cloud Run não é iniciado.

Caraterísticas de desempenho do NFS

Se criar mais do que um volume NFS, todos os volumes são montados em paralelo.

Uma vez que o NFS é um sistema de ficheiros de rede, está sujeito a limites de largura de banda e o acesso ao sistema de ficheiros pode ser afetado pela largura de banda limitada.

Quando escreve no seu volume NFS, a escrita é armazenada na memória do Cloud Run até que os dados sejam descarregados. Os dados são descarregados nas seguintes circunstâncias:

A sua aplicação esvazia os dados dos ficheiros explicitamente através de sync(2), msync(2) ou fsync(3).
A sua aplicação fecha um ficheiro com close(2).
A pressão da memória força a recuperação de recursos de memória do sistema.

Para mais informações, consulte a documentação do Linux sobre o NFS.

Limpe e remova volumes e montagens de volumes

Pode limpar todos os volumes e montagens ou remover volumes individuais e montagens de volumes.

Limpe todos os volumes e montagens de volumes

Para limpar todos os volumes e montagens de volumes do seu grupo de trabalhadores com um único contentor, execute o seguinte comando:

gcloud beta run worker-pools update WORKER_POOL \
    --clear-volumes
    --clear-volume-mounts

Se tiver vários contentores, siga as convenções da CLI de sidecars para limpar volumes e montagens de volumes:

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

Remova volumes individuais e montagens de volumes

Para remover um volume, também tem de remover todas as montagens de volumes que usam esse volume.

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

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