Configura activaciones de volúmenes en memoria para trabajos

Console

1. En la consola de Cloud de Confiance by S3NS , ve a la página Trabajos de Cloud Run:

   Ir a Trabajos de Cloud Run

2. Haz clic en Implementar contenedor para completar la página de configuración de trabajo inicial. Si quieres configurar un trabajo existente, selecciona el trabajo y, luego, haz clic en Ver y editar la configuración del trabajo.

3. Haz clic en Contenedores, Conexiones, Seguridad para expandir la página de propiedades del trabajo.

4. Haz clic en la pestaña Volúmenes.

5. Haz clic en Volumen de activación.

6. Haz clic en En memoria como el tipo de volumen.

7. Para configurar el volumen, haz lo siguiente:

   1. En el campo Ruta de activación, ingresa la ruta en la que deseas activar el volumen.
   2. En el campo Nombre del volumen, ingresa el nombre del volumen.
   3. Opcional: Ingresa el Límite de tamaño y la Unidad de memoria para especificar el límite de memoria que deseas asignar al volumen. Este límite debe ser menor que la memoria total especificada para tus contenedores. Los datos almacenados en este volumen consumen la memoria reservada por el contenedor que los escribió.
   4. Haz clic en Guardar.

8. Haz clic en Crear o Actualizar.

gcloud

• Para activar un volumen third_party/devsite/cloud/en/run/docs/images/nfs-volume-mount.png, haz lo siguiente:

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

  Reemplaza lo siguiente:

  • JOB: el nombre de tu trabajo.
  • MOUNT_PATH: La ruta de acceso relativa en el sistema de archivos del contenedor en el que deseas activar este volumen, por ejemplo, /mnt/my-volume
  • SIZE_LIMIT: Es el límite de memoria que deseas asignar al volumen, en MiB o GiB (especificado como Mi o Gi), por ejemplo, 500Mi. Este límite debe ser menor que la memoria total especificada para tus contenedores.

• Si usas varios contenedores, primero especifica los volúmenes y, luego, especifica las activaciones de volúmenes de cada contenedor:

  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. Si creas un trabajo nuevo, omite este paso. Si actualizas un trabajo existente, descarga su configuración de YAML:

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

2. Configura los atributos volumeMounts y volumes como se muestra a continuación:

   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

   Reemplaza lo siguiente:

   • IMAGE_URL: Es una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
   • VOLUME_NAME: Cualquier nombre que desees para tu volumen. El valor VOLUME_NAME se usa para asignar el volumen a la activación de volúmenes.
   • MOUNT_PATH: Es la ruta de acceso relativa dentro del sistema de archivos del contenedor en el que deseas activar este volumen, por ejemplo, /mnt/my-volume.
   • SIZE_LIMIT: Es el límite de memoria que deseas asignar al volumen, en MiB o GiB (especificado como Mi o Gi), por ejemplo, 500Mi. Este límite debe ser menor que la memoria total especificada para tus contenedores.

3. Crea o actualiza el servicio con el siguiente comando:

   gcloud run jobs replace job.yaml

   El comando gcloud run jobs replace usa de forma predeterminada el archivo job.yaml si está presente.

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de 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"
    }
      }
    }
  }
}

Reemplaza lo siguiente:

• JOB_NAME por el nombre del trabajo de Cloud Run.
• REGION por la región Cloud de Confiance . Por ejemplo, europe-west1.
• IMAGE_URL: Es una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• VOLUME_NAME: Cualquier nombre que desees para tu volumen. El valor VOLUME_NAME se usa para asignar el volumen a la activación de volúmenes
• MOUNT_PATH: Es la ruta de acceso relativa dentro del sistema de archivos del contenedor en el que deseas activar este volumen, por ejemplo, /mnt.
• SIZE_LIMIT: Es el límite de memoria que deseas asignar al volumen, en MiB o GiB (especificado como Mi o Gi), por ejemplo, 128Mi. Este límite debe ser menor que la memoria total especificada para tus contenedores.

Node.js

Usa el módulo del sistema de archivos para crear un archivo nuevo o agregarlo a uno existente en el volumen, /mnt/my-volume:

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

Python

Escribe en un archivo mantenido en el volumen, /mnt/my-volume:

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

Go

Usa el paquete os para crear un archivo nuevo mantenido en el volumen, /mnt/my-volume:

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

Java

Usa la clase Java.io.File para crear un archivo de registro en el volumen, /mnt/my-volume:

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