Scalabilità manuale per i pool di worker

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:

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

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

    Vai a Cloud Run

  2. 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.

  3. Individua il modulo Scalabilità (per un nuovo pool di worker) o il modulo Modifica scalabilità per un pool di worker esistente.

    immagine

  4. Nel campo Numero di istanze, specifica il numero di istanze di container per il pool di worker.

  5. Completa la specifica.

  6. 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 0 per disattivare il pool di worker.
  • IMAGE_URL: un riferimento all'immagine container che contiene il pool di worker, ad esempio us-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

  1. 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
  2. Imposta scalingMode su manual e specifica manualInstanceCount:

    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 0 per disabilitare il pool di worker.
  3. 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 replace utilizza il file worker-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 esempio us-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 0 per 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 utilizzando gcloud 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

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

    Vai a Cloud Run

  2. Fai clic su Pool di worker per visualizzare l'elenco dei pool di worker di cui è stato eseguito il deployment.

  3. Fai clic sul pool di worker che vuoi esaminare per visualizzare il relativo riquadro dei dettagli.

  4. 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.

Passaggi successivi