Utilizzare le etichette

Scopri come creare e utilizzare le etichette nei servizi e nelle revisioni di Cloud Run for Anthos.

Le etichette sono coppie chiave/valore applicate al servizio e alle revisioni. Quando imposti un'etichetta su un servizio Cloud Run for Anthos, viene creata una nuova revisione con questa etichetta per questo servizio; l'etichetta non viene applicata alle revisioni precedenti.

Le etichette per Cloud Run for Anthos sono etichette di 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

Su Cloud Run for Anthos possono essere utilizzate solo etichette Kubernetes valide.

Impostazione o modifica delle etichette

Qualsiasi modifica della configurazione determina la creazione di una nuova revisione. Anche 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 Google Cloud Console, Google Cloud CLI o un file YAML quando esegui un deployment di un nuovo servizio o aggiorni un servizio esistente ed esegui il deployment di una revisione:

console

  1. Vai a Cloud Run for Anthos

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

  3. Assicurati che il riquadro informazioni a destra sia attivato (Mostra riquadro informazioni).

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

    Imposta etichetta

  5. Per modificare una coppia chiave-valore esistente, individua l'etichetta e modifica il valore di Valore come preferisci.

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

  7. Fai clic su Salva

Riga di comando

Puoi utilizzare l'interfaccia a riga di comando di Google Cloud 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 tuo servizio.
    • KEY1=VALUE1,KEY2=VALUE2 con un elenco separato da virgole di coppie nome/valore per ogni etichetta. Specifica il nome dell'etichetta per KEY e il valore per VALUE. Come specificare più parametri.

      • Opzioni dei parametri di comando

      Per specificare diversi insiemi di coppie chiave-valore, puoi 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 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 container, ad esempio gcr.io/myproject/my-image:latest.
    • SERVICE con il nome del tuo servizio.
    • KEY1=VALUE1,KEY2=VALUE2 con un elenco separato da virgole di coppie nome/valore per ogni etichetta. Specifica il nome dell'etichetta per KEY e il valore per VALUE. Come specificare più parametri.

      • Opzioni dei parametri di comando

      Per specificare diversi insiemi di coppie chiave-valore, puoi 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 file YAML con il comando gcloud run services describe utilizzando il flag --format=export. Puoi quindi modificare il file YAML ed eseguire il deployment di queste modifiche con il comando gcloud beta run services replace. Devi assicurarti 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 Cloud Run for Anthos.

  2. Nel tuo file locale, aggiorna l'attributo labels:

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  labels:
    LABEL: 'VALUE'

    Sostituisci

    • SERVICE il nome del tuo servizio Cloud Run for Anthos
    • LABEL con il nome dell'etichetta
    • VALUE con il valore desiderato

  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud beta run services replace service.yaml

Servizi scheda per etichetta

Puoi elencare i servizi in base all'etichetta utilizzando un filtro di 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

Per eliminare le etichette, puoi utilizzare la console o la riga di comando.

console

  1. Vai a Cloud Run for Anthos

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

  3. Assicurati che il riquadro informazioni a destra sia attivato (Mostra riquadro informazioni).

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

  5. Individua l'etichetta da eliminare.

  6. Passa il cursore a destra della casella di testo Valore accanto all'etichetta per visualizzare l'icona del Cestino, quindi fai clic sull'icona del Cestino.

  7. 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 for Anthos
  • LABEL con il nome della tua etichetta