Puedes configurar sondeos de inicio de HTTP, TCP y gRPC, junto con sondeos de funcionamiento de HTTP y gRPC para grupos de trabajadores nuevos y existentes de Cloud Run. La configuración varía según el tipo de sondeo.
Casos de uso
Puedes configurar dos tipos de sondeos de verificación de estado:
Los sondeos de funcionamiento determinan si el contenedor se debe reiniciar.
- En este caso, reiniciar un contenedor puede aumentar la disponibilidad del grupo de trabajadores 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, por ejemplo, para detectar un interbloqueo en el que se ejecuta un grupo de trabajadores, pero no puede avanzar. Puedes solicitar una prueba en funcionamiento para cada contenedor con políticas de la organización personalizadas.
Los sondeos de inicio determinan si se inició el contenedor.
- Cuando configuras un sondeo de inicio, las verificaciones de funcionamiento se inhabilitan hasta que el sondeo de inicio determina que el contenedor se inicia para evitar interferencias en el inicio del grupo de trabajadores.
- 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.
Ten en cuenta que, cuando un grupo de trabajadores experimenta fallas repetidas de sondeo o inicio de funcionamiento, Cloud Run limita los reinicios de las instancias para evitar bucles de fallas no controlados.
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 memoria.
Requisitos y comportamiento del sondeo
| Tipo de sondeo | Requisitos | Comportamiento |
|---|---|---|
| Inicio de TCP | Ninguno | Si se especifica, 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, Cloud Run cierra el contenedor. El tiempo máximo es de 240 segundos, que se calcula como failureThreshold * periodSeconds, y se establece cuando configuras el sondeo de inicio para el grupo de trabajadores. |
| 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 HTTP GET al extremo de verificación de estado del grupo de trabajadores (por ejemplo, /ready). Cualquier respuesta entre 200 y 400 es correcta, y 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 240 segundos, Cloud Run cierra el contenedor.Si el sondeo de inicio HTTP se realiza de forma correcta dentro del tiempo especificado y configuraste un sondeo de funcionamiento HTTP, Cloud Run inicia el sondeo de funcionamiento HTTP. |
| 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 correctamente, Cloud Run realiza una solicitud HTTP GET al extremo de verificación de estado (por ejemplo, /health). Cualquier respuesta entre 200 y 400 es correcta, y todo lo demás indica un error.Si un sondeo de funcionamiento no se realiza de forma correcta dentro del tiempo especificado ( failureThreshold * periodSeconds), Cloud Run cierra el contenedor 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 que Cloud Run cierra el contenedor, el ajuste de escala automático de Cloud Run inicia una instancia de contenedor nueva. |
| Inicio de gRPC | Implementa el protocolo de verificación de estado de gRPC en tu grupo de trabajadores 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 240 segundos, Cloud Run cierra el contenedor. |
| gRPC en funcionamiento | Implementa el protocolo de verificación de estado de gRPC en tu grupo de trabajadores 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 de que cualquier sondeo de inicio se realice correctamente, Cloud Run realiza una solicitud de verificación de estado al grupo de trabajadores. Si un sondeo de funcionamiento no se realiza correctamente dentro del tiempo especificado ( failureThreshold * periodSeconds), Cloud Run cierra el contenedor con una señal de SIGKILL. Después de que Cloud Run cierra el contenedor, el ajuste de escala automático de Cloud Run inicia una instancia de contenedor nueva. |
Configura sondeos
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 con la API de REST de Cloud Run:
API de REST
Importante: Si configuras tu grupo de trabajadores de Cloud Run para sondeos HTTP, también debes agregar un extremo de verificación de estado HTTP en el código de tu grupo de trabajadores para responder al sondeo. Si configuras un sondeo de gRPC, también debes implementar el protocolo de verificación de estado de gRPC en tu grupo de trabajadores de Cloud Run.
Inicio de HTTP
Usa la API de REST para configurar esto.
Activo de HTTP
Usa la API de REST para configurar esto.
Inicio de gRPC
Usa la API de REST para configurar esto.
gRPC en funcionamiento
Usa la API de REST para configurar esto.
Crea extremos de verificación de estado de HTTP
Si configuras tu grupo de trabajadores de Cloud Run para un sondeo de inicio o
de funcionamiento de HTTP, debes agregar un extremo en el código del grupo de trabajadores para responder al
sondeo. El extremo puede tener el nombre que desees, por ejemplo,
/startup o /ready, pero el nombre debe coincidir con el valor que especifiques para
path en la configuración del sondeo. Por ejemplo, si especificas /ready para un sondeo de inicio HTTP, debes especificar path en la configuración de sondeo, como se muestra a continuación:
startupProbe: httpGet: path: /ready
Los extremos de la verificación de estado de HTTP son accesibles de forma externa y siguen los mismos principios que cualquier otro extremo HTTP que se exponga de forma externa.