Gestisci le etichette dell'ambiente e scomponi i costi

Managed Airflow (terza generazione) | Managed Airflow (seconda generazione) | Managed Airflow (prima generazione legacy)

Questa pagina spiega come assegnare etichette agli ambienti Managed Airflow e poi suddividere i costi di fatturazione in base a queste etichette.

Informazioni sulle etichette dell'ambiente

Le etichette dell'ambiente sono coppie chiave-valore che puoi assegnare ai tuoi ambienti. Ad esempio, se owner:engineering-team è un'etichetta personalizzata, allora owner è la chiave e engineering-team è il valore.

Ogni ambiente può avere più etichette, ma le chiavi delle etichette per un singolo ambiente devono essere univoche. Puoi assegnare la stessa chiave e lo stesso valore a più ambienti.

Etichette dell'ambiente nei report di fatturazione

Le etichette dell'ambiente che assegni ai tuoi ambienti sono visibili nei report di fatturazione, quindi puoi suddividere i costi in base alle chiavi e ai valori delle etichette.

Le etichette non vengono applicate in modo retroattivo. Ad esempio, se assegni un'etichetta il 15 maggio, i costi di fatturazione del 14 maggio non contengono l'etichetta assegnata.

Assegnare etichette a nuovi ambienti

Puoi assegnare etichette quando crei un ambiente. Per ulteriori informazioni, consulta Creare ambienti.

Assegnare etichette agli ambienti esistenti

Console

  1. Vai alla pagina Ambienti nella Google Cloud console:

    Vai ad Ambienti

  2. Seleziona l'ambiente.

  3. Vai alla scheda Etichette.

  4. Fai clic su Modifica, quindi su Aggiungi etichetta.

  5. Aggiungi una coppia chiave-valore per l'etichetta, quindi fai clic su Salva.

  6. Attendi l'aggiornamento dell'ambiente.

gcloud

Quando aggiorni un ambiente utilizzando il gcloud composer comando, i seguenti argomenti specificano le etichette per l'ambiente:

  • --clear-labels rimuove tutte le etichette.

  • --update-labels aggiorna le etichette specificate; crea nuove etichette se non esistono già.

  • --remove-labels rimuove le etichette specificate; le etichette specificate che non esistono vengono ignorate.

Se utilizzi più di questi argomenti, vengono applicati nel seguente ordine: --clear-labels, --update-labels, --remove-labels.

Aggiornare o creare etichette

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-labels LABEL_KEY=LABEL_VALUE

Rimuovere le etichette specificate

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-labels LABEL_KEY

Rimuovere tutte le etichette

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-labels

Sostituisci:

  • ENVIRONMENT_NAME con il nome dell'ambiente.
  • LOCATION con la regione in cui si trova l'ambiente.
  • LABEL_KEY con la chiave di etichetta dell'ambiente che vuoi creare, aggiornare o rimuovere.
  • LABEL_VALUE con il valore dell'etichetta dell'ambiente.

Esempio

L'esempio seguente aggiorna l'etichetta owner, crea la nuova etichetta env e rimuove l'etichetta misc:

gcloud composer environments update example-environment \
    --location us-central1 \
    --update-labels owner=engineering-team,env=production \
    --remove-labels misc

API

Quando aggiorni un ambiente, nella risorsa Environment, specifica le nuove etichette dell'ambiente.

Sostituire tutte le etichette

Per sostituire tutte le etichette, includi labels nel parametro di query updateMask e fornisci una sostituzione nel corpo della richiesta.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Sostituisci:

  • LABEL_KEY con una chiave dell'etichetta dell'ambiente.
  • LABEL_VALUE con un nuovo valore per l'etichetta dell'ambiente.

Esempio:

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Rimuovere tutte le etichette

Per rimuovere tutte le etichette, includi labels nel parametro di query updateMask e non fornire il valore di sostituzione.

Aggiornare le singole etichette

Per aggiornare un'etichetta o aggiungere una nuova etichetta alle etichette esistenti, includi labels.LABEL_KEY nel parametro di query updateMask e fornisci una sostituzione nel corpo della richiesta.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Sostituisci:

  • LABEL_KEY con una chiave dell'etichetta dell'ambiente.
  • LABEL_VALUE con un nuovo valore per l'etichetta dell'ambiente.

Esempio:

// PATCH https://composer.googleapis.com/v1/
// ?name=projects/example-project/locations/
// us-central1/environments/example-environment
// &updateMask=labels.owner,labels.env

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Rimuovere le singole etichette

Per rimuovere le etichette, includi labels.LABEL_KEY nel parametro di query updateMask e non fornire il valore di sostituzione.

Terraform

Per creare un ambiente con parametri predefiniti in una località specificata, modifica il blocco labels nella configurazione di Terraform ed esegui terraform apply.

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Sostituisci:

  • LABEL_KEY con la chiave di etichetta dell'ambiente che vuoi creare o aggiornare. Per rimuovere le etichette, elimina i relativi campi.
  • LABEL_VALUE con il valore dell'etichetta dell'ambiente.

Esempio:

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    owner = "engineering-team"
    env = "production"
  }
}

Visualizzare le etichette nei report

Dopo che le etichette del tuo ambiente sono state propagate ai report di fatturazione, puoi suddividere i costi di fatturazione in base a queste etichette:

  1. Visualizza i report di fatturazione Cloud per il tuo account di fatturazione Cloud.

  2. Nella pagina Report:

    1. Fai clic su Mostra filtri.
    2. Nella finestra di dialogo Filtri, espandi la sezione Etichette.
    3. Filtra i dati visualizzati in base alle chiavi e ai valori delle etichette dell'ambiente.

Passaggi successivi