Gestire le revisioni del pool di worker

Anteprima — pool di worker di Cloud Run

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

Le seguenti considerazioni si applicano alle revisioni:

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

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.

Visualizzare l'elenco delle revisioni per 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 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 beta run worker-pools list

2. Utilizza il seguente comando per ottenere tutte le revisioni per quel pool di worker:

   gcloud beta 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 i 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 beta run worker-pools list

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

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

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

Passaggi successivi

Dopo aver eseguito il deployment di una revisione, puoi:

• Eseguire implementazioni graduali, rollback delle revisioni e divisioni delle istanze