Impostazione di un numero massimo di istanze container

Scopri come impostare il numero massimo di istanze di container che possono essere utilizzate per il tuo servizio Knative serving. Specificare il numero massimo di istanze in Knative serving consente di limitare la scalabilità del tuo servizio in risposta alle richieste in entrata. Utilizza questa impostazione per controllare i costi o limitare il numero di connessioni a un servizio di supporto, ad esempio a un database.

Per ulteriori informazioni sul modo in cui Knative serving scala automaticamente le istanze di container, consulta Scalabilità automatica delle istanze.

Impostazione e aggiornamento del numero massimo di istanze

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

Per impostazione predefinita, il numero di istanze di container può scalare infinitamente. Puoi impostare un limite superiore per il numero massimo di istanze 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 in cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio e poi su Modifica ed esegui il deployment della nuova revisione.

  3. In Impostazioni avanzate, fai clic su Contenitore.

  4. Nel campo con etichetta Numero massimo di istanze, specifica il numero massimo desiderato di istanze di container.

  5. Fai clic su Avanti per passare alla sezione successiva.

  6. Nella sezione Configura il modo in cui viene attivato questo servizio, seleziona la connettività da 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 massimo di istanze di container eseguendo il comando gcloud run services update con il parametro --max-instances:

    gcloud run services update SERVICE --max-instances MAX-VALUE
    

    Sostituisci:

    • SERVICE con il nome del tuo servizio.
    • MAX-VALUE con il numero massimo desiderato di istanze di container. Specifica default per cancellare tutte le impostazioni massime dell'istanza.
  • Per i nuovi servizi, imposta il numero massimo di istanze di container eseguendo il comando gcloud run deploy con il parametro --max-instances:

    gcloud run deploy SERVICE --image=IMAGE_URL --max-instances MAX-VALUE
    

    Sostituisci:

    • SERVICE con il nome del tuo servizio.
    • IMAGE_URL con un riferimento all'immagine container, ad esempio gcr.io/cloudrun/hello.
    • MAX-VALUE con il numero massimo desiderato di istanze di container. Specifica default per cancellare tutte le impostazioni massime dell'istanza.

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 ed eseguire il deployment delle modifiche con il comando gcloud run services replace. Assicurarsi di modificare solo gli attributi specificati.

  1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

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

    Sostituisci SERVICE con il nome del tuo servizio Knative serving.

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

    spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/maxScale: 'MAX-INSTANCE' 

    Sostituisci

    • MAX-INSTANCE con il numero massimo desiderato.
  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud run services replace service.yaml