Imposta il numero minimo di istanze (servizi)

Console

1. Nella console Google Cloud, vai a Cloud Run:

   Vai a Cloud Run

2. Se stai configurando un nuovo servizio, fai clic su Crea servizio . Se stai configurando un servizio esistente, fai clic sul servizio per visualizzarne i dettagli fai clic sull'icona a forma di penna accanto a Numero minimo di istanze in alto a destra nel riquadro dei dettagli.

3. Individua il modulo Scalabilità automatica servizio:

   

4. Nel campo Numero minimo di istanze: specificare il numero di istanze di container da mantenere attive, pronte a ricevere richieste.

5. Fai clic su Crea per un nuovo servizio o su Esegui il deployment per un servizio esistente.

gcloud

Aggiorna service-min-instances per un determinato servizio utilizzando il comando seguente:

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

Sostituisci

• SERVICE con il nome del tuo servizio e
• MIN-VALUE con il numero di container di mantenere attive le istanze, pronte a ricevere richieste. Specifica default per cancellare eventuali impostazioni minime dell'istanza.

In alternativa, puoi impostare service-min-instances durante deployment utilizzando il comando:

gcloud beta run deploy --image IMAGE_URL --service-min-instances MIN-VALUE

Sostituisci

• IMAGE_URL con un riferimento all'immagine container, per ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già creati. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
• MIN-VALUE con il numero di container di mantenere attive le istanze, pronte a ricevere richieste. Specifica default per cancellare eventuali impostazioni minime dell'istanza.

YAML

1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

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

2. Aggiorna l'attributo run.googleapis.com/minScale:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
     annotations:
       run.googleapis.com/launch-stage: BETA
       run.googleapis.com/minScale: 'MIN_INSTANCE'

   Sostituisci

   • SERVICE con il nome del tuo servizio Cloud Run
   • MIN-INSTANCE con il numero di istanze da sono tenute in caldo e pronte a ricevere richieste.

3. Crea o aggiorna il servizio utilizzando il comando seguente:

   gcloud run services replace service.yaml

Librerie client

Per aggiornare il numero minimo di istanze del livello di servizio per il tuo servizio dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per aggiornare il numero minimo di istanze a livello di servizio per un determinato servizio, invia un PATCH Richiesta HTTP all'API Cloud Run Admin Endpoint service.

Ad esempio, se utilizzi curl:

curl -H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-X PATCH \
-d '{ "scaling": { "minInstanceCount": MIN-VALUE }}' \
https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.minInstanceCount

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per aggiornare un servizio. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un utilizzando gcloud auth print-access-token. Dall'interno di un'istanza di container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza di container.
• MIN-VALUE con il numero di istanze di container da mantenere in uso, pronti a ricevere richieste.
• SERVICE con il nome del servizio.
• REGION con la regione Google Cloud del servizio.
• PROJECT-ID con l'ID progetto Google Cloud.

Console

1. Nella console Google Cloud, vai a Cloud Run:

   Vai a Cloud Run

2. Fai clic sul servizio che ti interessa per aprire il riquadro Dettagli servizio.

3. L'impostazione attuale viene mostrata in alto a destra nel riquadro dei dettagli del servizio, accanto a Numero minimo di istanze.

gcloud

1. Utilizza questo comando:

   gcloud run services describe SERVICE

2. Individua il valore per Service-level Min Instances (Istanze minime a livello di servizio): nel configurazione.

Console

1. Nella console Google Cloud, vai a Cloud Run:

   Vai a Cloud Run

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

3. Se stai configurando un nuovo servizio, compila il servizio iniziale pagina delle impostazioni come preferisci, poi fai clic su Container, volumi, networking, sicurezza per espandere pagina di configurazione del servizio.

4. Fai clic sulla scheda Contenitore.

   

   • Nel campo Numero minimo di istanze: e specificare il numero desiderato di istanze di container da tenere in uso, pronte a ricevere richieste.

5. Fai clic su Crea o Esegui il deployment.

gcloud

Puoi aggiornare min-instance di un determinato servizio utilizzando il seguente comando:

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

Sostituisci

• SERVICE con il nome del tuo servizio e
• MIN-VALUE con il numero desiderato di container di mantenere attive le istanze, pronte a ricevere richieste. Specifica default per cancellare eventuali impostazioni minime dell'istanza.

Puoi anche impostare min-instance durante deployment utilizzando il comando:

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

Sostituisci

• IMAGE_URL con un riferimento all'immagine container, per ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già creati. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
• MIN-VALUE con il numero desiderato di container di mantenere attive le istanze, pronte a ricevere richieste. Specifica default per cancellare eventuali impostazioni minime dell'istanza.

YAML

1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

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

2. Aggiorna l'attributo autoscaling.knative.dev/minScale::

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 'MIN-INSTANCE'
         name: REVISION

   Sostituisci

   • SERVICE con il nome del tuo servizio Cloud Run
   • MIN-INSTANCE con il numero desiderato di istanze sono tenute in caldo e pronte a ricevere richieste.
   • REVISION con un nuovo nome di revisione o eliminala (se presente). Se fornisci un nuovo nome per la revisione, deve soddisfare i seguenti criteri:
     • Inizia con SERVICE-
     • Contiene solo lettere minuscole, numeri e -
     • Non termina con -
     • Non deve superare i 63 caratteri

3. Crea o aggiorna il servizio utilizzando il comando seguente:

   gcloud run services replace service.yaml

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta: Comandi Terraform di base.

La seguente risorsa google_cloud_run_v2_service specifica un numero minimo di istanze di 1 in template.scaling. Sostituisci 1 con il numero minimo di istanze.

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-min-instances"
  location = "us-central1"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    scaling {
      # Min instances
      min_instance_count = 1
    }
  }
}

Console

1. Nella console Google Cloud, vai a Cloud Run:

   Vai a Cloud Run

2. Fai clic sul servizio che ti interessa per aprire la pagina Dettagli servizio.

3. Fai clic sulla scheda Revisioni.

4. Nel riquadro dei dettagli a destra, l'impostazione del numero minimo di istanze a livello di revisione è elencato nella scheda Contenitore.

gcloud

1. Utilizza questo comando:

   gcloud run services describe SERVICE

2. Individua l'impostazione del numero minimo di istanze a livello di revisione nel configurazione.