Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3
Questa pagina spiega come assegnare etichette agli ambienti Cloud Composer e come suddividere i costi di fatturazione in base a queste etichette.
Informazioni sulle etichette di ambiente
Le etichette dell'ambiente sono coppie chiave-valore che puoi assegnare ai tuoi ambienti. Ad esempio, se owner:engineering-team
è un'etichetta personalizzata,
owner
è la chiave e engineering-team
è il valore.
Ogni ambiente può avere più etichette, ma le chiavi di etichetta per una singola deve essere univoco. 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 agli ambienti sono visibili nella fatturazione per analizzare i costi in base a chiavi e valori 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 le etichette durante la creazione di un ambiente. Per ulteriori informazioni, consulta Creazione di ambienti.
Assegna etichette ad ambienti esistenti
Console
Vai alla pagina Ambienti nella console Google Cloud:
Seleziona il tuo ambiente.
Vai alla scheda Etichette.
Fai clic su Modifica e poi su Aggiungi etichetta.
Aggiungi una coppia chiave-valore per l'etichetta, poi fai clic su Salva.
Attendi che l'ambiente venga aggiornato.
gcloud
Quando aggiorni un ambiente utilizzando
del comando gcloud composer
, i seguenti argomenti
specificare le etichette per l'ambiente:
--clear-labels
rimuove tutte le etichette.--update-labels
aggiorna le etichette specificate e 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, verranno 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 di ambiente che vuoi creare, aggiornare o rimuovere.LABEL_VALUE
con il valore etichetta di 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 di 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 sostitutivo.
Aggiornare singole etichette
Per aggiornare un'etichetta o aggiungerne una nuova alle etichette esistenti, includi
labels.LABEL_KEY
nel parametro di query updateMask
e fornisci un
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 di 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 singole etichette
Per rimuovere le etichette, includi labels.LABEL_KEY
nel parametro di query updateMask
e non fornire il valore sostitutivo.
Terraform
Per creare un ambiente con parametri predefiniti,
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 oppure aggiornamento. 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 per il tuo ambiente sono state propagate ai report di fatturazione, puoi suddividere i costi di fatturazione in base a queste etichette:
Visualizza i report di fatturazione Cloud per di account di fatturazione Cloud.
Nella pagina Report:
- Fai clic su Mostra filtri.
- Nella finestra di dialogo Filtri, espandi la sezione Etichette.
- Filtra i dati visualizzati in base alle chiavi e ai valori delle etichette dell'ambiente.