Configurare le etichette per i job

Le etichette 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.

Gli utilizzi possibili includono:

  • Allocazione dei costi e analisi dettagliate della fatturazione.
  • Identificare 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

La seguente regola si applica all'utilizzo delle etichette impostate su un job Cloud Run:

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

Etichette per i dati di fatturazione e il logging

La fatturazione Cloud riceve solo le etichette specificate nell'attributo metadata.labels in YAML o nell'argomento labels di primo livello in Terraform. Cloud Logging riceve solo le etichette specificate nell'attributo spec.template.metadata.labels in YAML o in template in Terraform. Per propagare le etichette sia alla fatturazione Cloud sia a Cloud Logging, specifica le etichette in entrambe le posizioni quando utilizzi YAML o Terraform. Se configuri le etichette utilizzando la console Google Cloud o Google Cloud CLI, Cloud Run aggiunge le etichette agli attributi metadata.labels e spec.template.metadata.labels.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i job 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 di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo job Cloud Run interagisce con le APIGoogle Cloud , 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.

Imposta o modifica le etichette

Puoi utilizzare la console Google Cloud , Google Cloud CLI, YAML o Terraform per impostare un'etichetta su un job Cloud Run.

Console

  1. Nella console Google Cloud , vai alla pagina Job di Cloud Run:

    Vai a Cloud Run

  2. Seleziona la casella di controllo a sinistra del job per cui stai impostando l'etichetta.

  3. Assicurati che il riquadro informazioni all'estrema destra sia attivato (Mostra riquadro informazioni).

  4. Fai clic su Etichette per visualizzare il riquadro delle etichette.

    Imposta etichetta

  5. Per modificare il valore di una chiave di etichetta esistente, individua l'etichetta e modifica il Valore.

  6. Per impostare una nuova etichetta sul servizio, fai clic su Aggiungi etichetta e fornisci la chiave e il valore.

  7. Fai clic su Salva.

gcloud

  1. Per impostare un'etichetta su un nuovo job:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    Sostituisci quanto segue:

    • JOB_NAME con il nome del tuo job.
    • KEY con il nome della chiave dell'etichetta.
    • VALUE con il valore della chiave.
    • IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.

  2. Per impostare un'etichetta su un job esistente:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE

  3. Per creare più etichette, fornisci un elenco di coppie chiave/valore delimitate da virgole.

    gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2

YAML

  1. 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 --format export > job.yaml

  2. 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 quanto segue:

    • LABEL con il nome dell'etichetta.
    • VALUE con il valore scelto.

    Puoi anche specificare altre configurazioni, ad esempio variabili di ambiente o limiti di memoria.

    metadata.labels imposta le etichette sull'oggetto job, mentre spec.template.metadata.labels imposta le etichette sul template di esecuzione. Cloud Run propaga le etichette impostate in metadata.labels alla fatturazione Cloud e le etichette impostate in spec.template.metadata.labels a Cloud Logging.

  3. Aggiorna la configurazione del job esistente:

    gcloud run jobs replace job.yaml

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Aggiungi quanto segue a una risorsa google_cloud_run_v2_job nella configurazione Terraform:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

Sostituisci quanto segue:

  • JOB_NAME: il nome del job Cloud Run.
  • REGION: la regione Google Cloud . Ad esempio europe-west1.
  • LABEL: il nome dell'etichetta.
  • VALUE: il valore scelto.

L'argomento labels di primo livello imposta le etichette sul job, mentre l'argomento labels sotto template imposta le etichette sul template di esecuzione. Cloud Run propaga labels di primo livello alla fatturazione Cloud e propaga labels impostato in template a Cloud Logging.

Elenca i job per etichetta

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

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE

Sostituisci quanto segue:

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

Elimina un'etichetta da 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 separate da virgole: 

gcloud run jobs update JOB --remove-labels LABEL

Sostituisci quanto segue:

  • JOB: il nome del job Cloud Run
  • LABEL: il nome dell'etichetta