La scalabilità manuale consente di impostare un numero specifico di istanze senza richiedere il deployment. Utilizza la scalabilità manuale quando il tuo workload richiede un numero fisso di istanze o quando vuoi controllare il conteggio delle istanze dal tuo sistema.
Per scalare automaticamente le istanze in base all'utilizzo della CPU anziché impostare un numero fisso di istanze, consulta Configura la scalabilità automatica della CPU per i pool di worker.
Considerazioni sulla fatturazione quando si utilizza la scalabilità manuale
Quando utilizzi la scalabilità manuale, tutte le istanze che hai richiesto vengono fatturate come istanze attive, anche se sono inattive. Per i dettagli completi sulla fatturazione, consulta la pagina dei prezzi.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment dei pool di worker Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Cloud Run Developer (
roles/run.developer) sul pool di worker Cloud Run - Utente dell'account di servizio (
roles/iam.serviceAccountUser) sull'identità di servizio
Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo pool di worker Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.
Configura la scalabilità
La modifica della modalità di scalabilità o del numero di istanze manuali non crea una nuova revisione.
Per configurare la modalità di scalabilità, utilizza la console Google Cloud , Google Cloud CLI, YAML, Terraform o l'API REST:
Console
Nella console Google Cloud , vai a Cloud Run:
Se stai configurando un nuovo pool di worker, seleziona Pool di worker dal menu e fai clic su Esegui il deployment del container. Se stai configurando un pool di worker esistente, fai clic sul pool di worker per visualizzare il riquadro dei dettagli, quindi fai clic sull'icona a forma di penna accanto a Scalabilità in alto a destra nel riquadro dei dettagli.
Individua il modulo Scalabilità (per un nuovo pool di worker) o il modulo Modifica scalabilità per un pool di worker esistente.
Nel campo Numero di istanze, specifica il numero di istanze di container per il pool di worker.
Completa la specifica.
Fai clic su Crea per un nuovo pool di worker o su Salva per un pool di worker esistente.
gcloud
- Per specificare la scalabilità manuale per un nuovo pool di worker, esegui questo comando con il flag
--scaling:
gcloud beta run worker-pools deploy WORKER_POOL \ --scaling=INSTANCE_COUNT \ --image IMAGE_URL
Sostituisci quanto segue:
- WORKER_POOL: il nome del tuo pool di worker.
- INSTANCE_COUNT: il numero di istanze per il pool di worker.
In questo modo, il pool di worker viene impostato sulla scalabilità manuale. Specifica un valore pari a
0per disattivare il pool di worker. IMAGE_URL: un riferimento all'immagine container che contiene il pool di worker, ad esempious-docker.pkg.dev/cloudrun/container/worker-pool:latest.Per specificare la scalabilità manuale per un pool di worker esistente, esegui questo comando con il flag
--scaling:
gcloud beta run worker-pools update WORKER_POOL \ --scaling=INSTANCE_COUNT
Sostituisci quanto segue:
- WORKER_POOL: il nome del tuo pool di worker.
- INSTANCE_COUNT: il numero di istanze per il pool di worker.
YAML
Se stai creando un nuovo pool di worker, salta questo passaggio. Se stai aggiornando un pool di worker esistente, scarica la relativa configurazione YAML:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Imposta
scalingModesumanuale specificamanualInstanceCount:apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/scalingMode: manual run.googleapis.com/manualInstanceCount: "INSTANCE_COUNT"
Sostituisci quanto segue:
- WORKER_POOL: il nome del pool di worker Cloud Run.
- INSTANCE_COUNT: il numero di istanze di cui stai eseguendo lo scale up o lo scale down manualmente per il pool di worker. Specifica il valore
0per disabilitare il pool di worker.
Crea o aggiorna il pool di worker utilizzando il seguente comando:
gcloud run worker-pools replace worker-pool.yaml
Per impostazione predefinita, il comando
gcloud run worker-pools replaceutilizza il fileworker-pool.yaml, se presente.
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
template {
containers {
image = "IMAGE_URL"
}
}
scaling {
scaling_mode = "MANUAL"
manual_instance_count = "INSTANCE_COUNT"
}
}
Sostituisci quanto segue:
- WORKER_POOL: il nome del pool di worker.
- REGION: la regione Google Cloud , ad esempio
europe-west1. IMAGE_URL: un riferimento all'immagine container che contiene il pool di worker, ad esempious-docker.pkg.dev/cloudrun/container/worker-pool:latest.- INSTANCE_COUNT: il numero di istanze per il pool di worker.
In questo modo, il pool di worker viene impostato sulla scalabilità manuale. Specifica un valore pari a
0per disattivare il pool di worker.
API REST
Per aggiornare il numero di istanze per un determinato pool di worker, invia una richiesta HTTP PATCH all'endpoint workerPools.patch dell'API Cloud Run Admin:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X PATCH \ -d '{"scaling":{"scalingMode":"MANUAL","manualInstanceCount":INSTANCE_COUNT}}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.scalingMode,scaling.manualInstanceCount
Sostituisci quanto segue:
- ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per aggiornare un pool di worker.
Ad esempio, se hai eseguito l'accesso a
gcloud, puoi recuperare un token di accesso utilizzandogcloud auth print-access-token. All'interno di un'istanza container di Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container. - INSTANCE_COUNT: il numero di istanze per il pool di worker.
- PROJECT_ID: l'ID progetto Google Cloud .
- REGION: la regione Google Cloud in cui è stato eseguito il deployment del pool di worker.
- WORKER_POOL: il nome del pool di worker.
Visualizza la configurazione di scalabilità per un pool di worker
Nella console Google Cloud , vai a Cloud Run:
Fai clic su Pool di worker per visualizzare l'elenco dei pool di worker di cui è stato eseguito il deployment.
Fai clic sul pool di worker che vuoi esaminare per visualizzare il relativo riquadro dei dettagli.
L'impostazione di scalabilità attuale viene visualizzata sopra l'elenco delle revisioni dei pool di worker: Scalabilità: manuale (istanze: ).
Disabilita un pool di worker
Per disabilitare un pool di worker, esegui questo comando con il flag --scaling=0:
gcloud beta run worker-pools update WORKER_POOL --scaling=0
Sostituisci WORKER_POOL con il nome del tuo pool di worker.