Configura límites de memoria

Puedes aprovisionar tu trabajo de Cloud Run con diferentes quantidades de memoria. En esta página, se describe cómo especificar la cantidad de memoria disponible para tu trabajo.

Comprende el uso de la memoria

Las instancias de Cloud Run que superan el límite de memoria permitido se finalizan.

Las siguientes acciones se consideran en la cantidad de memoria disponible de la instancia:

  • Ejecutar el ejecutable del trabajo, ya que este debe cargarse en la memoria
  • Asignar memoria en el proceso de trabajo
  • Cómo escribir archivos en el sistema de archivos

El tamaño de la imagen de contenedor implementada no se considera en la cantidad de memoria disponible.

Configura y actualiza los límites de memoria

Puedes establecer límites de memoria en los trabajos de Cloud Run. De forma predeterminada, la memoria asignada a cada trabajo es de 512 MiB.

CPU mínima requerida

La cantidad de memoria asignada que eliges corresponde a una cantidad de CPU asignada para tu trabajo. Cuando se establece un límite de memoria, se requieren los siguientes límites mínimos de CPU:

Memoria Cantidad mínima de CPU necesarias
128 MiB .083 vCPU
256 MiB .167 vCPU
512 MiB .333 vCPU
1 GiB .583 vCPU
2 GiB 1 CPU virtual
Más de 4 GiB 2 vCPU
Más de 8 GiB 4 CPU virtuales
Más de 16 GiB 6 CPU virtuales
Más de 24 GiB 8 CPU virtuales

Cantidad máxima de memoria

La cantidad máxima de memoria que puedes configurar es de 32 gibibyte (32 Gi).

Memoria mínima

La cantidad mínima de memoria que puedes configurar en el entorno de ejecución de segunda generación es de 512 MiB.

Roles obligatorios

Para obtener los permisos que necesitas para configurar los trabajos de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta Roles de IAM de Cloud Run y Permisos de IAM de Cloud Run. Si tu trabajo de Cloud Run interactúa con las APIs de Google Cloud, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información acerca de cómo otorgar roles, consulta Permisos de implementación y Administra el acceso.

Configura límites de memoria

Debes especificar un mínimo de 512 Mi para un trabajo de Cloud Run. Para especificar la memoria de un trabajo de Cloud Run, sigue estos pasos:

Console

  1. En la consola de Google Cloud, ve a la página de trabajos de Cloud Run:

    Ir a Cloud Run

  2. Haz clic en Implementar contenedor y selecciona Trabajo 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 Editar.

  3. Haz clic en Contenedor, variables y secretos, conexiones y seguridad para expandir la página de propiedades del trabajo.

  4. Haz clic en la pestaña Contenedor.

    imagen

    • Selecciona el tamaño de memoria deseado de la lista desplegable Memoria asignada.

  5. Haz clic en Crear o Actualizar.

gcloud

  1. Para establecer límites de memoria cuando creas un trabajo, haz lo siguiente:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --memory SIZE

    Reemplaza lo siguiente:

    • JOB_NAME por el nombre de tu trabajo.
    • IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest
    • SIZE por el tamaño de memoria deseado El formato del tamaño es un número de punto fijo o flotante seguido de una unidad: G o M, que corresponde a gigabytes o megabytes, respectivamente, o usa equivalentes a la potencia de dos: Gi o Mi correspondientes a gibibyte o mebibyte, respectivamente.

  2. Para establecer límites de memoria cuando actualizas un trabajo, haz lo siguiente:

    gcloud run jobs update JOB_NAME --memory SIZE

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. Actualiza el atributo memory:

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
      containers:
      - image: IMAGE
        resources:
          limits:
            memory: SIZE

    Reemplaza SIZE por el tamaño de memoria deseado y especifica un mínimo de 512 Mi. El formato es un número fijo o de punto flotante seguido de una unidad: G o M correspondiente a gigabyte o megabyte, respectivamente, o usa la potencia de dos equivalentes: Gi o Mi que corresponde a gibibyte o mebibyte, respectivamente.

    También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.

  3. Actualiza la configuración del trabajo existente:

    gcloud run jobs replace job.yaml

Visualiza la configuración del límite de memoria

Para ver la configuración actual del límite de memoria de tu trabajo de Cloud Run, sigue estos pasos:

Console

  1. En la consola de Google Cloud, ve a la página de trabajos de Cloud Run:

    Ir a Trabajos de Cloud Run

  2. Haz clic en el trabajo que te interesa para abrir la página Detalles del trabajo.

  3. Haz clic en la pestaña Configuración.

  4. Ubica la configuración del límite de memoria en los detalles de configuración.

gcloud

  1. Usa el siguiente comando:

    gcloud run jobs describe JOB_NAME

  2. Ubica la configuración del límite de memoria en la configuración que se muestra.