Definir el número mínimo de instancias de los servicios

En esta página se describe cómo habilitar las instancias inactivas de un servicio configurando un número mínimo de instancias mediante el comportamiento de autoescalado de Cloud Run predeterminado. Para escalar tu servicio manualmente, consulta la sección sobre escalado manual.

Si necesitas tener más control sobre el comportamiento de autoescalado de tu servicio, puedes definir un número mínimo de instancias para evitar que los contenedores tarden en iniciarse y reducir la latencia del servicio. En el caso de los servicios de Cloud Run, Cloud Run reduce de forma predeterminada el número de instancias en función del número de solicitudes entrantes.

Sin embargo, si tu servicio requiere una latencia reducida, sobre todo al pasar de cero instancias activas, puedes cambiar este comportamiento predeterminado especificando un número mínimo de instancias de contenedor que se mantengan activas y listas para atender solicitudes. Consulta Consejos generales para el desarrollo para obtener más información sobre esta optimización.

Cloud Run elimina las instancias que no están procesando solicitudes (inactivas). Si se define un número mínimo de instancias, Cloud Run mantiene en ejecución al menos ese número de instancias, aunque no estén procesando solicitudes. Las instancias activas que superen el número min-instances podrían quedar inactivas si no reciben solicitudes.

Por ejemplo, si min-instances es 10 y el número de instancias activas es 0, el número de instancias inactivas es 10. Cuando el número de instancias activas aumenta a 6, el número de instancias inactivas disminuye a 4.

Ten en cuenta que, si un servicio no ha servido tráfico recientemente, la métrica de instancias activas puede indicar que no hay ninguna instancia activa, aunque hayas especificado una o más instancias mínimas.

Las instancias mínimas se pueden reiniciar en cualquier momento.

Facturación

Las instancias que se mantienen en ejecución mediante la función de número mínimo de instancias generan costes de facturación.

En el siguiente diagrama se muestra cómo funciona la facturación durante el ciclo de vida de una instancia cuando se configuran instancias mínimas para un servicio o una revisión:

En función de la configuración de facturación, el servicio se factura de la siguiente manera:

• En el caso de la facturación basada en solicitudes, se te cobra una tarifa más baja cuando las instancias están inactivas y esperan a procesar solicitudes. Si el número mínimo de instancias es 0, no se te cobrará cuando las instancias estén inactivas.
• En el caso de la facturación basada en instancias, se te cobra la tarifa predeterminada durante todo el ciclo de vida de la instancia. El tiempo que transcurre entre el inicio y el cierre incluye los momentos en los que una instancia está procesando solicitudes o está inactiva. Es decir, aunque min instances se haya definido en 0, se te seguirá facturando la tarifa predeterminada. Esta opción es adecuada si necesitas CPU fuera de las solicitudes. Si min instances se define como 0, se te cobrará la tarifa predeterminada.

Como estos cargos son predecibles, Google recomienda comprar un descuento por compromiso de uso.

Aplicar instancias mínimas a nivel de servicio en lugar de a nivel de revisión

Puede configurar el número mínimo de instancias a nivel de servicio o de revisión. Google recomienda que apliques instancias mínimas a nivel de servicio y que evites combinar instancias mínimas a nivel de servicio y de revisión. Consulta más información sobre el comportamiento cuando configuras los ajustes de escalado a nivel de servicio y de revisión.

Si aplicas instancias mínimas a nivel de revisión, los ajustes se aplicarán al implementar la revisión. Si aplicas esta función a nivel de servicio, el ajuste se aplicará sin necesidad de implementar una nueva revisión.

Revisiones e instancias mínimas

Cuando se definen instancias mínimas a nivel de servicio, las solicitudes entrantes se distribuyen entre todas las revisiones que están sirviendo tráfico proporcionalmente al reparto del tráfico.

Cuando se define un número mínimo de instancias a nivel de revisión, las instancias mínimas se inician siempre que se haga referencia a la revisión en una división del tráfico o se le asigne una etiqueta de tráfico. Esto significa que la instancia se factura cuando procesa solicitudes y también cuando espera solicitudes entrantes.

Revisiones etiquetadas e instancias mínimas de nivel de servicio

Si se inicia una revisión con una etiqueta asignada, la instancia se contabiliza en las instancias mínimas a nivel de servicio si forma parte de una división del tráfico.

Enrutamiento de solicitudes con instancias mínimas

Cuando configuras un número mínimo de instancias, Cloud Run distribuye las solicitudes entrantes de forma uniforme entre todas las instancias aprovisionadas. Es importante entender este comportamiento para gestionar los costes, sobre todo si usas la facturación basada en solicitudes o si tienes previsto mantener instancias de reserva activa inactivas. Para minimizar los costes, defina el número mínimo de instancias como el número de instancias necesarias para atender su tráfico habitual.

Roles obligatorios

Para obtener los permisos que necesitas para configurar e implementar servicios de Cloud Run, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

• Desarrollador de Cloud Run (roles/run.developer) en el servicio Cloud Run
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser) en la identidad de servicio

Si vas a desplegar un servicio o una función a partir de código fuente, también debes tener otros roles concedidos en tu proyecto y en la cuenta de servicio de Cloud Build.

Para ver una lista de los roles y permisos de gestión de identidades y accesos asociados a Cloud Run, consulta los artículos sobre roles de gestión de identidades y accesos de Cloud Run y permisos de gestión de identidades y accesos de Cloud Run. Si tu servicio de Cloud Run interactúa con APIs, como las bibliotecas de cliente de Cloud, consulta la guía de configuración de la identidad del servicio.Google Cloud Para obtener más información sobre cómo conceder roles, consulta los artículos sobre permisos de implementación y gestión del acceso.

Configurar un número mínimo de instancias a nivel de servicio

De forma predeterminada, las instancias de contenedor tienen desactivadas las instancias mínimas a nivel de servicio, con un valor de 0. Puedes cambiar este valor predeterminado mediante laGoogle Cloud consola, la CLI de Google Cloud o un archivo YAML:

gcloud run services update SERVICE --min MIN-VALUE

gcloud run deploy --image IMAGE_URL --min MIN-VALUE

curl -H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-X PATCH \
-d '{ "scaling": { "minInstanceCount": MIN-VALUE }}' \
https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.minInstanceCount

Ver las instancias mínimas a nivel de servicio

Para ver la configuración actual de las instancias mínimas a nivel de servicio de tu servicio de Cloud Run, sigue estos pasos:

Configurar un número mínimo de instancias a nivel de revisión

Cualquier cambio en la configuración conlleva la creación de una nueva revisión. Las revisiones posteriores también recibirán automáticamente este ajuste de configuración, a menos que hagas cambios explícitos para modificarlo.

De forma predeterminada, las instancias de contenedor tienen min-instances desactivado, con un ajuste de 0. Puedes cambiar este valor predeterminado mediante la consola, la CLI de Google Cloud o un archivo YAML cuando crees un servicio o despliegues una revisión: Google Cloud

gcloud run services update SERVICE --min-instances MIN-VALUE

gcloud run deploy --image IMAGE_URL --min-instances MIN-VALUE

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

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    scaling {
      # Min instances
      min_instance_count = 1
    }
  }
}

Ver las instancias mínimas a nivel de revisión

Para ver la configuración actual de instancias mínimas a nivel de revisión de tu servicio de Cloud Run, sigue estos pasos:

Ejemplos

En las secciones siguientes se muestra el comportamiento del servicio al configurar instancias mínimas.

Usar instancias mínimas o máximas a nivel de servicio y de revisión

En la siguiente tabla se muestra el comportamiento si combinas instancias mínimas a nivel de servicio e instancias mínimas o máximas a nivel de revisión:

Usar instancias mínimas a nivel de servicio con división del tráfico

Si usas la división del tráfico, las instancias mínimas a nivel de servicio se dividen entre las revisiones en función de la proporción de la división del tráfico. Por ejemplo, si el número mínimo de instancias a nivel de servicio es 10, una división del tráfico del 50 % asigna 5 instancias mínimas a nivel de servicio a cada revisión.

En la siguiente tabla se muestran ejemplos de escenarios de configuración:

Determinar el número mínimo de instancias necesarias

Si el número mínimo de instancias es superior al que se requiere para tu tráfico habitual, es posible que muchas instancias se activen ligeramente y que cada una procese algunas solicitudes. Por ejemplo, si tu servicio suele requerir 200 instancias para la carga máxima, pero el número mínimo de instancias se ha configurado en 600, las solicitudes entrantes se distribuirán entre las 600 instancias. Como resultado, muchas de estas 600 instancias se activan parcialmente y cada una gestiona una pequeña parte del tráfico, en lugar de que unas 200 instancias estén muy activas y las 400 restantes permanezcan completamente inactivas.

Para minimizar los costes (con una mayor utilización en menos instancias), asigna a las instancias mínimas un valor que se ajuste al número real de instancias necesarias para atender tu tráfico habitual.

Además, cuando el autoescalado aprovisiona instancias adicionales por encima del número mínimo de instancias configurado, Cloud Run prefiere enrutar las solicitudes entrantes primero a las instancias mínimas configuradas antes de enviar solicitudes a las instancias autoescaladas. Con la facturación basada en solicitudes, este enrutamiento preferente a las instancias mínimas configuradas reduce los costes, ya que se llenan las instancias mínimas configuradas antes de usar las instancias autoescaladas. Ten en cuenta que este enrutamiento preferente también puede provocar que las instancias mínimas configuradas tengan una utilización mayor que las instancias autoescaladas, en función de la cantidad de tráfico.