Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Scopri come attivare le istanze inattive per i tuoi servizi configurando l'impostazione delle istanze minime.
Per impostazione predefinita, Knative serving
scala il 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 minime vengono avviate solo se la revisione è indirizzabile. Una revisione è indirizzabile se una delle seguenti condizioni è vera:
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 acquisiranno automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.
Per impostazione predefinita, le istanze container hanno min-instances disattivato, con un'impostazione
0. Puoi modificare questo valore predefinito utilizzando la Google Cloud console o l'interfaccia a riga di comando Google Cloud quando esegui il deployment di un nuovo
servizio o aggiorni un servizio esistente e
esegui il deployment di una revisione:
Console
Vai alla pubblicazione Knative nella Google Cloud console:
Fai clic su Crea servizio se stai configurando un nuovo servizio di destinazione del deployment. Se stai configurando un servizio esistente, fai clic sul servizio, poi su Modifica ed esegui il deployment di una nuova revisione.
In Impostazioni avanzate, fai clic su Contenitore.
Nel campo Numero minimo di istanze,
specifica il numero desiderato di istanze di container da mantenere in uso e pronte per ricevere richieste.
Fai clic su Avanti per passare alla sezione successiva.
Nella sezione Configura il funzionamento del trigger per questo servizio,
seleziona la connettività che vuoi utilizzare per richiamare il servizio.
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:
MIN-VALUE con il numero desiderato di istanze di container da mantenere attive e pronte a ricevere richieste. Specifica
default per cancellare qualsiasi impostazione di istanze minime.
Per i nuovi servizi, imposta il numero minimo di istanze di container eseguendo il comando gcloud run deploy con il parametro --min-instances:
IMAGE_URL con un riferimento all'immagine del container, ad esempio gcr.io/cloudrun/hello.
MIN-VALUE con il numero desiderato di
istanze container da mantenere attive, pronte a ricevere richieste. Specifica
default per cancellare qualsiasi impostazione di istanze minime.
YAML
.
Puoi scaricare la configurazione di un servizio esistente in un
file YAML con il comando gcloud run services describe utilizzando il
--format=export flag.
Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace.
Devi assicurarti di modificare solo gli attributi specificati.
Scarica la configurazione del servizio in un file denominato
service.yaml nello spazio di lavoro locale:
MIN-VALUEcode> con il numero desiderato di
istanze di container da mantenere attive, pronte a ricevere richieste. Specifica
default per cancellare qualsiasi impostazione di istanze minime.
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-01 UTC."],[],[],null,["# Using minimum instances\n\nLearn how to enable idle instances for your services by configuring the minimum\ninstances setting.\n\nBy default, Knative serving\n[scales](/kubernetes-engine/enterprise/knative-serving/docs/instance-autoscaling) up to the number of instances\nbased on the number of incoming requests. However,\nif your service requires reduced latency and you want to limit the number of\ncold starts, you can change this default behavior by specifying a minimum number\nof container instances to be kept running and ready to serve requests.\n\nInstances kept running in this way do incur [billing costs](/kubernetes-engine/enterprise/knative-serving/pricing).\n\nRevisions and minimum instances\n-------------------------------\n\nMinimum instances are started only if the revision is *addressable*. A revision\nis addressable if either of the following is true:\n\n- It receives a percentage of the traffic.\n- It was assigned a revision tag.\n\nSetting and updating minimum instances\n--------------------------------------\n\nAny configuration change leads to the\ncreation of a new revision. Subsequent revisions will also automatically get\nthis configuration setting unless you make explicit updates to change it.\n\nBy default, container instances have `min-instances` turned off, with a setting\nof `0`. You can change this default using the using the Google Cloud console,\nor the Google Cloud CLI when you deploy a new\n[service](/kubernetes-engine/enterprise/knative-serving/docs/deploying#service) or update an existing service and\ndeploy a [revision](/kubernetes-engine/enterprise/knative-serving/docs/deploying#revision): \n\n### Console\n\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Click **Create Service** if you are configuring a\n new service you are deploying to. If you are configuring an\n existing service, click on the service, then click\n **Edit \\& Deploy New Revision**.\n\n3. Under *Advanced settings* , click **Container**.\n\n4. In the field labelled *Minimum number of instances*,\n specify the desired number of container instances to be kept warm, ready to receive requests.\n\n5. Click **Next** to continue to the next section.\n\n6. In the **Configure how this service is triggered** section,\n select which connectivity you would like to use to invoke the service.\n\n7. Click **Create** to deploy the image to Knative serving and wait\n for the deployment to finish.\n\n### Command line\n\n- For existing services, set the minimum number of container instances by\n running the `gcloud run services update` command with the\n [`--min-instances`](/sdk/gcloud/reference/run/services/update#--min-instances)\n parameter:\n\n ```bash\n gcloud run services update SERVICE --min-instances MIN-VALUE\n ```\n\n Replace:\n - \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your service.\n - \u003cvar translate=\"no\"\u003eMIN-VALUE\u003c/var\u003e with the desired number of container instances to be kept warm, ready to receive requests. Specify `default` to clear any minimum instance setting.\n- For new services, set the minimum number of container instances by running\n the `gcloud run deploy` command with the\n [`--min-instances`](/sdk/gcloud/reference/run/deploy#--min-instances)\n parameter:\n\n ```bash\n gcloud run deploy SERVICE --image=IMAGE_URL --min-instances MIN-VALUE\n ```\n\n Replace:\n - \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your service.\n - \u003cvar translate=\"no\"\u003eIMAGE_URL\u003c/var\u003e with a reference to the container image, for example, `gcr.io/cloudrun/hello`.\n - \u003cvar translate=\"no\"\u003eMIN-VALUE\u003c/var\u003e with the desired number of container instances to be kept warm, ready to receive requests. Specify `default` to clear any minimum instance setting.\n\n### YAML\n\n| **Caution:** Deploying configuration changes using YAML files replaces the configuration of your existing services. Since a YAML file completely overwrites all configurations, you should avoid using multiple methods to modify your services. For example, do not use YAML files in conjunction with the Google Cloud console or `gcloud` commands.\n\nYou can download the configuration of an existing service into a\nYAML file with the `gcloud run services describe` command by using the\n[`--format=export`](/sdk/gcloud/reference/run/services/describe) flag.\nYou can then modify that YAML file and deploy\nthose changes with the `gcloud run services replace` command.\nYou must ensure that you modify only the specified attributes.\n\n1. Download the configuration of your service into a file named\n `service.yaml` on local workspace:\n\n ```bash\n gcloud run services describe SERVICE --format export \u003e service.yaml\n ```\n\n Replace \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your\n Knative serving service.\n2. In your local file, update the `autoscaling.knative.dev/minScale:`\n attribute:\n\n ```yaml\n spec:\n template:\n metadata:\n annotations:\n autoscaling.knative.dev/minScale: '\u003cvar translate=\"no\"\u003eMIN-INSTANCE\u003c/var\u003e' \n ```\n\n Replace:\n - \u003cvar translate=\"no\"\u003eMIN-VALUE\u003c/var\u003ecode\\\u003e with the desired number of container instances to be kept warm, ready to receive requests. Specify `default` to clear any minimum instance setting.\n3. Replace the service with its new configuration using the following command:\n\n ```bash\n gcloud run services replace service.yaml\n ```"]]
