Scopri come creare e utilizzare le etichette nei tuoi servizi Knative serving e revisioni.
Le etichette sono coppie chiave/valore applicate al servizio e alle revisioni. Quando imposti un'etichetta su un servizio Knative serving, una nuova revisione viene creata questa etichetta per il servizio; l'etichetta non viene applicata ai vecchi revisioni.
Le etichette di Knative serving sono Etichette delle risorse Kubernetes, e non vengono propagate in Google Cloud. Per ulteriori informazioni sull'utilizzo per analizzare l'utilizzo delle risorse del cluster, Informazioni sull'utilizzo delle risorse del cluster.
Regole di utilizzo delle etichette
Su Knative serving possono essere utilizzate solo etichette Kubernetes valide.
Impostare o modificare le etichette
Qualsiasi modifica alla configurazione porta la creazione di una nuova revisione. Anche le revisioni successive ricevono automaticamente di questa configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.
Puoi impostare o modificare le etichette utilizzando la console Google Cloud, Google Cloud CLI, o un file YAML quando esegui il deployment di service o aggiornare un servizio esistente esegui il deployment di una revisione:
Console
- Vai a Knative serving nella console Google Cloud:
Seleziona la casella di controllo a sinistra del servizio per cui stai impostando l'etichetta attiva.
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 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.
Riga di comando
Puoi utilizzare Google Cloud CLI per impostare le etichette per nuovi servizi o per aggiornare servizi esistenti:
Per i servizi esistenti, aggiorna le etichette eseguendo
gcloud run services update
con uno dei seguenti parametri:Esempio:
gcloud run services update SERVICE --update-labels KEY1=VALUE1,KEY2=VALUE2
Sostituisci:
- SERVICE con il nome del tuo servizio.
- KEY1=VALUE1,KEY2=VALUE2 separati da una virgola un elenco di coppie di nomi e valori per ogni etichetta. Specifica il nome di ogni etichetta KEY e il valore per VALUE. Come specificare più parametri.
Opzioni dei parametri del comando
Per specificare diversi insiemi di coppie chiave/valore, è possibile specificare più parametri per la leggibilità. Esempio:[...] --set-labels "KEY=VALUE1" \ --set-labels "KEY=VALUE2" \ --set-labels "KEY=VALUE3"
Per i nuovi servizi, imposta le etichette eseguendo il comando
gcloud run deploy
con--set-labels
:gcloud run deploy SERVICE --image=IMAGE_URL --set-labels KEY1=VALUE1,KEY2=VALUE2
Sostituisci:
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
gcr.io/cloudrun/hello
. - SERVICE con il nome del tuo servizio.
- KEY1=VALUE1,KEY2=VALUE2 separati da una virgola un elenco di coppie di nomi e valori per ogni etichetta. Specifica il nome di ogni etichetta KEY e il valore per VALUE. Come specificare più parametri.
Opzioni dei parametri del comando
Per specificare diversi insiemi di coppie chiave/valore, è possibile specificare più parametri per la leggibilità. Esempio:[...] --set-labels "KEY=VALUE1" \ --set-labels "KEY=VALUE2" \ --set-labels "KEY=VALUE3"
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
YAML
Puoi scaricare la configurazione di un servizio esistente in un
YAML con il comando gcloud run services describe
utilizzando
--format=export
.
Puoi quindi modificare il file YAML ed eseguire il deployment
queste modifiche con il comando gcloud run services replace
.
Assicurarsi di modificare solo gli attributi specificati.
Scarica la configurazione del tuo servizio in un file denominato
service.yaml
nell'area di lavoro locale:gcloud run services describe SERVICE --format export > service.yaml
Sostituisci SERVICE con il nome del tuo servizio Knative serving.
Nel file locale, aggiorna l'attributo
labels
:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE labels: LABEL: 'VALUE'
Sostituisci
- SERVICE con il nome del tuo servizio Knative serving
- LABEL con il nome dell'etichetta
- VALUE con il valore desiderato
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
gcloud run services replace service.yaml
Elenco dei 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
Eliminazione di un'etichetta
Puoi utilizzare la console o la riga di comando per eliminare le etichette.
Console
- Vai a Knative serving nella console Google Cloud:
Seleziona la casella di controllo a sinistra del servizio per cui stai eliminando l'etichetta. da cui proviene.
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 che vuoi eliminare.
Passa il cursore a destra della casella di testo Valore in corrispondenza dell'etichetta. visualizzare l'icona del cestino e fai clic sull'icona stessa.
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 delimitato da virgole di chiavi:
gcloud run services update SERVICE --remove-labels LABEL
Sostituisci
- SERVICE con il nome del tuo servizio Knative serving
- LABEL con il nome della tua etichetta