Gestire le revisioni del pool di worker

Quando esegui il deployment in un pool di worker o modifichi la configurazione di un pool di worker, Cloud Run crea una revisione immutabile.

Per le revisioni si applicano le seguenti considerazioni:

  • Non è necessario eliminare manualmente le revisioni, anche se puoi farlo se vuoi.
  • Le revisioni inattive non consumano risorse e non vengono fatturate.
  • Esiste un limite massimo di 1000 revisioni per pool di worker: se superi questo limite, le revisioni meno recenti vengono eliminate automaticamente.
  • Il suffisso della revisione viene assegnato automaticamente. Se vuoi utilizzare il tuo suffisso di versione, puoi farlo utilizzando il parametro gcloud CLI --revision-suffix.

Ruoli obbligatori

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

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM Cloud Run e Autorizzazioni IAM 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 ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Visualizza l'elenco delle revisioni per un worker pool

gcloud

Per visualizzare l'elenco delle revisioni per un determinato pool di worker:

  1. Trova il nome del tuo pool di worker nell'elenco dei pool di worker disponibili nel tuo progetto:

    gcloud beta run worker-pools list
  2. Utilizza il seguente comando per ottenere tutte le revisioni per il pool di worker:

    gcloud beta run worker-pools revisions list
       --worker-pool=WORKER_POOL
       --region=REGION

    Sostituisci:

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

Visualizzare i dettagli della revisione

gcloud

Per visualizzare i dettagli di una revisione nel tuo progetto:

  1. Trova il nome del tuo pool di worker nell'elenco dei pool di worker disponibili nel tuo progetto:

    gcloud beta run worker-pools list

  2. Utilizza il seguente comando per ottenere tutte le revisioni del pool di worker che hai appena cercato:

    gcloud beta run worker-pools revisions list
        --worker-pool=WORKER_POOL
        --region=REGION

    Sostituisci

    • WORKER_POOL con il nome del tuo pool di worker.
    • REGION con la regione Google Cloud del worker pool.
  3. Utilizza il seguente comando per visualizzare ulteriori dettagli su una revisione specifica:

    gcloud beta run worker-pools revisions describe REVISION --region=REGION --worker-pool=WORKER_POOL

    Sostituisci

    • REVISION con il nome della revisione di cui vuoi saperne di più.
    • REGION con la regione Google Cloud del worker pool.
    • WORKER_POOL con il nome del pool di worker.

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

    gcloud beta run worker-pools revisions describe REVISION
        --region=REGION
        --worker-pool=WORKER_POOL
        --format yaml

Tieni presente che una revisione non corrente potrebbe avere lo stato RETIRED, il che significa che Cloud Run ha ritirato l'infrastruttura necessaria per quella revisione specifica.

Elimina revisioni

Un caso d'uso comune per l'eliminazione di una revisione è quando vuoi assicurarti che una determinata revisione non venga utilizzata per errore.

Non puoi eliminare una revisione se:

  • L'unica revisione del pool di worker.
  • L'ultima revisione del pool di worker.

Quando elimini una revisione, l'immagine container utilizzata da questa revisione non viene eliminata automaticamente da Artifact Registry. Per eliminare un'immagine container da Artifact Registry, consulta le istruzioni per l'eliminazione per Artifact Registry.

Non puoi annullare l'eliminazione di una revisione.

Utilizza Google Cloud CLI per eliminare una revisione:

gcloud

Per eliminare una revisione, utilizza il seguente comando:

gcloud beta run worker-pools revisions delete REVISION 
    --region=REGION
    --worker-pool=WORKER_POOL

Sostituisci

  • REVISION con il nome della revisione che stai eliminando.
  • WORKER_POOL con il nome del tuo pool di worker.
  • REGION con la regione Google Cloud del worker pool.

Passaggi successivi

Dopo aver eseguito il deployment di una revisione, puoi: