Gestire i worker pool

Questa pagina descrive come visualizzare le informazioni su un pool di worker ed eliminare i pool di worker.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i pool di worker e le revisioni dei pool di worker di Cloud Run, chiedi all'amministratore di concederti il ruolo IAM Sviluppatore Cloud Run (roles/run.developer) nel pool di worker di Cloud Run.

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 di Cloud Run interagisce con Google Cloud API, 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.

Crea un pool di worker

Cloud Run crea un nuovo pool di worker la prima volta che esegui il deployment di un'immagine container. Per ulteriori istruzioni, consulta Esegui il deployment di un nuovo pool di worker.

Visualizza l'elenco dei pool di worker nel progetto

Utilizza la Google Cloud console o Google Cloud CLI per visualizzare un elenco dei pool di worker disponibili nel tuo progetto:

console

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

    Vai a Cloud Run

  2. Seleziona Pool di worker dal menu. I pool di worker disponibili sono elencati nella pagina.

gcloud

Per elencare i pool di worker nel tuo progetto:

gcloud beta run worker-pools list

Puoi filtrare questo elenco in base alle proprietà della definizione del pool di worker, ad esempio un' etichetta assegnata.

Visualizza ulteriori dettagli su un pool di worker

Utilizza la Google Cloud console, Google Cloud CLI o YAML per visualizzare ulteriori dettagli su un pool di worker:

console

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

    Vai a Cloud Run

  2. Seleziona Pool di worker dal menu per visualizzare i pool di worker disponibili.

  3. Fai clic sul pool di worker per visualizzare il riquadro dei dettagli.

gcloud

Per visualizzare i dettagli di un pool di worker: 

gcloud beta run worker-pools describe WORKER_POOL
 Sostituisci WORKER_POOL con il nome del pool di worker.

Puoi utilizzare il --format flag per formattare l'output. Ad esempio, per formattare l'output come YAML:

gcloud beta run worker-pools describe WORKER_POOL
    --region REGION
    --format yaml

Sostituisci:

  • WORKER_POOL con il nome del pool di worker.
  • REGION con la Google Cloud regione del pool di worker.

YAML

Per visualizzare i dettagli di un pool di worker, scarica la relativa configurazione YAML:

gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

Disattiva un pool di worker esistente

La disattivazione di un pool di worker comporta l'arresto di tutte le istanze per quel pool di worker. Per disattivare un pool di worker, imposta la scalabilità su zero:

console

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

    Vai a Cloud Run

  2. Seleziona Pool di worker dal menu, quindi, dall'elenco dei pool di worker, fai clic sul pool di worker che vuoi disattivare.

  3. Fai clic sull'icona a forma di matita a destra di Scalabilità: manuale (istanze: ) e modifica il valore in 0.

  4. Fai clic su Salva per aggiornare e disattivare il pool di worker.

gcloud 

gcloud beta run worker-pools update WORKER_POOL --instances=0

Sostituisci WORKER_POOL con il nome del tuo 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 beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. Imposta la scalabilità su un valore di 0 per disattivare il pool di worker. L'esempio seguente contiene la configurazione YAML:

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/launch-stage: BETA
    run.googleapis.com/scalingMode: manual
    run.googleapis.com/manualInstanceCount: `0`

    Sostituisci quanto segue:

    • WORKER_POOL: il nome del tuo pool di worker di Cloud Run.

  3. Crea o aggiorna il pool di worker utilizzando il seguente comando:

    gcloud beta run worker-pools replace workerpool.yaml

Elimina i pool di worker esistenti

Le seguenti considerazioni si applicano all'eliminazione di un pool di worker:

  • L'eliminazione di un pool di worker comporta l'eliminazione di tutte le risorse correlate a questo pool di worker, incluse tutte le revisioni di questo pool di worker, indipendentemente dal fatto che stiano elaborando carichi di lavoro o meno.
  • L'eliminazione di un pool di worker non comporta la rimozione automatica delle immagini container da Artifact Registry. Per eliminare le immagini container utilizzate dalle revisioni eliminate da Artifact Registry, consulta Eliminazione delle immagini.
  • Dopo aver eliminato un pool di worker, il pool di worker rimane visibile in Google Cloud CLI finché l'eliminazione non è completamente terminata. Tuttavia, non puoi aggiornare il pool di worker.

  • L'eliminazione di un pool di worker è permanente. Non è possibile annullare o ripristinare l'operazione.

console

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

    Vai a Cloud Run

  2. Seleziona Pool di worker dal menu, quindi, dall'elenco dei pool di worker, seleziona il pool di worker che vuoi eliminare.

  3. Fai clic su Elimina.

gcloud

Per eliminare un pool di worker, utilizza il comando:

gcloud beta run worker-pools delete WORKER_POOL --region REGION

Sostituisci:

  • WORKER_POOL con il nome del tuo pool di worker.
  • REGION con la Google Cloud regione del pool di worker.