Configure montagens de volumes na memória para jobs

Console

1. No console Cloud de Confiance by S3NS , acesse a página do Cloud Run:

   Acessar o Cloud Run

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

   1. Se você estiver criando um job, clique em Implantar contêiner para preencher a página inicial de configurações do job.

   2. Se você estiver configurando um job, selecione-o e clique em Ler e editar a configuração do job.

3. Clique em Contêineres, conexões, segurança para expandir a página de propriedades do job.

4. Clique na guia Volumes.

5. Clique em Montar volume.

6. Clique em Na memória como o tipo de volume.

7. Configure o volume fazendo o seguinte:

   1. No campo Caminho de ativação, insira o caminho em que você quer ativar o volume.
   2. No campo Nome do volume, insira o nome do volume.
   3. Opcional: insira o Limite de tamanho e a Unidade de memória para especificar o limite de memória que você quer atribuir ao volume. Esse limite precisa ser menor que a memória total especificada para os contêineres. Os dados armazenados nesse volume consomem a memória reservada pelo contêiner que gravou os dados.
   4. Clique em Salvar.

8. Clique em Criar ou Atualizar.

gcloud

• Para montar um volume third_party/devsite/cloud/en/run/docs/images/nfs-volume-mount.png:

  gcloud run jobs update JOB \
    --add-volume mount-path=MOUNT_PATH,type=in-memory,size-limit=SIZE_LIMIT

  Substitua:

  • JOB: o nome do job.
  • MOUNT_PATH: o caminho relativo no sistema de arquivos do contêiner em que você quer montar esse volume, por exemplo, /mnt/my-volume.
  • SIZE_LIMIT: o limite de memória que você quer atribuir ao volume, em MiB ou GiB (especificado como Mi ou Gi), por exemplo, 500Mi. Esse limite precisa ser menor que a memória total especificada para os contêineres.

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

  gcloud run jobs update JOB \
    --add-volume=name= VOLUME_NAME,type=in-memory,size-limit=SIZE_LIMIT \
    --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 serviço, pule esta etapa. Se você estiver atualizando um serviço existente, faça o download da configuração YAML correspondente:

   gcloud run jobs describe JOB_NAME --format export > job.yaml

2. Configure os atributos volumeMounts e volumes conforme mostrado abaixo:

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB_NAME
   spec:
     template:
       spec:
         containers:
         - image: IMAGE_URL
           volumeMounts:
           - mountPath: MOUNT_PATH
             name: VOLUME_NAME
         volumes:
         - name: VOLUME_NAME
           emptyDir:
             sizeLimit: SIZE_LIMIT
             medium: Memory

   Substitua:

   • IMAGE_URL: uma referência à imagem do contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
   • VOLUME_NAME: qualquer nome que você queira dar ao volume. O valor VOLUME_NAME é usado para mapear o volume para a montagem associada.
   • MOUNT_PATH: o caminho relativo no sistema de arquivos do contêiner em que você quer montar esse volume. Por exemplo, /mnt/my-volume.
   • SIZE_LIMIT: o limite de memória que você quer atribuir ao volume, em MiB ou GiB (especificado como Mi ou Gi), por exemplo, 500Mi. Esse limite precisa ser menor que a memória total especificada para os contêineres.

3. Crie ou atualize o serviço usando o seguinte comando:

   gcloud run jobs replace job.yaml

   Por padrão, o comando gcloud run jobs replace usa o arquivo job.yaml, 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_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"
    }
      }
    }
  }
}

Substitua:

• JOB_NAME: o nome do seu job do Cloud Run;
• REGION com a região Cloud de Confiance . Por exemplo, europe-west1.
• IMAGE_URL: uma referência à imagem do contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• VOLUME_NAME: qualquer nome que você queira dar ao volume. O valor VOLUME_NAME é usado para mapear o volume para a montagem associada.
• MOUNT_PATH: o caminho relativo no sistema de arquivos do contêiner em que você quer montar esse volume, por exemplo, /mnt.
• SIZE_LIMIT: o limite de memória que você quer atribuir ao volume, em MiB ou GiB (especificado como Mi ou Gi), por exemplo, 128Mi. Esse limite precisa ser menor que a memória total especificada para os contêineres.

Nodejs

Use o módulo "Sistema de arquivos" para criar um novo arquivo ou adicionar ao final de um arquivo 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");