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:

  • Da utilizzare per l'allocazione dei costi e la suddivisione della fatturazione.
  • Identifica le risorse utilizzate dai singoli team o centri di costo.
  • Distingui gli ambienti di deployment (produzione, gestione temporanea, QA o test).
  • Identifica i proprietari, le etichette dello stato.
  • Filtra i log in Logging.

Regole di utilizzo delle etichette

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

In Cloud Run è consentito l'utilizzo solo di 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:

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 tuo job Cloud Run si interfaccia con le APIGoogle Cloud , ad esempio le librerie client di Cloud, consulta la guida alla configurazione dell'identità di servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta le autorizzazioni di deployment e gestisci l'accesso.

Impostare o modificare le etichette

Puoi utilizzare Google Cloud CLI o YAML 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 del 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 di coppie chiave/valore separate 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_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 desiderato

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

  3. Aggiorna la configurazione del job esistente:

    gcloud run jobs replace job.yaml

Elenco job per etichetta

Puoi elencare i job in base all'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 separate da virgole: 

gcloud run jobs update JOB --remove-labels LABEL

Sostituisci

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