Questa pagina è stata tradotta dall'API Cloud Translation.

Configura etichette

Le etichette Cloud Run sono coppie chiave/valore applicate al servizio e alle revisioni Cloud Run. Questa pagina mostra come impostare, modificare Eliminare le etichette sul servizio Cloud Run e sulle revisioni. Tieni presente che quando imposti un'etichetta su un'istanza di Cloud Run servizio, per questo servizio viene creata una nuova revisione con questa etichetta; il 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 singoli centri di costo.
Distingui gli ambienti di deployment (produzione, gestione temporanea, QA o test).
Identifica i proprietari, le etichette degli stati.
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:

Solo etichette Google Cloud valide e possono essere utilizzati su Cloud Run.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment dei servizi Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Cloud Run Developer (roles/run.developer) nel servizio Cloud Run
Utente account di servizio (roles/iam.serviceAccountUser) sull'identità del servizio

Per un elenco di ruoli e autorizzazioni IAM associati Cloud Run, consulta Ruoli IAM di Cloud Run e le autorizzazioni IAM di Cloud Run. Se il servizio Cloud Run interagisce con le API Google Cloud, come le librerie client di Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta le autorizzazioni di deployment e gestisci l'accesso.

Impostare o modificare le etichette

Qualsiasi modifica alla configurazione porta la creazione di una nuova revisione. Anche le revisioni successive acquisiranno 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 per cui stai impostando l'etichetta.
Assicurati che il riquadro Informazioni in fondo a destra sia attivo (Mostra riquadro Informazioni).
Fai clic su Etichette per visualizzare il riquadro delle etichette.
Per modificare il valore-chiave di un'etichetta esistente, individua l'etichetta e modifica Valore a tua scelta.
Per impostare una nuova etichetta per il servizio, fai clic su Aggiungi etichetta e fornisci la chiave. e il valore.
Fai clic su Salva.

gcloud

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 di coppie chiave/valore delimitato da virgole in coppia. Tieni presente che il comando update-labels imposta un nuovo valore per l'etichetta se l'etichetta esiste già, altrimenti ne crea una nuova.

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 il deployment:

gcloud run deploy SERVICE --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

Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:
```
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 servizio Cloud Run
- LABEL con il nome dell'etichetta
- VALUE con il valore desiderato
- REVISION con un nuovo nome di revisione o eliminala (se presente). Se fornisci un nuovo nome di revisione, questo deve soddisfare i seguenti criteri:
  - Inizia con SERVICE-
  - Deve contenere solo lettere minuscole, numeri e -
  - Non termina con -
  - Non deve superare i 63 caratteri
metadata.labels imposta le etichette sull'oggetto di servizio, mentre spec.template.metadata.label imposta etichette sulla revisione creata. Solo le etichette impostate nella revisione vengono passate ai log e alla fatturazione.
Crea o aggiorna il servizio 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), all'istanza Cloud Run utilizzando una risorsa google_cloud_run_v2_service nella configurazione Terraform.

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

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

  deletion_protection = false # set to "true" in production

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

Sostituisci

name con il nome del servizio.
La proprietà location con la posizione utilizzata per il servizio.
image con l'immagine del container.
foo e baz con i nomi delle tue etichette.
bar e quux con i tuoi valori di etichetta.

Elenco servizi per etichetta

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

  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 in 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 in fondo a destra sia attivo (Mostra riquadro Informazioni).
Fai clic su Etichette per visualizzare il riquadro delle etichette.
Individua l'etichetta che vuoi eliminare.
Passa il cursore del mouse a destra della casella di testo Valore per l'etichetta per visualizzare l'icona del cestino, quindi fai clic sull'icona.
Fai clic su Salva.

gcloud

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 delimitato da virgole di chiavi:

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