Configura las verificaciones de estado de contenedores para los servicios

Las verificaciones de estado de Cloud Run garantizan que tus instancias de contenedor se ejecuten correctamente y puedan entregar tráfico. Con las verificaciones de estado de Cloud Run, puedes personalizar cuándo tu contenedor está listo para recibir solicitudes y cuándo se debe considerar que tu contenedor está en mal estado para requerir un reinicio.

Casos de uso

Puedes configurar los siguientes tipos de sondeos de verificación de estado:

  • Los sondeos de inicio determinan si el contenedor se inició y está listo para aceptar tráfico.

    • Cuando configuras un sondeo de inicio, las verificaciones de funcionamiento y preparación se inhabilitan hasta que el sondeo de inicio determina que el contenedor se inicia para evitar interferencias en el inicio del servicio.
    • Los sondeos de inicio son útiles en especial si usas verificaciones en funcionamiento en contenedores de inicio lento, ya que evita que se cierren prematuramente antes de que los contenedores estén en funcionamiento.
  • Los sondeos de funcionamiento determinan si el contenedor se debe reiniciar.

    • En este caso, reiniciar un contenedor puede aumentar la disponibilidad del servicio en caso de errores.
    • Los sondeos de funcionamiento están diseñados para reiniciar instancias individuales que no se pueden recuperar de ninguna otra manera. Se deben usar en particular para fallas de instancias irrecuperables, como detectar un interbloqueo en el que se ejecuta un servicio, pero no puede avanzar. Puedes solicitar una prueba de funcionamiento para cada contenedor con las políticas de la organización personalizadas.
    • Cuando un servicio experimenta fallas repetidas de sondeo, Cloud Run limita los reinicios de las instancias para evitar bucles de fallas no controlados.
  • Sondeos de preparación

    Los sondeos de preparación determinan cuándo una instancia de tu servicio de Cloud Run debe entregar tráfico. Las verificaciones de preparación comienzan después de que el sondeo de inicio del contenedor se aprueba correctamente. Si una instancia falla en su sondeo de preparación más allá del valor de umbral de falla que configures, Cloud Run dejará de enviarle tráfico nuevo. Cloud Run no finaliza la instancia y vuelve a enviar tráfico a la instancia cuando comienza a pasar su sondeo de preparación de nuevo.

Tu contenedor debe implementar los sondeos de inicio, funcionamiento y preparación de forma coherente. Una vez que se aprueba la verificación de inicio, Cloud Run considera que tu contenedor está listo para entregar tráfico.

Te recomendamos que encapsules tu lógica para que el sondeo de inicio tenga en cuenta la preparación. Dado que Cloud Run puede enrutar el tráfico a una instancia nueva antes de que se complete el primer sondeo de preparación, asegúrate de que pasar el sondeo de inicio también garantice la preparación para entregar tráfico de forma segura de inmediato. Cuando el sondeo de inicio se realiza correctamente, consideramos que el contenedor está listo para recibir tráfico.

Configura sondeos de inicio

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 sondeos de HTTP, TCP y gRPC a través de la consola de Google Cloud , YAML o Terraform:

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 estás configurando 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 Contenedores.

  3. En la sección Verificaciones de estado, haz clic en Agregar verificación de estado para abrir el panel de configuración Agregar verificación de estado.

  4. En el menú Seleccionar el tipo de verificación de estado, selecciona Verificación de inicio.

  5. En el menú Seleccionar tipo de sondeo, selecciona el tipo de sondeo que quieras usar, por ejemplo, HTTP o gRPC. Se mostrará el formulario de configuración del sondeo. La configuración del sondeo varía según el tipo de sondeo. Establece la configuración del sondeo:

    • Si usas sondeos de HTTP, realiza lo siguiente:

      • Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.
      • Usa el campo Ruta de acceso para especificar la ruta de acceso relativa al extremo, por ejemplo, /.
      • Selecciona la casilla de verificación Encabezados HTTP para especificar encabezados personalizados opcionales. Especifica el nombre del encabezado en el campo Nombre y el valor del encabezado en el campo Valor. Haz clic en Agregar encabezado HTTP para especificar más encabezados.
    • Si usas sondeos de gRPC, haz lo siguiente:

    • En Puerto, especifica el puerto de contenedor que se usa para el servicio.

    • En Retraso inicial, especifica la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.

    • En Período, especifica el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 600 segundos (1,800 para GPU). El valor predeterminado es 10 segundos.

    • En Umbral de falla, especifica la cantidad de veces que se debe reintentar el sondeo antes de apagar el contenedor. El valor predeterminado es 3.

    • En Tiempo de espera, especifica la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 600 (1,800 para GPU). El valor predeterminado es 1.

  6. Haz clic en Agregar para agregar el umbral nuevo.

  7. 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.

Para borrar un sondeo, haz clic en el ícono Borrar de la verificación de estado que deseas borrar y, luego, en Confirmar. Para implementar una revisión nueva de tu servicio de Cloud Run, haz clic en Ver diferencias y volver a implementar y, luego, en Implementar cambios.

gcloud

Inicio de TCP

Ejecuta el comando siguiente:

  gcloud run deploy SERVICE \
      --image=IMAGE_URL \
      --startup-probe tcpSocket.port=CONTAINER_PORT,initialDelaySeconds=DELAY,failureThreshold=THRESHOLD,timeoutSeconds=TIMEOUT,periodSeconds=PERIOD

Reemplaza lo siguiente:

  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • Es opcional. CONTAINER_PORT: Es el puerto de contenedor que se usa para el servicio.
  • DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 600 (1,800 para GPU). El valor predeterminado es 1.
  • THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
  • PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 600 segundos (1,800 para GPU). El valor predeterminado es 10 segundos.

Inicio de HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

Ejecuta el comando siguiente:

  gcloud run deploy SERVICE \
      --image=IMAGE_URL \
      --startup-probe httpGet.path=PATH,httpGet.port=CONTAINER_PORT,initialDelaySeconds=DELAY,failureThreshold=THRESHOLD,timeoutSeconds=TIMEOUT,periodSeconds=PERIOD

Reemplaza lo siguiente:

  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • PATH: Es una ruta de acceso relativa al extremo HTTP, por ejemplo, /health.
  • Es opcional. CONTAINER_PORT: Se configura como el puerto del contenedor que se usa para el servicio.
  • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
  • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se debe esperar hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 600 (1,800 para GPU). El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 600 segundos (1,800 para GPU). El valor predeterminado es 10 segundos.

Inicio de gRPC

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

Ejecuta el comando siguiente:

  gcloud run deploy SERVICE \
      --image=IMAGE_URL \
      --startup-probe grpc.port=CONTAINER_PORT,grpc.service=GRPC_SERVICE,initialDelaySeconds=DELAY,failureThreshold=THRESHOLD,timeoutSeconds=TIMEOUT,periodSeconds=PERIOD

Reemplaza lo siguiente:

  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • Es opcional. GRPC_SERVICE: Si se establece, se usa en el campo de servicio de grpc.health.v1.HealthCheckRequest cuando se llama a la RPC de grpc.health.v1.Health.Check.
  • Es opcional. CONTAINER_PORT: Es el puerto de contenedor que se usa para el servicio.
  • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
  • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se debe esperar hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 600 (1,800 para GPU). El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 600 segundos (1,800 para GPU). El valor predeterminado es 10 segundos.

YAML

Inicio de TCP

  1. Configura el atributo startupProbe como se muestra a continuación:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
     name: SERVICE
    spec:
     template:
       metadata:
       spec:
         containers:
         - image: IMAGE_URL
           startupProbe:
             tcpSocket:
               port: CONTAINER_PORT
             initialDelaySeconds: DELAY
             timeoutSeconds: TIMEOUT
             failureThreshold: THRESHOLD
             periodSeconds: PERIOD

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • Es opcional. CONTAINER_PORT: Es el puerto de contenedor que se usa para el servicio.
    • DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
    • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 600 (1,800 para GPU). El valor predeterminado es 1.
    • THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
    • PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 600 segundos (1,800 para GPU). El valor predeterminado es 10 segundos.

Inicio de HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

  1. Configura el atributo startupProbe como se muestra a continuación:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
        spec:
          containers:
          - image: IMAGE_URL
            startupProbe:
              httpGet:
                path: PATH
                port: CONTAINER_PORT
                httpHeaders:
                  - name: HEADER_NAME
                    value: HEADER_VALUE
              initialDelaySeconds: DELAY
              timeoutSeconds: TIMEOUT
              failureThreshold: THRESHOLD
              periodSeconds: PERIOD

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • PATH: Es una ruta de acceso relativa al extremo HTTP, por ejemplo, /health.
    • Es opcional. CONTAINER_PORT: Se configura como el puerto del contenedor que se usa para el servicio.
    • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
    • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
    • Opcional: Se puede usar httpHeaders para proporcionar varios encabezados personalizados o repetidos con los campos HEADER_NAME y HEADER_VALUE, como se muestra.
    • Es opcional. TIMEOUT: Es la cantidad de segundos que se debe esperar hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 600 (1,800 para GPU). El valor predeterminado es 1.
    • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 600 segundos (1,800 para GPU). El valor predeterminado es 10 segundos.

Inicio de gRPC

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

  1. Configura el atributo startupProbe como se muestra a continuación:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
        spec:
          containers:
          - image: IMAGE_URL
            startupProbe:
              grpc:
                service: GRPC_SERVICE
                port: CONTAINER_PORT
              initialDelaySeconds: DELAY
              timeoutSeconds: TIMEOUT
              failureThreshold: THRESHOLD
              periodSeconds: PERIOD

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • Es opcional. GRPC_SERVICE: Si se establece, se usa en el campo de servicio de grpc.health.v1.HealthCheckRequest cuando se llama a la RPC de grpc.health.v1.Health.Check.
    • Es opcional. CONTAINER_PORT: Es el puerto de contenedor que se usa para el servicio.
    • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
    • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
    • Es opcional. TIMEOUT: Es la cantidad de segundos que se debe esperar hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 600 (1,800 para GPU). El valor predeterminado es 1.
    • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 600 segundos (1,800 para GPU). El valor predeterminado es 10 segundos.

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Inicio de TCP

Configura el servicio de Cloud Run con el atributo startup_probe como se muestra a continuación:

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

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      startup_probe {
        failure_threshold     = 5
        initial_delay_seconds = 10
        timeout_seconds       = 3
        period_seconds        = 3

        tcp_socket {
          port = 8080
        }
      }
    }
  }
}

Inicio de HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

Configura el servicio de Cloud Run con el atributo startup_probe como se muestra a continuación:

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

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      startup_probe {
        failure_threshold     = 5
        initial_delay_seconds = 10
        timeout_seconds       = 3
        period_seconds        = 3

        http_get {
          path = "/"
          # Custom headers to set in the request
          # https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/cloud_run_v2_service#http_headers
          http_headers {
            name  = "Access-Control-Allow-Origin"
            value = "*"
          }
        }
      }
    }
  }
}

Inicio de gRPC

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

Configura el servicio de Cloud Run con el atributo startup_probe como se muestra a continuación:

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

  deletion_protection = false # set to "true" in production

  template {
    containers {
      # Note: Change to the name of your image
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      startup_probe {
        failure_threshold     = 5
        initial_delay_seconds = 10
        timeout_seconds       = 3
        period_seconds        = 3

        grpc {
          # Note: Change to the name of your pre-existing grpc health status service
          service = "grpc.health.v1.Health"
        }
      }
    }
  }
}

El sondeo de inicio de TCP predeterminado

Si no configuras de forma explícita un sondeo de inicio de TCP para un servicio nuevo de Cloud Run, Cloud Run configura automáticamente un sondeo de inicio de TCP con los siguientes valores predeterminados:

startupProbe:
          timeoutSeconds: 240
          periodSeconds: 240
          failureThreshold: 1

Puedes cambiar estos valores predeterminados según las instrucciones de la sección Configuración de sondeo en esta página.

Requisitos y comportamiento del sondeo de inicio

Tipo de sondeo Requisitos Comportamiento
Inicio de TCP Ninguno De forma predeterminada, Cloud Run realiza una conexión TCP para abrir el socket TCP en el puerto especificado. Si Cloud Run no puede establecer una conexión, indica un error.

Si un sondeo de inicio no se realiza de forma correcta dentro del tiempo especificado (failureThreshold * periodSeconds), que no puede superar los 600 segundos (1,800 para GPU), el contenedor se cierra. Consulta también Valores predeterminados de TCP.
Inicio de HTTP Crea un extremo de verificación de estado HTTP
Usa HTTP/1
Después de configurar el sondeo, Cloud Run realiza una solicitud GET de HTTP al extremo de verificación de estado (por ejemplo, /health). Cualquier respuesta 2XX o 3XX es un éxito, todo lo demás indica un error.

Si un sondeo de inicio no se realiza de forma correcta dentro del tiempo especificado (failureThreshold * periodSeconds), que no puede superar los 600 segundos (1,800 para GPU), el contenedor se cierra.

Si el sondeo de inicio HTTP se realiza de forma correcta dentro del tiempo especificado y configuraste un sondeo de funcionamiento de HTTP, se inicia el sondeo de funcionamiento de HTTP.
Inicio de gRPC Implementa el protocolo de verificación de estado de gRPC en tu servicio de Cloud Run. Si un sondeo de inicio no se completa de forma correcta dentro del tiempo especificado (failureThreshold * periodSeconds), que no puede superar los 600 segundos (1,800 para GPU), el contenedor se cierra.

Configura los sondeos de funcionamiento

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 sondeos de HTTP y gRPC con la consola de Google Cloud , YAML o Terraform:

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 estás configurando 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 Contenedores.

  3. En la sección Verificaciones de estado, haz clic en Agregar verificación de estado para abrir el panel de configuración Agregar verificación de estado.

  4. En el menú Seleccionar el tipo de verificación de estado, selecciona Verificación de funcionamiento.

  5. En el menú Seleccionar tipo de sondeo, selecciona el tipo de sondeo que quieras usar, por ejemplo, HTTP o gRPC. Se mostrará el formulario de configuración del sondeo.

  6. La configuración del sondeo varía según el tipo de sondeo. Establece la configuración del sondeo:

    • Si usas sondeos de HTTP, realiza lo siguiente:

      • Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.
      • Usa el campo Ruta de acceso para especificar la ruta de acceso relativa al extremo, por ejemplo, /.
      • Selecciona la casilla de verificación Encabezados HTTP para especificar encabezados personalizados opcionales. Especifica el nombre del encabezado en el campo Nombre y el valor del encabezado en el campo Valor. Haz clic en Agregar encabezado HTTP para especificar más encabezados.
    • Si usas sondeos de gRPC, haz lo siguiente:

    • En Puerto, especifica el puerto de contenedor que se usa para el servicio.

    • En Retraso inicial, especifica la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.

    • En Período, especifica el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 3,600 segundos. El valor predeterminado es 10 segundos.

    • En Umbral de falla, especifica la cantidad de veces que se debe reintentar el sondeo antes de apagar el contenedor. El valor predeterminado es 3.

    • En Tiempo de espera, especifica la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 3,600. El valor predeterminado es 1.

  7. Haz clic en Agregar para agregar el umbral nuevo.

  8. 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.

Para borrar un sondeo, haz clic en el ícono Borrar de la verificación de estado que deseas borrar y, luego, en Confirmar. Para implementar una revisión nueva de tu servicio de Cloud Run, haz clic en Ver diferencias y volver a implementar y, luego, en Implementar cambios.

gcloud

Activo de HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

Ejecuta el comando siguiente:

  gcloud run deploy SERVICE \
      --image=IMAGE_URL \
      --liveness-probe httpGet.path=PATH,httpGet.port=CONTAINER_PORT,initialDelaySeconds=DELAY,failureThreshold=THRESHOLD,timeoutSeconds=TIMEOUT,periodSeconds=PERIOD

Reemplaza lo siguiente:

  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • PATH: Es una ruta de acceso relativa al extremo HTTP, por ejemplo, /health.
  • Es opcional. CONTAINER_PORT: Se configura como el puerto del contenedor que se usa para el servicio.
  • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
  • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 3,600.El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 3,600 segundos. El valor predeterminado es 10 segundos.

gRPC en funcionamiento

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

Ejecuta el comando siguiente:

  gcloud run deploy SERVICE \
      --image=IMAGE_URL \
      --liveness-probe grpc.port=CONTAINER_PORT,grpc.service=GRPC_SERVICE,initialDelaySeconds=DELAY,failureThreshold=THRESHOLD,timeoutSeconds=TIMEOUT,periodSeconds=PERIOD

Reemplaza lo siguiente:

  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • Es opcional. GRPC_SERVICE: Si se establece, se usa en el campo de servicio de grpc.health.v1.HealthCheckRequest cuando se llama a la RPC de grpc.health.v1.Health.Check.
  • Es opcional. CONTAINER_PORT: Es el puerto de contenedor que se usa para el servicio.
  • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
  • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 3,600.El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 3,600 segundos. El valor predeterminado es 10 segundos.

YAML

Activo de HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

  1. Configura el atributo livenessProbe como se muestra a continuación:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
        spec:
          containers:
          - image: IMAGE_URL
            livenessProbe:
              httpGet:
                path: PATH
                port: CONTAINER_PORT
                httpHeaders:
                  - name: HEADER_NAME
                    value: HEADER_VALUE
              initialDelaySeconds: DELAY
              timeoutSeconds: TIMEOUT
              failureThreshold: THRESHOLD
              periodSeconds: PERIOD

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • PATH: Es una ruta de acceso relativa al extremo HTTP, por ejemplo, /health.
    • Es opcional. CONTAINER_PORT: Se configura como el puerto del contenedor que se usa para el servicio.
    • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
    • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
    • Opcional: Se puede usar httpHeaders para proporcionar varios encabezados personalizados o repetidos con los campos HEADER_NAME y HEADER_VALUE, como se muestra.
    • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 3,600.El valor predeterminado es 1.
    • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 3,600 segundos. El valor predeterminado es 10 segundos.

gRPC en funcionamiento

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

  1. Configura el atributo livenessProbe como se muestra a continuación:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
        spec:
          containers:
          - image: IMAGE_URL
            livenessProbe:
              grpc:
                port: CONTAINER_PORT
                service: GRPC_SERVICE
              initialDelaySeconds: DELAY
              timeoutSeconds: TIMEOUT
              failureThreshold: THRESHOLD
              periodSeconds: PERIOD

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • Es opcional. GRPC_SERVICE: Si se establece, se usa en el campo de servicio de grpc.health.v1.HealthCheckRequest cuando se llama a la RPC de grpc.health.v1.Health.Check.
    • Es opcional. CONTAINER_PORT: Es el puerto de contenedor que se usa para el servicio.
    • Es opcional. DELAY: Es la cantidad de segundos que se espera después de que el contenedor se inició antes de realizar el primer sondeo. Especifica un valor de 0 a 600 segundos (1,800 para GPU). El valor predeterminado es 0 segundos.
    • Es opcional. THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de cerrar el contenedor. El valor predeterminado es 3.
    • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 3,600.El valor predeterminado es 1.
    • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 segundo a 3,600 segundos. El valor predeterminado es 10 segundos.

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Activo de HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

Configura el servicio de Cloud Run con el atributo liveness_probe como se muestra a continuación:

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

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      liveness_probe {
        failure_threshold     = 5
        initial_delay_seconds = 10
        timeout_seconds       = 3
        period_seconds        = 3

        http_get {
          path = "/"
          # Custom headers to set in the request
          # https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/cloud_run_v2_service#http_headers
          http_headers {
            name  = "Access-Control-Allow-Origin"
            value = "*"
          }
        }
      }
    }
  }
}

gRPC en funcionamiento

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

Configura el servicio de Cloud Run con el atributo liveness_probe como se muestra a continuación:

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

  deletion_protection = false # set to "true" in production

  template {
    containers {
      # Note: Change to the name of your image
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      liveness_probe {
        failure_threshold     = 5
        initial_delay_seconds = 10
        timeout_seconds       = 3
        period_seconds        = 3

        # Note: Change to the name of your pre-existing grpc health status service
        grpc {
          service = "grpc.health.v1.Health"
        }
      }
    }
  }
}

Requisitos y comportamiento del sondeo de funcionamiento

Tipo de sondeo Requisitos Comportamiento
Activo de HTTP Crea un extremo de verificación de estado HTTP
Usa HTTP/1
El sondeo de capacidad de respuesta comienza solo después de que el sondeo de inicio se realiza correctamente. Después de configurar el sondeo y de que cualquier sondeo de inicio se realice de forma correcta, Cloud Run realiza una solicitud GET de HTTP al extremo de verificación de estado (por ejemplo, /health). Cualquier respuesta 2XX o 3XX es un éxito, todo lo demás indica un error.

Si un sondeo de funcionamiento no funciona de forma correcta dentro del tiempo especificado (failureThreshold * periodSeconds), el contenedor se cierra con una señal de SIGKILL. Las solicitudes restantes que el contenedor aún entregaba se finalizan con el código de estado HTTP 503. Después de cerrar el contenedor, el ajuste de escala automático de Cloud Run inicia una instancia de contenedor nueva.
gRPC en funcionamiento Implementa el protocolo de verificación de estado de gRPC en tu servicio de Cloud Run. Si configuras un sondeo de inicio de gRPC, el sondeo de funcionamiento comienza solo después de que el sondeo de inicio se realiza correctamente.

Después de configurar el sondeo de funcionamiento y cualquier sondeo de inicio se realiza correctamente, Cloud Run realiza una solicitud de verificación de estado al servicio.

Si un sondeo de funcionamiento no se completa de forma correcta dentro del tiempo especificado (failureThreshold * periodSeconds), el contenedor se cierra con una señal SIGKILL. Después de cerrar el contenedor, el ajuste de escala automático de Cloud Run inicia una instancia de contenedor nueva.

Configura los sondeos de preparación

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.

Se aplican las siguientes limitaciones a los sondeos de preparación:

  • Si habilitas la afinidad de sesión, Cloud Run seguirá enviando solicitudes a la misma instancia, incluso si falla su verificación de preparación.

  • Si ya configuraste un sondeo de preparación para tu servicio de Cloud Run con la API de Cloud Run Admin v1 antes de noviembre de 2025, las verificaciones de preparación no tendrán efecto, incluso después de implementar una configuración nueva para ese servicio. Esto ocurre porque el servicio conserva una configuración anterior. Los servicios que crees después de noviembre de 2025 o los que nunca usaron un sondeo de preparación no se verán afectados. Para habilitar los sondeos de preparación compatibles en los servicios afectados, haz lo siguiente:

    1. Implementa una revisión nueva que quite la definición del sondeo de preparación anterior.

    2. Implementa otra revisión nueva que agregue la definición de sondeo de preparación pertinente.

    Con estos pasos, se borra cualquier configuración anterior y se habilita la funcionalidad del sondeo de preparación.

Puedes configurar un sondeo de preparación con la consola de Google Cloud , Google Cloud CLI o YAML:

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 estás configurando 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 Contenedores.

  3. En la sección Verificaciones de estado, haz clic en Agregar verificación de estado para abrir el panel de configuración Agregar verificación de estado.

  4. En el menú Seleccionar el tipo de verificación de estado, selecciona Verificación de preparación.

  5. En el menú Seleccionar tipo de sondeo, selecciona el tipo de sondeo que quieras usar, por ejemplo, HTTP o gRPC. Se mostrará el formulario de configuración del sondeo.

  6. La configuración del sondeo varía según el tipo de sondeo. Establece la configuración del sondeo:

    • Si usas sondeos de HTTP, realiza lo siguiente:

      • Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

      • Usa el campo Ruta de acceso para especificar la ruta de acceso relativa al extremo, por ejemplo, /are_you_ready. La ruta de acceso predeterminada es /.

    • Si usas sondeos de gRPC, haz lo siguiente:

    • En Puerto, especifica el puerto del contenedor para tu servicio. El puerto predeterminado es el puerto de entrada principal.

    • En Período, especifica el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 a 300. El valor predeterminado es 10 segundos.

    • En Umbral de éxito, especifica la cantidad mínima de resultados consecutivos para que el sondeo se considere exitoso después de haber fallado. El valor predeterminado es 2.

    • En Umbral de falla, especifica la cantidad de veces que se debe reintentar el sondeo antes de informar una falla, lo que hace que la instancia deje de recibir tráfico. El valor predeterminado es 3.

    • En Tiempo de espera, especifica la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 300. El valor predeterminado es 1.

  7. Haz clic en Agregar para agregar el umbral nuevo.

  8. 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.

Para borrar un sondeo, haz clic en el ícono Borrar de la verificación de estado que deseas borrar y, luego, en Confirmar. Para implementar una revisión nueva de tu servicio de Cloud Run, haz clic en Ver diferencias y volver a implementar y, luego, en Implementar cambios.

gcloud

Preparación para HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

Ejecuta el comando siguiente:

gcloud run deploy SERVICE \
    --image=IMAGE_URL \
    --readiness-probe httpGet.path=PATH,httpGet.port=CONTAINER_PORT,successThreshold=SUCCESS_THRESHOLD,failureThreshold=FAILURE_THRESHOLD,timeoutSeconds=TIMEOUT,periodSeconds=PERIOD

Reemplaza lo siguiente:

  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • Es opcional. PATH: Es la ruta de acceso relativa al extremo HTTP, por ejemplo, /are_you_ready. La ruta de acceso predeterminada es /.
  • Es opcional. CONTAINER_PORT: Es el puerto del contenedor que se usa para tu servicio. El puerto predeterminado es el puerto de entrada principal.
  • Es opcional. SUCCESS_THRESHOLD: Es la cantidad mínima de resultados consecutivos para que el sondeo se considere exitoso después de haber fallado. El valor predeterminado es 2.
  • Es opcional. FAILURE_THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de informar un error, lo que hace que la instancia deje de recibir tráfico. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 300. El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 a 300. El valor predeterminado es 10 segundos.

gRPC listo

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

Ejecuta el comando siguiente:

gcloud run deploy SERVICE \
    --image=IMAGE_URL \
    --readiness-probe grpc.port=CONTAINER_PORT,grpc.service=GRPC_SERVICE,successThreshold=SUCCESS_THRESHOLD,failureThreshold=FAILURE_THRESHOLD,timeoutSeconds=TIMEOUT,periodSeconds=PERIOD

Reemplaza lo siguiente:

  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • Es opcional. CONTAINER_PORT: Es el puerto del contenedor que se usa para tu servicio. El puerto predeterminado es el puerto de entrada principal.
  • Es opcional. GRPC_SERVICE: Si se establece, se usa en el campo de servicio de grpc.health.v1.HealthCheckRequest cuando se llama a la RPC de grpc.health.v1.Health.Check.
  • Es opcional. SUCCESS_THRESHOLD: Es la cantidad mínima de resultados consecutivos para que el sondeo se considere exitoso después de haber fallado. El valor predeterminado es 2.
  • Es opcional. FAILURE_THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de informar un error, lo que hace que la instancia deje de recibir tráfico. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 300. El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 a 300. El valor predeterminado es 10 segundos.

YAML

Preparación para HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

  1. Configura el atributo readinessProbe como se muestra a continuación:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
        spec:
          containers:
          - image: IMAGE_URL
            readinessProbe:
              httpGet:
                path: PATH
                port: CONTAINER_PORT
              successThreshold: SUCCESS_THRESHOLD
              failureThreshold: FAILURE_THRESHOLD
              timeoutSeconds: TIMEOUT
              periodSeconds: PERIOD

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • Es opcional. PATH: Es la ruta de acceso relativa al extremo HTTP, por ejemplo, /are_you_ready. La ruta de acceso predeterminada es /.
    • Es opcional. CONTAINER_PORT: Es el puerto del contenedor que se usa para tu servicio. El puerto predeterminado es el puerto de entrada principal.
    • Es opcional. SUCCESS_THRESHOLD: Es la cantidad mínima de resultados consecutivos para que el sondeo se considere exitoso después de haber fallado. El valor predeterminado es 2.
    • Es opcional. FAILURE_THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de informar un error, lo que hace que la instancia deje de recibir tráfico. El valor predeterminado es 3.
    • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 300. El valor predeterminado es 1.
    • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 a 300. El valor predeterminado es 10 segundos.

gRPC listo

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

  1. Configura el atributo readinessProbe como se muestra a continuación:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
      annotations:
        run.googleapis.com/launch-stage: BETA
    spec:
      template:
        metadata:
        spec:
          containers:
          - image: IMAGE_URL
            readinessProbe:
              grpc:
                port: CONTAINER_PORT
                service: GRPC_SERVICE
              successThreshold: SUCCESS_THRESHOLD
              failureThreshold: FAILURE_THRESHOLD
              timeoutSeconds: TIMEOUT
              periodSeconds: PERIOD

    Reemplaza lo siguiente:

    • SERVICE: el nombre de tu servicio de Cloud Run.
    • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
    • Es opcional. CONTAINER_PORT: Es el puerto del contenedor que se usa para tu servicio. El puerto predeterminado es el puerto de entrada principal.
    • Es opcional. GRPC_SERVICE: Si se establece, se usa en el campo de servicio de grpc.health.v1.HealthCheckRequest cuando se llama a la RPC de grpc.health.v1.Health.Check.
    • Es opcional. SUCCESS_THRESHOLD: Es la cantidad mínima de resultados consecutivos para que el sondeo se considere exitoso después de haber fallado. El valor predeterminado es 2.
    • Es opcional. FAILURE_THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de informar un error, lo que hace que la instancia deje de recibir tráfico. El valor predeterminado es 3.
    • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 300. El valor predeterminado es 1.
    • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 a 300. El valor predeterminado es 10 segundos.

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Preparación para HTTP

Agrega un extremo HTTP/1 (el valor predeterminado de Cloud Run, no HTTP/2) en el código de servicio para responder al sondeo. El nombre del extremo (por ejemplo, /startup, /health o /are_you_ready) debe coincidir con el path en la configuración del sondeo. Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo de servicio HTTP que se exponga de forma externa.

Configura el servicio de Cloud Run con el atributo readiness_probe como se muestra a continuación:

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  location = "REGION"
  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "IMAGE_URL"

      readiness_probe {
        timeout_seconds   = TIMEOUT
        period_seconds    = PERIOD
        success_threshold = SUCCESS_THRESHOLD
        failure_threshold = FAILURE_THRESHOLD

        http_get {
          path = "PATH"
          port = CONTAINER_PORT
        }
      }
    }
  }
}

Reemplaza lo siguiente:

  • REGION: la región de Google Cloud , por ejemplo, us-central1.
  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • Es opcional. PATH: Es la ruta de acceso relativa al extremo HTTP, por ejemplo, /are_you_ready. La ruta de acceso predeterminada es /.
  • Es opcional. CONTAINER_PORT: Es el puerto del contenedor que se usa para tu servicio. El puerto predeterminado es el puerto de entrada principal.
  • Es opcional. SUCCESS_THRESHOLD: Es la cantidad mínima de resultados consecutivos para que el sondeo se considere exitoso después de haber fallado. El valor predeterminado es 2.
  • Es opcional. FAILURE_THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de informar un error, lo que hace que la instancia deje de recibir tráfico. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 300. El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 a 300. El valor predeterminado es 10 segundos.

gRPC listo

Asegúrate de que la imagen de contenedor implemente el protocolo de verificación de estado de gRPC.

Configura el servicio de Cloud Run con el atributo readiness_probe como se muestra a continuación:

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  location = "REGION"
  deletion_protection = "true"

  template {
    containers {
      image = "IMAGE_URL"

      readiness_probe {
        timeout_seconds   = TIMEOUT
        period_seconds    = PERIOD
        success_threshold = SUCCESS_THRESHOLD
        failure_threshold = FAILURE_THRESHOLD

        grpc {
          service = "GRPC_SERVICE"
          port = CONTAINER_PORT
        }
      }
    }
  }
}

Reemplaza lo siguiente:

  • REGION: la región de Google Cloud , por ejemplo, us-central1.
  • SERVICE: el nombre de tu servicio de Cloud Run.
  • IMAGE_URL: Es 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 ya debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • Es opcional. CONTAINER_PORT: Es el puerto del contenedor que se usa para tu servicio. El puerto predeterminado es el puerto de entrada principal.
  • Es opcional. GRPC_SERVICE: Si se establece, se usa en el campo de servicio de grpc.health.v1.HealthCheckRequest cuando se llama a la RPC de grpc.health.v1.Health.Check.
  • Es opcional. SUCCESS_THRESHOLD: Es la cantidad mínima de resultados consecutivos para que el sondeo se considere exitoso después de haber fallado. El valor predeterminado es 2.
  • Es opcional. FAILURE_THRESHOLD: Es la cantidad de veces que se debe reintentar el sondeo antes de informar un error, lo que hace que la instancia deje de recibir tráfico. El valor predeterminado es 3.
  • Es opcional. TIMEOUT: Es la cantidad de segundos que se espera hasta que se agote el tiempo de espera del sondeo. Este valor no puede exceder el valor especificado para periodSeconds. Especifica un valor de 1 a 300. El valor predeterminado es 1.
  • Es opcional. PERIOD: Es el período (en segundos) en el que se realizará el sondeo. Por ejemplo, 2 para realizar el sondeo cada 2 segundos. Especifica un valor de 1 a 300. El valor predeterminado es 10 segundos.

Requisitos y comportamiento del sondeo de preparación

Tipo de sondeo Requisitos Comportamiento
Preparación para HTTP Crea un extremo de verificación de estado HTTP
Usa HTTP/1
El sondeo de preparación comienza solo después de que el sondeo de inicio se realiza correctamente. Después de configurar el sondeo y de que cualquier sondeo de inicio se realice de forma correcta, Cloud Run realiza una solicitud GET de HTTP al extremo de verificación de estado (por ejemplo, /are_you_ready). Cualquier respuesta 2XX o 3XX es un éxito, todo lo demás indica un error.

Si una instancia falla en su sondeo de preparación más allá del failureThreshold configurado, Cloud Run deja de enrutar solicitudes nuevas a la instancia sin cerrarla y reanuda el enrutamiento de solicitudes una vez que la instancia pasa su sondeo de preparación (successThreshold veces consecutivas).
gRPC listo Implementa el protocolo de verificación de estado de gRPC en tu servicio de Cloud Run. El sondeo de preparación comienza solo después de que se realiza correctamente cualquier sondeo de inicio configurado. Cloud Run realiza una solicitud de verificación de estado de gRPC al servicio.

Si una instancia falla en su sondeo de preparación más allá del failureThreshold configurado, Cloud Run deja de enrutar solicitudes nuevas a la instancia sin cerrarla y reanuda el enrutamiento de solicitudes una vez que la instancia pasa su sondeo de preparación (successThreshold veces consecutivas).

Asignación de CPU

  • La CPU siempre se asigna cuando se ejecutan los sondeos.
  • Todos los sondeos se facturan por el consumo de CPU y uso de memoria, pero no se aplican cargos basados en solicitudes.

¿Qué sigue?