Gestire le revisioni del pool di worker

Le revisioni del pool di worker di Cloud Run ti consentono di monitorare la cronologia della configurazione ed eseguire il rollback agli stati di deployment precedenti. Ogni deployment o aggiornamento della configurazione di un pool di worker crea una revisione immutabile.

Le revisioni inattive non consumano risorse né comportano costi, quindi non è necessario eliminare manualmente le revisioni. Ogni pool di worker conserva fino a 1000 revisioni ed elimina automaticamente quelle meno recenti quando superi questo limite.

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.

Visualizzare l'elenco delle revisioni per un pool di worker

Ogni nome di revisione include un suffisso assegnato automaticamente, a meno che non specifichi un suffisso personalizzato durante il deployment con il flag --revision-suffix di Google Cloud CLI.

console

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

    Vai a Cloud Run

  2. Seleziona Pool di worker dal menu per visualizzare l'elenco dei pool di worker.

gcloud

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

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

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

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

    Sostituisci:

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

Visualizzare dettagli della revisione

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 una revisione nel tuo progetto:

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

    gcloud run worker-pools list

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

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

    Sostituisci

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

    gcloud 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 Google Cloud regione del pool di worker.
    • 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 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.

Eliminare le revisioni

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

Non puoi eliminare una revisione se:

  • È l'unica revisione del pool di worker.
  • È la revisione più recente 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 di Artifact Registry.

Non puoi annullare l'eliminazione di una revisione.

Utilizza la Google Cloud console o Google Cloud CLI per eliminare una revisione:

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.

  4. Fai clic su Revisioni.

  5. Seleziona la revisione da eliminare.

  6. Fai clic sui puntini di sospensione in Azioni, quindi fai clic su Elimina per eliminare la revisione.

gcloud

Per eliminare una revisione, utilizza il comando seguente:

gcloud 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 pool di worker.
  • REGION con la Google Cloud regione del pool di worker.

Passaggi successivi

Dopo aver eseguito il deployment di una revisione, puoi: