Establece instancias mínimas para los servicios

En esta página, se describe cómo habilitar instancias inactivas para un servicio configurando un número mínimo de instancias con el comportamiento predeterminado del ajuste de escala automático de Cloud Run. Para ajustar manualmente la escala de tu servicio, consulta ajuste de escala manual.

Si necesitas más control sobre el comportamiento del ajuste de escala automático de tu servicio, puedes establecer una cantidad mínima de instancias para evitar tiempos de inicio lentos del contenedor y reducir la latencia del servicio. En los servicios de Cloud Run, de forma predeterminada, Cloud Run reduce la escala de la cantidad de instancias según el número de solicitudes entrantes.

Sin embargo, si tu servicio requiere una latencia reducida, especialmente cuando se escala desde cero instancias activas, puedes cambiar este comportamiento predeterminado si especificas una cantidad mínima de instancias de contenedor que se deben mantener en espera y listas para entregar solicitudes. Consulta Sugerencias generales para el desarrollo a fin de obtener más detalles sobre esta optimización.

Cloud Run quita las instancias que no entregan solicitudes (inactivas). Con el mínimo de instancias establecidas, Cloud Run mantiene al menos la cantidad mínima de instancias en ejecución, incluso si no entregan solicitudes. Las instancias activas superiores a la cantidad de min-instances pueden quedar inactivas si no reciben solicitudes.

Por ejemplo, si min-instances es 10 y la cantidad de instancias activas es 0, entonces la cantidad de instancias inactivas es 10. Cuando la cantidad de instancias activas aumenta a 6, la cantidad de instancias inactivas disminuye a 4.

Ten en cuenta que, si un servicio no entregó tráfico recientemente, la métrica de instancias activas puede indicar que no hay instancias activas, incluso si especificaste una o más para las instancias mínimas.

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:

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

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 permisos de implementación y administra el acceso.

Configura instancias mínimas a nivel de servicio

De forma predeterminada, las instancias de contenedor tienen las instancias mínimas a nivel de servicio desactivadas, con una configuración de 0. Puedes cambiar esta configuración predeterminada con laGoogle Cloud consola, Google Cloud CLI 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

Visualiza el nivel mínimo de instancias en el nivel de servicio

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

Aplica instancias mínimas a nivel de servicio en comparación con a nivel de revisión

Puedes 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 evites combinar instancias mínimas a nivel de servicio y de revisión.

Si aplicas instancias mínimas a nivel de revisión, la configuración entrará en vigor cuando se implemente la revisión. Si aplicas esta función a nivel del servicio, la configuración entra en vigor sin necesidad de implementar una revisión nueva.

Revisiones etiquetadas e instancias mínimas a nivel de servicio

Las revisiones etiquetadas se inician, pero solo se consideran en las instancias mínimas del nivel de servicio si forman parte de una división del tráfico.

Facturación

Las instancias que se siguen ejecutando con la función de instancias mínimas generan costos de facturación. Debido a que estos cargos son muy predecibles, Google recomienda adquirir un descuento por compromiso de uso.

Instancias mínimas y facturación basada en instancias

Puedes configurar la facturación basada en instancias si necesitas CPU fuera de las solicitudes.

Cantidad mínima de reinicios de instancias

La cantidad mínima de instancias se puede reiniciar en cualquier momento.

Revisiones y número mínimo de instancias

Cuando la cantidad mínima de instancias se establece en el nivel de servicio, se distribuyen a todas revisiones que entregan tráfico de manera proporcional a la división del tráfico.

Cuando se establecen instancias mínimas a nivel de revisión, se inician instancias mínimas cada vez que se ejecuta la revisión a la que se hace referencia en una división del tráfico (incluso en 0%) o tiene un etiqueta de tráfico asignado.

Enrutamiento de solicitudes con instancias mínimas

Cuando configuras instancias mínimas, Cloud Run distribuye las solicitudes entrantes de manera uniforme entre todas estas instancias aprovisionadas. Comprender este comportamiento es importante para administrar los costos, en especial con la facturación basada en solicitudes o si planeas mantener instancias de reserva activa inactivas.

Si las instancias mínimas se configuran en un valor más alto del que se requiere para tu tráfico típico, es posible que muchas instancias se activen ligeramente y cada una procese algunas solicitudes. Por ejemplo, si tu servicio generalmente requiere 200 instancias para la carga máxima, pero las instancias mínimas están configuradas en 600, las solicitudes entrantes se distribuirán en las 600 instancias. Esto hace que muchas de estas 600 instancias se vuelvan algo activas, y cada una maneja una pequeña porción del tráfico, en lugar de que alrededor de 200 instancias estén muy activas y las 400 restantes permanezcan completamente inactivas.

Para optimizar los costos (con una mayor utilización en menos instancias), establece las instancias mínimas en un valor que se alinee estrechamente con la cantidad real de instancias necesarias para atender tu tráfico típico.

Además, cuando el ajuste de escala automático aprovisiona instancias adicionales por encima de las instancias mínimas configuradas, Cloud Run prefiere enrutar primero las solicitudes entrantes a las instancias mínimas configuradas antes de enviar solicitudes a las instancias con ajuste de escala automático. Con la facturación basada en solicitudes, este enrutamiento preferencial a las instancias mínimas configuradas reduce el costo, ya que completa las instancias mínimas configuradas antes de usar las instancias con ajuste de escala automático. Ten en cuenta que este enrutamiento preferencial también puede hacer que las instancias mínimas configuradas tengan un uso mayor que las instancias con ajuste de escala automático, según la cantidad de tráfico.

Configura instancias mínimas a nivel de revisió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.

De forma predeterminada, las instancias de contenedor tienen min-instances desactivado, con una configuración de 0. Puedes cambiar esta configuración predeterminada con la Google Cloud consola, Google Cloud CLI o un archivo YAML cuando creas un servicio nuevo o implementas una revisión nueva:

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

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

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

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

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

Usa instancias mínimas de nivel de servicio con división de tráfico

Si usas la división del tráfico, las instancias mínimas a nivel de servicio se dividen entre las revisiones según la proporción de la división del tráfico. Por ejemplo, si las instancias mínimas a nivel de servicio equivalen a 10, una división del tráfico de 50/50 asigna 5 instancias mínimas a nivel de servicio a cada revisión.

En la siguiente tabla, se muestran situaciones de configuración de muestra: