Utilizzare le etichette

Scopri come creare e utilizzare le etichette nelle revisioni e nei servizi Knative serving.

Le etichette sono coppie chiave/valore applicate al servizio e alle revisioni. Quando imposta un'etichetta su un servizio Knative serving, viene creata una nuova revisione con questa etichetta per il servizio. L'etichetta non viene applicata alle revisioni precedenti.

Le etichette per Knative serving sono etichette delle risorse Kubernetes, e non vengono propagate a Google Cloud. Per scoprire di più sull'utilizzo delle etichette per analizzare l'utilizzo delle risorse del cluster, consulta Informazioni sull'utilizzo delle risorse del cluster.

Regole di utilizzo delle etichette

In Knative serving è consentito l'utilizzo solo di etichette Kubernetes valide.

Impostazione o modifica delle etichette

Qualsiasi modifica alla configurazione comporta 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 Google Cloud CLI o un file YAML quando esegui il deployment di un nuovo servizio o aggiorni un servizio esistente e esegui il deployment di una revision:

Console

  1. Vai a Erogazione Knative nella console Google Cloud :

Vai a Knative serving

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

  2. Assicurati che il riquadro Informazioni in fondo a destra sia attivo (Mostra riquadro Informazioni).

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

    Imposta etichetta

  4. Per modificare un valore della chiave dell'etichetta esistente, individua l'etichetta e modifica il valore come preferisci.

  5. Per impostare una nuova etichetta sul 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 i nuovi servizi o per aggiornare i servizi esistenti:

  • Per i servizi esistenti, aggiorna le etichette eseguendo il comando 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 servizio.
    • KEY1=VALUE1,KEY2=VALUE2 con un elenco di coppie di nome e valore per ogni etichetta separato da virgole. Specifica il nome dell'etichetta per ogni KEY e il valore per VALUE. Come specificare più parametri.

      • Opzioni del parametro del comando

      Per specificare più insiemi di coppie chiave-valore, puoi indicare 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 il parametro --set-labels:

    gcloud run deploy SERVICE --image=IMAGE_URL --set-labels KEY1=VALUE1,KEY2=VALUE2

    Sostituisci:

    • IMAGE_URL con un riferimento all'immagine del container, ad esempio gcr.io/cloudrun/hello.
    • SERVICE con il nome del servizio.
    • KEY1=VALUE1,KEY2=VALUE2 con un elenco di coppie di nome e valore per ogni etichetta separato da virgole. Specifica il nome dell'etichetta per ogni KEY e il valore per VALUE. Come specificare più parametri.

      • Opzioni del parametro del comando

      Per specificare più insiemi di coppie chiave-valore, puoi indicare 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 file YAML con il comando gcloud run services describe utilizzando il --format=export flag. Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

  1. Scarica la configurazione del servizio in un file denominato service.yaml nello spazio di lavoro locale:

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

    Sostituisci SERVICE con il nome del 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 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

Eliminare un'etichetta

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

Console

  1. Vai a Erogazione Knative nella console Google Cloud :

Vai a Knative serving

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

  2. Assicurati che il riquadro Informazioni in fondo a destra sia attivo (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 del mouse a destra della casella di testo Valore per l'etichetta per visualizzare l'icona del cestino, quindi fai clic sull'icona.

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

gcloud run services update SERVICE --remove-labels LABEL

Sostituisci

  • SERVICE con il nome del servizio Knative serving
  • LABEL con il nome dell'etichetta