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.

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

Alla creazione di etichette in un job Cloud Run si applica la seguente regola:

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

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 Cloud Run e Autorizzazioni IAM 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 ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Impostare o modificare le etichette

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

gcloud

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

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

    Sostituisci

    • JOB_NAME con il nome del job.
    • KEY con il nome della chiave dell'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.

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

    gcloud run jobs update JOB_NAME --labels KEY=VALUE

  3. Per creare più di un'etichetta, fornisci un elenco delimitato da virgole di coppie chiave/valore.

    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_NAME --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

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

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

  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:

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

Elenco dei 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 lavoro: 

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

  • JOB con il nome del tuo job Cloud Run
  • LABEL con il nome della tua etichetta