Utilizzo del numero minimo di istanze

Scopri come attivare le istanze inattive per i tuoi servizi configurando l'impostazione relativa al numero minimo di istanze.

Per impostazione predefinita, Knative serving scala fino al numero di istanze in base al numero di richieste in entrata. Tuttavia, se il servizio richiede una latenza ridotta e vuoi limitare il numero di avvii a freddo, puoi modificare questo comportamento predefinito specificando un numero minimo di istanze di container da mantenere in esecuzione e pronte per gestire le richieste.

Le istanze mantenute in esecuzione in questo modo comportano costi di fatturazione.

Revisioni e numero minimo di istanze

Le istanze minime vengono avviate solo se la revisione è indirizzabile. Una revisione è indirizzabile se è vera una delle seguenti condizioni:

  • Riceve una percentuale del traffico.
  • È stato assegnato un tag di revisione.

Impostazione e aggiornamento del numero minimo di istanze

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che tu non apporti aggiornamenti espliciti per modificarla.

Per impostazione predefinita, le istanze container hanno min-instances disattivato, con un'impostazione di 0. Puoi modificare questo valore predefinito utilizzando la console Google Cloud o Google Cloud CLI quando esegui il deployment di un nuovo servizio o aggiorni un servizio esistente ed esegui il deployment di una revisione:

Console

  1. Vai a Knative Serving nella console Google Cloud :

    Vai a Knative serving

  2. Fai clic su Crea servizio se stai configurando un nuovo servizio di cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio, quindi su Modifica ed esegui il deployment di una nuova revisione.

  3. In Impostazioni avanzate, fai clic su Contenitore.

  4. Nel campo etichettato Numero minimo di istanze, specifica il numero desiderato di istanze di container da mantenere in uso, pronte a ricevere richieste.

  5. Fai clic su Avanti per continuare con la sezione successiva.

  6. Nella sezione Configura il funzionamento del trigger per questo servizio, seleziona la connettività che vuoi utilizzare per richiamare il servizio.

  7. Fai clic su Crea per eseguire il deployment dell'immagine in Knative Serving e attendi il completamento del deployment.

Riga di comando

  • Per i servizi esistenti, imposta il numero minimo di istanze di container eseguendo il comando gcloud run services update con il parametro --min-instances:

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

    Sostituisci:

    • SERVICE con il nome del tuo servizio.
    • MIN-VALUE con il numero desiderato di istanze del container da mantenere attive, pronte a ricevere richieste. Specifica default per cancellare qualsiasi impostazione di istanza minima.

  • Per i nuovi servizi, imposta il numero minimo di istanze di container eseguendo il comando gcloud run deploy con il parametro --min-instances:

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

    Sostituisci:

    • SERVICE con il nome del tuo servizio.
    • IMAGE_URL con un riferimento all'immagine container, ad esempio gcr.io/cloudrun/hello.
    • MIN-VALUE con il numero desiderato di istanze container da mantenere in uso, pronte a ricevere richieste. Specifica default per cancellare qualsiasi impostazione di istanza minima.

YAML

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe utilizzando il flag --format=export. Puoi quindi modificare il file YAML e implementare le modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

  1. Scarica la configurazione del servizio in un file denominato service.yaml nello spazio di lavoro locale:

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

    Sostituisci SERVICE con il nome del tuo servizio Knative.

  2. Nel file locale, aggiorna l'attributo autoscaling.knative.dev/minScale::

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

    Sostituisci:

    • MIN-VALUEcode> con il numero desiderato di istanze container da mantenere attive, pronte a ricevere richieste. Specifica default per cancellare qualsiasi impostazione di istanza minima.

  3. Sostituisci il servizio con la sua nuova configurazione utilizzando il seguente comando:

    gcloud run services replace service.yaml