Configura il numero minimo di istanze (1ª gen.)

Puoi evitare gli avvii a freddo della tua applicazione e ridurne la latenza impostando un numero minimo di istanze.

Cloud Run Functions scala creando nuove istanze della funzione. Ciascuna di queste istanze può gestire solo una richiesta alla volta, quindi picchi elevati nel volume delle richieste spesso causano tempi di attesa più lunghi, poiché vengono create nuove istanze per gestire la domanda.

Poiché le funzioni sono stateless, a volte inizializzano l'ambiente di esecuzione da zero, operazione denominata avvio a freddo. Il completamento degli avvii a freddo può richiedere molto tempo, pertanto ti consigliamo di impostare un numero minimo di istanze di Cloud Run Functions se la tua applicazione è sensibile alla latenza.

Istanze inattive e avvii a freddo

Per ridurre al minimo l'impatto degli avvii a freddo, Cloud Run Functions tenta di mantenere le istanze di funzione inattive per un periodo di tempo non specificato dopo aver gestito una richiesta. Durante questo periodo di inattività, risorse quali connessioni aperte al database potrebbero essere mantenute nel caso in cui sia necessario gestire un'altra richiesta. Le istanze mantenute inattive in questo modo vengono conteggiate ai fini del limite massimo di istanze per la funzione, ma non ti vengono addebitate per questo periodo di inattività.

Questo comportamento predefinito potrebbe non essere sufficiente per la tua applicazione, soprattutto se è sensibile alla latenza. L'impostazione esplicita di un numero minimo di istanze può aiutarti ulteriormente a evitare gli avvii a freddo e a ridurre la latenza dell'applicazione.

Tieni presente che quando le istanze vengono mantenute inattive perché è stato impostato un numero minimo di istanze, queste non vengono considerate attive a meno che non abbiano gestito traffico di recente. Ciò significa, ad esempio, che se una funzione non ha servito traffico di recente, la metrica "Istanze attive" potrebbe indicare che nessuna istanza è attiva, anche se è stato impostato un valore per il numero minimo di istanze.

Tieni presente inoltre che, quando imposti un numero minimo di istanze, ti viene addebitato il tempo di inattività di queste istanze. Per saperne di più, consulta Prezzi.

Impostazione e cancellazione dei limiti del numero minimo di istanze

Puoi impostare un numero minimo di istanze per una funzione durante il deployment. Ogni funzione ha la propria impostazione per il numero minimo di istanze.

Impostazione dei limiti del numero minimo di istanze

Puoi impostare un limite minimo di istanze utilizzando Google Cloud CLI o la console Google Cloud .

Console

Per impostare un limite minimo di istanze per una nuova funzione:

  1. Per creare una nuova funzione, vai alla pagina Cloud Run Functions nella consoleGoogle Cloud :
    Vai alla pagina Cloud Run Functions

  2. Fai clic su Crea funzione.

  3. Compila i campi obbligatori per la tua funzione.

  4. Espandi la sezione Runtime, build... alla fine della pagina e fai clic sulla scheda Runtime.

  5. Nel campo Numero minimo di istanze della sezione Scalabilità automatica, inserisci un numero maggiore o uguale a 1.

  6. Fai clic su Avanti.

  7. Fai clic su Esegui il deployment.

Per impostare un limite minimo di istanze per una funzione esistente:

  1. Vai alla pagina Cloud Run Functions nella console Google Cloud :
    Vai alla pagina Cloud Run Functions

  2. Fai clic sul nome di una funzione esistente per accedere alla relativa pagina Dettagli funzione.

  3. Fai clic su Modifica.

  4. Espandi la sezione Runtime, build... alla fine della pagina e fai clic sulla scheda Runtime.

  5. Nel campo Numero minimo di istanze della sezione Scalabilità automatica, inserisci un numero maggiore o uguale a 1.

  6. Fai clic su Avanti.

  7. Fai clic su Esegui il deployment.

gcloud

Per impostare un limite minimo di istanze, esegui questo comando:

gcloud functions deploy FUNCTION_NAME \
--no-gen2 \
--min-instances MIN_INSTANCE_LIMIT

Sostituisci quanto segue:

  • FUNCTION_NAME: il nome della funzione.

  • MIN_INSTANCE_LIMIT: il numero da impostare come limite minimo di istanze, non superiore a 1000.

Il limite minimo di istanze della funzione è stato impostato.

Cancellazione dei limiti del numero minimo di istanze

Puoi cancellare o rimuovere un limite minimo di istanze utilizzando Google Cloud CLI o la console Google Cloud .

Console

Per cancellare il limite minimo di istanze di una funzione:

  1. Vai alla pagina Cloud Run Functions nella consoleGoogle Cloud :
    Vai alla pagina Cloud Run Functions

  2. Fai clic sul nome di una funzione esistente per accedere alla relativa pagina Dettagli funzione.

  3. Fai clic su Modifica.

  4. Espandi la sezione Runtime, build... alla fine della pagina e fai clic sulla scheda Runtime.

  5. Nel campo Numero minimo di istanze della sezione Scalabilità automatica, inserisci 0.

  6. Fai clic su Avanti.

  7. Fai clic su Esegui il deployment.

gcloud

Utilizza il flag --clear-min-instances al momento del deployment:

gcloud functions deploy FUNCTION_NAME --clear-min-instances

Il limite minimo di istanze della funzione è stato cancellato.

Ricevi consigli per impostare il numero minimo di istanze

Il motore per suggerimenti è un servizio che fornisce automaticamente suggerimenti per le funzioni di cui è stato eseguito il deployment che potrebbero trarre vantaggio dall'impostazione di un numero minimo di istanze.