Le etichette di Cloud Run sono coppie chiave/valore applicate ai job Cloud Run. Questa pagina mostra come impostare, modificare ed eliminare le etichette nei job Cloud Run.
I possibili usi includono:
- Da utilizzare per l'allocazione dei costi e le suddivisioni della fatturazione.
- Identificare le risorse utilizzate dai singoli team o dai singoli centri di costo.
- Distinguere gli ambienti di deployment (produzione, gestione temporanea, QA o test).
- Identifica i proprietari, le etichette degli stati.
- Filtra i log in Logging.
Regole di utilizzo delle etichette
La seguente regola si applica all'uso delle etichette impostate in un job Cloud Run:
Su Cloud Run è consentito utilizzare solo etichette Google Cloud valide.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:
-
Sviluppatore Cloud Run (
roles/run.developer
) sul job Cloud Run -
Utente account di servizio (
roles/iam.serviceAccountUser
) sull'identità del servizio
Per un elenco dei ruoli e delle autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di 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
Puoi utilizzare Google Cloud CLI o YAML per impostare un'etichetta su un job Cloud Run.
gcloud
Per impostare un'etichetta per un nuovo job:
gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE
Sostituisci
- JOB_NAME con il nome del tuo job.
- KEY con il nome della chiave di etichetta
- VALUE con il valore della chiave
- Sostituisci IMAGE_URL con un riferimento all'immagine container, ad
esempio
us-docker.pkg.dev/cloudrun/container/job:latest
.
Per impostare un'etichetta su un job esistente:
gcloud run jobs update JOB_NAME --labels KEY=VALUE
Per creare più di un'etichetta, fornisci un elenco di coppie chiave/valore delimitato da virgole.
gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2
YAML
Se stai creando un nuovo job, salta questo passaggio. Se stai aggiornando un job esistente, scarica la relativa configurazione YAML:
gcloud run jobs describe JOB_NAME --format export > job.yaml
Aggiorna gli attributi
labels
in due posizioni:apiVersion: run.googleapis.com/v1 kind: Job metadata: labels: LABEL: VALUE spec: template: metadata: labels: LABEL: VALUE
Sostituisci
- LABEL con il nome dell'etichetta
- VALUE con il valore desiderato
Puoi anche specificare ulteriori configurazioni, come le variabili di ambiente o i limiti di memoria.
Aggiorna la configurazione del job esistente:
gcloud run jobs replace job.yaml
Elenca i job per etichetta
Puoi elencare i job per etichetta utilizzando un filtro Google Cloud CLI:
gcloud run jobs list --filter metadata.labels.LABEL=VALUE
Sostituisci:
- LABEL con il nome dell'etichetta
- VALUE con il valore da includere nell'elenco filtrato
Eliminare un'etichetta in un job
Per cancellare tutte le etichette da un job:
gcloud run jobs update JOB --clear-labels
Per eliminare etichette specifiche da un servizio, fornisci un elenco di chiavi delimitato da virgole:
gcloud run jobs update JOB --remove-labels LABEL
Sostituisci
- JOB con il nome del tuo job Cloud Run
- LABEL con il nome della tua etichetta