Configura le etichette per le istanze

Le etichette Cloud Run sono coppie chiave-valore applicate alle istanze Cloud Run. Questa pagina mostra come impostare, modificare ed eliminare le etichette sulle istanze Cloud Run. Tieni presente che quando imposti un'etichetta su un'istanza Cloud Run, per questa istanza viene creata una nuova revisione con questa etichetta; l'etichetta non viene applicata alle revisioni precedenti.

I possibili utilizzi includono:

  • Allocazione dei costi e suddivisioni della fatturazione.
  • Identificare le risorse utilizzate da singoli team o centri di costo.
  • Distinguere gli ambienti di deployment (produzione, gestione temporanea, QA o test).
  • Identificare i proprietari e le etichette di stato.
  • Filtrare i log in Logging.

Regole di utilizzo delle etichette

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

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

Etichette per dati di fatturazione e logging

Fatturazione Cloud e Cloud Logging ricevono solo le etichette specificate nell' attributo spec.template.metadata.labels in YAML o in template in Terraform. Se configuri le etichette utilizzando la Google Cloud CLI, Cloud Run le aggiunge agli attributi metadata.labels e spec.template.metadata.labels.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment delle istanze 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 la tua istanza Cloud Run interagisce con Google Cloud API, 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.

Impostare o modificare le etichette

Puoi impostare o modificare le etichette utilizzando Google Cloud CLI:

gcloud

Puoi aggiornare le etichette di un'istanza utilizzando il comando:

gcloud beta run instances update INSTANCE --update-labels KEY=VALUE

Per aggiornare più di un'etichetta, fornisci un elenco di coppie chiave-valore delimitato da virgole. Tieni presente che il comando update-labels imposta un nuovo valore per la chiave di etichetta se l'etichetta esiste già, altrimenti ne crea una nuova.

Sostituisci quanto segue:

  • INSTANCE: il nome dell'istanza Cloud Run.
  • KEY: il nome della chiave di etichetta.
  • VALUE: il valore della chiave.

Puoi anche impostare le etichette durante il deployment:

gcloud beta run instances deploy INSTANCE --image IMAGE --labels KEY=VALUE

Per creare più di un'etichetta durante il deployment, fornisci un elenco di coppie chiave-valore delimitato da virgole.

YAML

  1. Se stai creando una nuova istanza, salta questo passaggio. Se stai aggiornando un'istanza esistente, scarica la relativa configurazione YAML:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. L'esempio seguente contiene la configurazione YAML:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    Sostituisci quanto segue:

    • INSTANCE: il nome dell'istanza Cloud Run.
    • KEY e VALUE: le coppie chiave-valore per le etichette.

    metadata.labels imposta le etichette sull'oggetto istanza, mentre spec.template.metadata.labels imposta le etichette sulla revisione creata. Cloud Run propaga al fatturazione Cloud e Cloud Logging solo le etichette impostate sulla revisione.

  3. Crea o aggiorna l'istanza utilizzando il seguente comando:

    gcloud beta run instances replace instance.yaml

Elencare le istanze per etichetta

Puoi elencare le istanze per etichetta utilizzando un filtro Google Cloud CLI:

  gcloud beta run instances list --filter metadata.labels.LABEL=VALUE

Sostituisci quanto segue:

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

Eliminare un'etichetta su un'istanza

Puoi utilizzare Google Cloud CLI per eliminare le etichette su un'istanza.

gcloud

Per cancellare tutte le etichette da un'istanza:

gcloud beta run instances update INSTANCE --clear-labels

Per eliminare etichette specifiche da un'istanza, fornisci un elenco di chiavi delimitato da virgole:

gcloud beta run instances update INSTANCE --remove-labels LABEL

Sostituisci quanto segue:

  • INSTANCE: il nome dell'istanza Cloud Run.
  • LABEL: il nome dell'etichetta.