Usa el número mínimo de instancias

Obtén información para habilitar instancias inactivas para tus servicios con la configuración de número mínimo de instancias.

De forma predeterminada, la entrega de Knative escala verticalmente la cantidad de instancias según la cantidad de solicitudes entrantes. Sin embargo, si tu servicio requiere una latencia reducida y deseas limitar la cantidad de inicios en frío, puedes cambiar este comportamiento predeterminado si especificas un número mínimo de instancias de contenedor que se deben mantener en ejecución y listas para entregar.

Las instancias que se mantienen en ejecución de esta manera generan costos de facturación.

Revisiones y número mínimo de instancias

El número mínimo de instancias se inicia solo si se puede abordar la revisión. Se puede abordar una revisión si se cumple alguna de las siguientes condiciones:

  • Recibe un porcentaje del tráfico.
  • Se le asignó una etiqueta de revisión.

Configura y actualiza el número mínimo de instancias

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 consola de Google Cloud o Google Cloud CLI cuando implementas un servicio nuevo o actualizas un servicio existente y, además, implementas una revisión:

Console

  1. Ve a la entrega de Knative en la consola de Google Cloud:

    Ir a la entrega de Knative

  2. Haz clic en Crear servicio si quieres configurar un servicio nuevo en el que realizarás la implementación. Si quieres configurar un servicio existente, haz clic en el servicio y, luego, haz clic en IMPLEMENTAR Y EDITAR UNA NUEVA REVISIÓN.

  3. En Configuración avanzada, haz clic en Contenedor.

  4. En el campo Número mínimo de instancias, especifica la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes.

  5. Haz clic en Siguiente para pasar a la siguiente sección.

  6. En la sección Configura la forma en que se activa el servicio, selecciona la conectividad que deseas usar para invocar el servicio.

  7. Haz clic en Crear para implementar la imagen en la entrega de Knative y espera a que finalice la implementación.

Línea de comandos

  • En el caso de los servicios existentes, configura el número mínimo de instancias de contenedor mediante la ejecución del comando gcloud run services update con el parámetro --min-instances:

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

    Reemplaza lo siguiente:

    • SERVICE por el nombre de tu servicio
    • MIN-VALUE por la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes. Especifica default para borrar cualquier configuración de número mínimo de instancias
  • En el caso de los servicios nuevos, configura el número mínimo de instancias de contenedor mediante la ejecución del comando gcloud run deploy con el parámetro --min-instances:

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

    Reemplaza lo siguiente:

    • SERVICE por el nombre de tu servicio
    • IMAGE_URL por una referencia a la imagen del contenedor, como gcr.io/cloudrun/hello
    • MIN-VALUE por la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes. Especifica default para borrar cualquier configuración de número mínimo de instancias

YAML

Puedes descargar la configuración de un servicio existente en un archivo YAML con el comando gcloud run services describe mediante la marca --format=export. Luego, puedes modificar ese archivo YAML e implementar esos cambios con el comando gcloud run services replace. Debes asegurarte de modificar solo los atributos especificados.

  1. Descarga la configuración del servicio en un archivo llamado service.yaml en el lugar de trabajo local:

    gcloud run services describe SERVICE --format export > service.yaml

    Reemplaza SERVICE por el nombre de tu servicio de entrega de Knative.

  2. En tu archivo local, actualiza el atributo autoscaling.knative.dev/minScale::

    spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 'MIN-INSTANCE' 

    Reemplaza lo siguiente:

    • MIN-VALUE con la cantidad deseada de instancias de contenedor que se mantendrán cálidas, listas para recibir solicitudes. Especifica default para borrar cualquier configuración de número mínimo de instancias
  3. Reemplaza el servicio por la configuración nueva mediante el comando siguiente:

    gcloud run services replace service.yaml