Configura le etichette per i pool di worker

Le etichette Cloud Run sono coppie chiave-valore applicate ai pool di worker Cloud Run. Questa pagina mostra come impostare, modificare ed eliminare le etichette nei pool di worker Cloud Run. Tieni presente che quando imposti un'etichetta su un pool di worker Cloud Run, viene creata una nuova revisione con questa etichetta per questo pool di worker; l'etichetta non viene applicata alle revisioni precedenti.

I possibili utilizzi includono:

  • Ripartizioni di costi e fatturazione.
  • Identifica le risorse utilizzate da singoli team o centri di costo.
  • Distinguere gli ambienti di deployment (produzione, gestione temporanea, controllo qualità o test).
  • Identifica i proprietari e le etichette di stato.
  • Filtra i log in Logging.

Regole di utilizzo delle etichette

Si applica la seguente regola all'utilizzo delle etichette impostate su un pool di worker Cloud Run:

Su Cloud Run possono essere utilizzate solo etichette valide Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare e implementare i pool di worker Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

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.

Impostare o modificare le etichette

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che tu non apporti aggiornamenti espliciti per modificarla.

Puoi impostare o modificare le etichette utilizzando Google Cloud CLI quando crei un nuovo pool di worker o deploy un nuova revisione:

gcloud

Puoi aggiornare le etichette per un pool di worker utilizzando il comando:

gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE

Per aggiornare più di un'etichetta, fornisci un elenco di coppie chiave-valore separate da virgole. Tieni presente che il comando update-labels imposta un nuovo valore per la chiave dell'etichetta se l'etichetta esiste già, altrimenti ne crea una nuova.

Sostituisci:

  • WORKER_POOL con il nome del tuo pool di worker Cloud Run
  • KEY con il nome della chiave dell'etichetta
  • VALUE con il valore della chiave

Puoi anche impostare le etichette durante l'implementazione:

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

Per creare più di un'etichetta durante il deployment, fornisci un elenco di coppie chiave-valore separate da virgole.

Elenco dei servizi per etichetta

Puoi elencare i servizi per etichetta utilizzando un filtro Google Cloud CLI:

  gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE

Sostituisci:

  • LABEL con il nome dell'etichetta
  • VALUE con il valore da includere nell'elenco filtrato

Elimina un'etichetta da un worker pool

Puoi utilizzare Google Cloud CLI per eliminare le etichette in un pool di worker.

gcloud

Per cancellare tutte le etichette da un pool di worker:

gcloud beta run worker-pools update WORKER_POOL --clear-labels

Per eliminare etichette specifiche da un pool di worker, fornisci un elenco di chiavi separate da virgole:

gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL

Sostituisci:

  • WORKER_POOL con il nome del tuo pool di worker Cloud Run
  • LABEL con il nome della tua etichetta