Utilizzo delle etichette

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

  1. Vai a Knative serving nella console Google Cloud:

Vai a Knative serving

  1. Seleziona la casella di controllo a sinistra del servizio per cui stai impostando l'etichetta attiva.

  2. Assicurati che il riquadro informazioni all'estrema destra sia attivato (Mostra riquadro Informazioni).

  3. Fai clic su Etichette per visualizzare il riquadro delle etichette.

    Imposta etichetta

  4. Per modificare il valore-chiave di un'etichetta esistente, individua l'etichetta e modifica Valore a tua scelta.

  5. Per impostare una nuova etichetta per il servizio, fai clic su Aggiungi etichetta e fornisci la chiave. e il valore.

  6. 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"

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.

  1. 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.

  2. 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

  3. 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

  1. Vai a Knative serving nella console Google Cloud:

Vai a Knative serving

  1. Seleziona la casella di controllo a sinistra del servizio per cui stai eliminando l'etichetta. da cui proviene.

  2. Assicurati che il riquadro informazioni all'estrema destra sia attivato (Mostra riquadro Informazioni).

  3. Fai clic su Etichette per visualizzare il riquadro delle etichette.

  4. Individua l'etichetta che vuoi eliminare.

  5. 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.

  6. 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