Configura el tiempo de espera de solicitudes para los servicios

La configuración del tiempo de espera de las solicitudes de Cloud Run te permite definir el tiempo máximo que tiene un servicio para devolver una respuesta. Si tu servicio no responde dentro de este límite, Cloud Run cierra la conexión de red y devuelve un error HTTP 504.

Cerrar la conexión no finaliza la instancia de contenedor. Es posible que el contenedor siga procesando la solicitud anulada, lo que puede interferir en el manejo de otras solicitudes. Para evitar que se agote el tiempo de espera, establece un tiempo de espera superior al tiempo de ejecución esperado o haz un seguimiento del tiempo de ejecución restante para realizar la limpieza y volver antes.

Período de tiempo de espera para los servicios

El tiempo de espera se establece de forma predeterminada en 5 minutos (300 segundos) y se puede extender hasta 60 minutos (3600 segundos). Puedes cambiar este parámetro cuando implementas una imagen de contenedor o actualizas la configuración del servicio.

Cuando activas tu servicio desde eventos de Eventarc, suscripciones de envío de Pub/Sub, Cloud Scheduler, Cloud Tasks o Workflows, se aplican los tiempos de espera de esos servicios. Por ejemplo:

  • Las suscripciones de envío de Pub/Sub (tanto los activadores directos como los de Eventarc) tienen un plazo de confirmación predeterminado de 10 segundos y un máximo de 10 minutos (600 segundos).

  • Los destinos HTTP de Cloud Scheduler (3 minutos de forma predeterminada), los destinos HTTP de Cloud Tasks (10 minutos de forma predeterminada) y las solicitudes HTTP síncronas de Workflows (5 minutos de forma predeterminada) tienen un tiempo de espera máximo de 30 minutos (1,800 segundos).

  • Para las cargas de trabajo invocadas por Workflows que se ejecutan durante más de 30 minutos, usa trabajos de Cloud Run o extremos de devolución de llamada.

Además de cambiar el tiempo de espera de las solicitudes de Cloud Run, verifica el framework del lenguaje para ver si tiene su propia configuración de tiempo de espera de solicitudes que debes actualizar. Es posible que algunos clientes del servicio de Cloud Run también impongan un tiempo de espera más restrictivo.

Roles obligatorios

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

Si implementas un servicio o una función desde el código fuente, también debes tener roles adicionales otorgados en tu proyecto y en la cuenta de servicio de Cloud Build.

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

Configura y actualiza el tiempo de espera de las solicitudes

Cualquier cambio en la configuración conlleva la creación de una revisión nueva. Las revisiones posteriores también adoptarán esta configuración de manera automática, a menos que realices actualizaciones explícitas para cambiarla.

Puedes configurar el tiempo de espera de las solicitudes con la consola de Google Cloud , la línea de comandos de gcloud CLI o un archivo YAML cuando creas un servicio nuevo o implementas una revisión nueva.

Console

  1. En la consola Google Cloud , ve a Cloud Run:

    Ir a Cloud Run

  2. Selecciona Servicios en el menú de navegación de Cloud Run:

    1. Si configuras un servicio nuevo, haz clic en Implementar contenedor y completa la página de configuración inicial del servicio. Luego, haz clic en Contenedores, Herramientas de redes, Seguridad para expandir la página de configuración del servicio.

    2. Si quieres configurar un servicio existente, haz clic en el servicio y, luego, en la pestaña Ajuste de escala.

  3. En Solicitudes, en el campo Tiempo de espera de la solicitud, ingresa el valor de tiempo de espera que deseas usar en segundos. Usa valores que varían de 1 a 3600 segundos.

  4. Haz clic en Crear para un servicio nuevo. Haz clic en Ver diferencia y volver a implementar y, luego, en Implementar cambios para un servicio existente.

gcloud

Puedes actualizar el tiempo de espera de la solicitud para una revisión determinada en cualquier momento mediante el siguiente comando:

gcloud run services update SERVICE --timeout=TIMEOUT

Reemplaza lo siguiente:

  • SERVICE: Es el nombre de tu servicio.
  • TIMEOUT: Es el tiempo en el que se debe devolver una respuesta, con un valor de número entero o un valor de duración absoluta, por ejemplo, 1m20s, que es 1 minuto, 20 segundos. Si usas un valor de número entero, se supone que la unidad será en segundos. El valor que especifiques debe ser inferior a 60 minutos.

También puedes configurar el tiempo de espera de las solicitudes durante la implementación mediante el siguiente comando:

gcloud run deploy --image IMAGE_URL --timeout=TIMEOUT

Reemplaza lo siguiente:

  • IMAGE_URL: una referencia a la imagen de contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/hello:latest. Si usas Artifact Registry, el repositorio REPO_NAME debe estar creado. La URL sigue el formato de LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • TIMEOUT: Es el tiempo en el que se debe devolver una respuesta, con un valor de número entero o de duración, por ejemplo, 1m20s, que es 1 minuto, 20 segundos. Si usas un valor de número entero, se supone que la unidad será en segundos. El valor que especifiques debe ser inferior a 60 minutos.

YAML

  1. Si creas un servicio nuevo, omite este paso. Si actualizas un servicio existente, descarga su configuración de YAML:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Actualiza el atributo timeoutSeconds:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          timeoutSeconds: VALUE

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: una referencia a la imagen de contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/hello:latest. Si usas Artifact Registry, el repositorio REPO_NAME debe estar creado. La URL sigue el formato de LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • VALUE: Es el tiempo de espera elegido, en segundos.
  3. Crea o actualiza el servicio con el siguiente comando:

    gcloud run services replace service.yaml

    El comando gcloud run services replace usa el archivo service.yaml de forma predeterminada 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.

Agrega lo siguiente a un recurso google_cloud_run_v2_service en tu configuración de Terraform:

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-request-timeout"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    # Timeout
    timeout = "300s"
  }
}

Reemplaza 300s por el tiempo de espera de la solicitud que elegiste para tu servicio.

Visualiza la configuración de tiempo de espera de solicitudes

Para ver la configuración actual de tiempo de espera de solicitudes de tu servicio de Cloud Run, sigue estos pasos:

Console

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

    Ir a Cloud Run

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

  3. Haz clic en la pestaña Ajuste de escala para ver la configuración.

gcloud

  1. Usa el siguiente comando:

    gcloud run services describe SERVICE
  2. Busca la configuración de tiempo de espera de solicitudes en la configuración que se muestra.