Configura etichette

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

Le possibili applicazioni includono:

Da utilizzare per l'allocazione dei costi e le suddivisioni della fatturazione.
Identificare le risorse utilizzate dai singoli team o dai singoli centri di costo.
Distinguere gli ambienti di deployment (produzione, gestione temporanea, controllo qualità o test).
Identificare i proprietari, 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 servizio Cloud Run:

In Cloud Run è consentito utilizzare solo etichette Google Cloud valide.

Impostare o modificare le etichette

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche per le revisioni successive verrà applicata automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.

Puoi impostare o modificare le etichette utilizzando la console Google Cloud, la riga di comando gcloud o un file YAML quando esegui il deployment di una nuova revisione.

Console

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Seleziona la casella di controllo a sinistra del servizio su cui stai impostando l'etichetta.
Assicurati che il riquadro Informazioni all'estrema destra sia attivato (Mostra riquadro informazioni).
Fai clic su Etichette per visualizzare il riquadro delle etichette.
Per modificare una coppia chiave-valore di etichetta esistente, individua l'etichetta e modifica il Valore come preferisci.
Per impostare una nuova etichetta sul servizio, fai clic su Aggiungi etichetta e fornisci la chiave e il valore.
Fai clic su Salva

Riga di comando

Puoi aggiornare le etichette di un servizio utilizzando il comando:

gcloud run services update SERVICE --update-labels KEY=VALUE

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

Sostituisci

SERVICE con il nome del tuo servizio Cloud Run
KEY con il nome della chiave di etichetta
VALUE con il valore della chiave

Puoi anche impostare le etichette durante l'implementazione:

gcloud run deploy SERVICE --image IMAGE --labels KEY=VALUE

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

YAML

Puoi scaricare e visualizzare le configurazioni di servizio esistenti utilizzando il comando gcloud run services describe --format export, che restituisce risultati puliti in formato YAML. Puoi quindi modificare i campi descritti di seguito e caricare il file YAML modificato utilizzando il comando gcloud run services replace. Assicurati di modificare i campi solo come documentato.

Per visualizzare e scaricare la configurazione:

gcloud run services describe SERVICE --format export > service.yaml

Aggiorna gli attributi labels in due posizioni:
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE
      name: REVISION
```
Sostituisci
- SERVICE con il nome del tuo servizio Cloud Run
- LABEL con il nome dell'etichetta
- VALUE con il valore desiderato
- REVISION con un nuovo nome di revisione oppure eliminala (se presente). Se specifichi un nuovo nome, la revisione deve soddisfare i seguenti criteri:
  - Inizia con SERVICE-
  - Contiene solo lettere minuscole, numeri e -
  - Non termina con -
  - Non supera i 63 caratteri
metadata.labels imposta le etichette sull'oggetto di servizio, mentre spec.template.metadata.label imposta le etichette sulla revisione creata. Solo le etichette impostate sulla revisione vengono passate ai log e alla fatturazione.
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Terraform

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

Lo snippet seguente aggiunge due etichette, foo (il cui valore è bar) e baz (il cui valore è quux), alla tua istanza Cloud Run utilizzando una risorsa google_cloud_run_v2_service nella configurazione di Terraform.

Aggiungendo le etichette in template come mostrato, vengono impostate le etichette per la revisione: solo le etichette impostate per la revisione vengono passate ai log e alla fatturazione. Se aggiungi le etichette a una posizione diversa da template, l'etichetta viene impostata per il servizio e non per la revisione.

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-labels"
  location = "us-central1"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    # Labels
    labels = {
      foo : "bar"
      baz : "quux"
    }
  }
}

Sostituisci la

name con il nome del tuo servizio.
Proprietà location con la località utilizzata per il servizio.
image con la tua immagine container.
foo e baz con i tuoi nomi per le etichette.
bar e quux con i tuoi valori di etichetta.

Elenca servizi per etichetta

Puoi elencare i servizi per etichetta utilizzando un filtro dell'interfaccia a riga di comando di Google Cloud:

  gcloud run services 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 su un servizio

Puoi utilizzare la console o la riga di comando per eliminare le etichette su un servizio.

Console

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Seleziona la casella di controllo a sinistra del servizio da cui stai eliminando l'etichetta.
Assicurati che il riquadro Informazioni all'estrema destra sia attivato (Mostra riquadro informazioni).
Fai clic su Etichette per visualizzare il riquadro delle etichette.
Individua l'etichetta da eliminare.
Passa il cursore a destra della casella di testo Valore relativa all'etichetta per visualizzare l'icona del cestino, poi fai clic sull'icona del cestino.
Fai clic su Salva

Riga di comando

Per cancellare tutte le etichette da un servizio:

gcloud run services update SERVICE --clear-labels

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

gcloud run services update SERVICE --remove-labels LABEL

Sostituisci

SERVICE con il nome del tuo servizio Cloud Run
LABEL con il nome della tua etichetta