Utilizza le etichette

Questa pagina mostra come impostare, modificare ed eliminare le etichette nel job Cloud Run, nelle revisioni e nei job Cloud Run. Per Cloud Run, le etichette sono coppie chiave/valore applicate al servizio, alla revisione o al job. Tieni presente che quando imposti un'etichetta su un servizio Cloud Run, viene creata una nuova revisione di servizio o con questa etichetta per il servizio e non viene applicata alle revisioni meno recenti.

I possibili utilizzi includono:

Da utilizzare per l'allocazione dei costi e le suddivisioni della fatturazione.
Identificare le risorse utilizzate dai singoli team o dai centri di costo
Distinguere gli ambienti di deployment (produzione, gestione temporanea, qa 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'uso delle etichette impostate su un servizio o un job Cloud Run:

Su Cloud Run è possibile utilizzare solo etichette Google Cloud valide.

Impostare o modificare etichette

Puoi impostare etichette sui servizi e sui job di Cloud Run.

Per i servizi Cloud Run

Qualsiasi modifica alla configurazione porta alla creazione di una nuova revisione. Le revisioni successive riceveranno 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

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

Riga di comando

Puoi aggiornare le etichette per 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 dell'etichetta se esiste già, altrimenti crea una nuova etichetta.

Sostituisci

SERVICE con il nome del tuo servizio Cloud Run
KEY con il nome della chiave dell'etichetta
VALUE con il valore per la 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 nel 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 solo i campi 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 o eliminalo (se presente). Se fornisci un nuovo nome di 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 nella revisione vengono trasmesse 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, vedi Comandi Terraform di base.

Aggiungi quanto segue a una risorsa google_cloud_run_service nella configurazione di Terraform, sotto l'attributo template. In questo modo vengono applicate due etichette, foo (il cui valore è bar) e baz (il cui valore è quux), all'istanza Cloud Run.

run/container_template/main.tf

Visualizza su GitHub Feedback

metadata {
  # Labels
  # https://cloud.google.com/run/docs/configuring/labels
  labels = {
    foo : "bar"
    baz : "quux"
  }
}

Per job Cloud Run

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

Riga di comando

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 per la chiave
- Sostituisci IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.

Per impostare un'etichetta su un job esistente:

gcloud run jobs update JOB_NAME --labels KEY=VALUE

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

Scarica e visualizza la configurazione del job esistente utilizzando il comando gcloud run jobs describe --format export, che restituisce risultati puliti in formato YAML. Quindi, modifica i campi descritti di seguito e carica il file YAML modificato utilizzando il comando gcloud run jobs replace. Assicurati di modificare solo i campi come documentato.

Per visualizzare e scaricare la configurazione:

gcloud run jobs describe JOB_NAME --format export > job.yaml

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 più configurazioni, ad esempio variabili di ambiente o limiti di memoria.
Aggiorna la configurazione del job esistente:
```
gcloud run jobs replace job.yaml
```

Elenca servizi o job per etichetta

Puoi elencare servizi o job per etichetta utilizzando un filtro Google Cloud CLI:

Per i servizi:

  gcloud run services list --filter metadata.labels.LABEL=VALUE

Per le offerte di lavoro:

  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 su un servizio

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

Console

Vai a Cloud Run
Seleziona la casella di controllo a sinistra del servizio da cui stai eliminando l'etichetta.
Assicurati che il riquadro informazioni a destra sia attivato (Mostra riquadro informazioni).
Fai clic su Etichette per visualizzare il riquadro delle etichette.
Individua l'etichetta da eliminare.
Passa il mouse a destra della casella di testo Valore per visualizzare l'icona del cestino e fai clic sull'icona.
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 dell'etichetta

Elimina un'etichetta su 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 delimitato da virgole:

gcloud run jobs update JOB --remove-labels LABEL

Replace

  * <var>JOB</var> with name of your Cloud Run service
  * <var>LABEL</var> with the name of your label