Configurare le etichette

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 API Google Cloud, come le librerie client Cloud, consulta la guida alla configurazione dell'identità del 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