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 Cloud Run Developer (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 Eseguire 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, esegui il comando seguente:

gcloud run worker-pools list

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

API REST

Per visualizzare l'elenco dei pool di worker nel tuo progetto, invia una richiesta HTTP GET a l'endpoint workerPool dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X GET \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools

Sostituisci quanto segue:

  • ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i pool di worker. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container di Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
  • PROJECT_ID: l' Google Cloud ID progetto.
  • REGION: la Google Cloud regione dei pool di worker.

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 visualizzarne il riquadro dei dettagli.

gcloud

Per visualizzare i dettagli di un pool di worker: 

gcloud 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 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 run worker-pools describe WORKER_POOL --format export > workerpool.yaml

API REST

Per visualizzare i dettagli di un pool di worker, invia una richiesta HTTP GET a workerPool dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X GET \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL

Sostituisci quanto segue:

  • ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i dettagli del pool di worker. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container di Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
  • PROJECT_ID: l' Google Cloud ID progetto.
  • REGION: la Google Cloud regione del pool di worker.
  • WORKER_POOL: il nome del pool di worker.

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 fai clic sul pool di worker che vuoi disattivare nell'elenco dei pool di worker.

  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 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 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/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 comando seguente:

    gcloud run worker-pools replace workerpool.yaml

API REST

Per disattivare un pool di worker, invia una richiesta HTTP PATCH a workerPool dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "Content-Type: application/json" \
   -X PATCH \
   -d '{"scaling":{"manualInstanceCount":0}}' \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.manualInstanceCount

Sostituisci quanto segue:

  • ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per disattivare 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. Da un'istanza container di Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
  • PROJECT_ID: l' Google Cloud ID progetto.
  • REGION: la Google Cloud regione del pool di worker.
  • WORKER_POOL: il nome del tuo pool di worker.

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 o meno i carichi di lavoro.
  • 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 Eliminare le 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 seleziona il pool di worker che vuoi eliminare dall'elenco dei pool di worker.

  3. Fai clic su Elimina.

gcloud

Per eliminare un pool di worker, utilizza il comando:

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

API REST

Per eliminare un pool di worker, invia una richiesta HTTP DELETE a l'endpoint workerPool dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X DELETE \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL

Sostituisci quanto segue:

  • ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per eliminare 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. Da un'istanza container di Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
  • PROJECT_ID: l' Google Cloud ID progetto.
  • REGION: la Google Cloud regione del pool di worker.
  • WORKER_POOL: il nome del tuo pool di worker.