Configure montagens de volumes na memória para tarefas

Esta página descreve como configurar um volume dedicado na memória que pode usar para leituras e escritas de ficheiros através de montagens de volumes do Cloud Run. Tenha em atenção que esta funcionalidade difere do sistema de ficheiros na memória integrado fornecido pelo Cloud Run.

Quando monta o volume na memória no Cloud Run, o volume na memória é apresentado como ficheiros no sistema de ficheiros do contentor. Depois de montar o volume na memória, acede ao mesmo como se fosse um diretório no sistema de ficheiros local, usando as operações e as bibliotecas do sistema de ficheiros da sua linguagem de programação.

Pode usar volumes na memória para fazer o seguinte:

• Limitar o tamanho do volume na memória. Quando limita o tamanho de um volume, as escritas num volume cheio falham, o que é preferível a ter instâncias do Cloud Run terminadas porque o volume está a consumir demasiada memória.
• Partilhe um volume na memória entre diferentes contentores numa instância do Cloud Run. Quando o Cloud Run é dimensionado horizontalmente para várias instâncias de uma tarefa de trabalho, cada tarefa tem o seu próprio volume na memória partilhado por todos os contentores nessa tarefa. Este volume está disponível para todos os contentores quando o Cloud Run é dimensionado para processar o tráfego.

Comportamento

Ao criar um volume na memória, recomendamos que especifique um limite de tamanho. Se o volume atingir o limite de tamanho, as gravações adicionais falham com um erro de falta de memória. A sua instância pode processar este erro e continuar a ser executada.

Tenha em atenção que o limite de tamanho é apenas um limite: não atribui espaço adicional ao seu volume na memória. Em vez disso, o volume na memória consome a memória que configurou para os seus contentores. Se implementar vários contentores, a memória usada por cada gravação no volume conta como utilização de memória para o contentor que escreveu os dados.

Se não especificar um limite de tamanho, este é definido automaticamente para metade do tamanho total de todos os contentores no seu trabalho ou serviço. Por exemplo, emptyDir tamanho do volume = [Memória (recipiente A) + Memória (recipiente B) + Memória (recipiente N)]/2. Este comportamento predefinido pode resultar num limite de tamanho do volume na memória superior à memória alocada para alguns dos seus contentores. Isto pode levar a falhas inesperadas se um único contentor exceder a respetiva memória alocada ao tentar escrever mais dados no volume, mesmo que o limite de tamanho do volume não tenha sido atingido.

Embora a definição de um limite de tamanho seja opcional, recomendamos que defina um para proteger os seus contentores de ficarem sem memória e falharem.

Caminhos não permitidos

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

Funções necessárias

Para receber as autorizações de que precisa para configurar tarefas do Cloud Run, peça ao seu administrador para lhe conceder as seguintes funções de IAM:

• Programador do Cloud Run (roles/run.developer) na tarefa do Cloud Run
• Utilizador da conta de serviço (roles/iam.serviceAccountUser) na identidade do serviço

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 a sua tarefa do Cloud Run interagir com Google Cloud APIs, como as bibliotecas de cliente da Google Cloud, 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.

Configure um volume na memória

Qualquer alteração de configuração leva à criação de uma nova revisão. As revisões subsequentes também vão receber automaticamente esta definição de configuração, a menos que faça atualizações explícitas para a alterar.

Depois de configurar um volume na memória para o seu serviço do Cloud Run, é criado um volume vazio para cada instância do Cloud Run iniciada e o volume existe enquanto essa instância estiver em execução. Quando a instância deixa de ser executada, os dados no volume são eliminados permanentemente.

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "IMAGE_URL"
    volume_mounts {
      name = "VOLUME_NAME"
      mount_path = "MOUNT_PATH"
    }
      }
      volumes {
        name = "VOLUME_NAME"
    empty_dir {
      medium = "MEMORY"
      size_limit = "SIZE_LIMIT"
    }
      }
    }
  }
}

Ler e escrever num volume

Se usar a funcionalidade de montagem de volumes do Cloud Run, acede a um volume montado através das mesmas bibliotecas no seu idioma de programação que usa para ler e escrever ficheiros no seu sistema de ficheiros local.

Isto é especialmente útil se estiver a usar um contentor existente que espera que os dados sejam armazenados no sistema de ficheiros local e usa operações regulares do sistema de ficheiros para aceder aos mesmos.

Os seguintes fragmentos pressupõem uma montagem de volume com um mountPath definido como /mnt/my-volume.

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

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

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

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

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 da sua tarefa de contentor único, execute o seguinte comando:

gcloud run jobs update JOB \
    --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 run jobs update JOB \
    --clear-volumes \
    --clear-volume-mounts \
    --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 run jobs update JOB \
    --remove-volume VOLUME_NAME
    --container=container1 \
    --remove-volume-mount MOUNT_PATH \
    --container=container2 \
    --remove-volume-mount MOUNT_PATH