Utilizzare le etichette

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina mostra come impostare, modificare ed eliminare le etichette nei servizi Cloud Run, nelle revisioni e nei job Cloud Run. Per Cloud Run, le etichette sono coppie chiave/valore applicate al servizio, alla revisione o al job. Tieni presente che, quando imposti un'etichetta su un servizio Cloud Run, viene creata una nuova revisione del servizio o con questa etichetta per questo servizio; l'etichetta non viene applicata alle revisioni precedenti.

I possibili utilizzi includono:

  • Utilizzalo per l'allocazione dei costi e le analisi di fatturazione.
  • Identificare le risorse utilizzate dai singoli team o dai centri di costo
  • Distinguere gli ambienti di deployment (produzione, gestione temporanea, qa o test)
  • Identifica proprietari, etichette di stato.
  • Filtrare i log in Logging

Regole di utilizzo delle etichette

La seguente regola si applica all'uso delle etichette impostate in un servizio o job Cloud Run:

Su Cloud Run è possibile utilizzare solo etichette Google Cloud valide.

Impostare o modificare le etichette

Puoi impostare etichette sui servizi e sui job Cloud Run.

Per i servizi Cloud Run

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, la riga di comando gcloud o un file YAML quando esegui il deployment di una nuova revisione.

Console

  1. Vai a Cloud Run

  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 aggiornare le etichette per un servizio utilizzando il comando:

gcloud run services update SERVICE --update-labels KEY=VALUE

Per aggiornare più di un'etichetta, fornisci un elenco delimitato da virgole di coppie chiave/valore. Tieni presente che il comando update-labels imposta un nuovo valore per la chiave dell'etichetta se 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 per la 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 delimitato da virgole di coppie chiave/valore.

YAML

Puoi scaricare e visualizzare la configurazione del servizio esistente utilizzando il comando gcloud run services describe --format export, che restituisce risultati puliti in formato YAML. Puoi quindi modificare i campi descritti di seguito e caricare il file YAML modificato con il comando gcloud run services replace. Assicurati di modificare solo i campi come documentato.

  1. Per visualizzare e scaricare la configurazione:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Aggiorna gli attributi labels in due punti:

    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 tuo servizio Cloud Run
    • LABEL con il nome dell'etichetta
    • VALUE con il valore desiderato
    • REVISION con un nuovo nome di revisione o eliminalo (se presente). Se si fornisce un nuovo nome di revisione, deve soddisfare i seguenti criteri:
      • Inizia con SERVICE-
      • Contiene solo lettere minuscole, numeri e -
      • Non termina con -
      • Non superi i 63 caratteri

    metadata.labels imposta le etichette sull'oggetto di servizio, mentre spec.template.metadata.label imposta le etichette sulla revisione creata. Solo le etichette impostate nella revisione vengono trasmesse ai log e alla fatturazione.

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

    gcloud run services replace service.yaml

Terraform

Aggiungi quanto segue a una risorsa google_cloud_run_service nella configurazione Terraform, nell'attributo template. Questo applica due etichette, foo (il cui valore è bar) e baz (il cui valore è quux), alla tua istanza Cloud Run.

metadata {
  # Labels
  # https://cloud.google.com/run/docs/configuring/labels
  labels = {
    foo : "bar"
    baz : "quux"
  }
}

Per applicare la configurazione Terraform in un progetto Google Cloud, completa i passaggi seguenti:

  1. Avvia Cloud Shell.
  2. Imposta il progetto Google Cloud a cui vuoi applicare la configurazione Terraform:
    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    
  3. Crea una directory e apri un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf:
    mkdir DIRECTORY && cd DIRECTORY && nano main.tf
    
  4. Copia l'esempio in main.tf.
  5. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
  6. Salva le modifiche premendo Ctrl-x, quindi y.
  7. Inizializza Terraform:
    terraform init
  8. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative:
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  9. Applica la configurazione Terraform eseguendo il comando seguente e inserendo yes nel prompt:
    terraform apply

    Attendi finché Terraform non visualizza il messaggio "Applica completato".

  10. Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle tue risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Per job Cloud Run

Per impostare un'etichetta su un job Cloud Run:

  1. Per impostare un'etichetta su un nuovo job:

    gcloud beta run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    Sostituisci

    • JOB_NAME con il nome del lavoro.
    • KEY con il nome della chiave di etichetta
    • VALUE con il valore per la chiave
    • Sostituisci IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
  2. Per impostare un'etichetta su un job esistente:

    gcloud beta run jobs update JOB_NAME --labels KEY=VALUE

Per creare più di un'etichetta, fornisci un elenco delimitato da virgole di coppie chiave/valore.

Elenca servizi 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 su un servizio

Per un servizio puoi eliminare le etichette dalla console o dalla riga di comando.

Console

  1. Vai a Cloud Run

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