Cloud Composer 1 | Cloud Composer 2
Questa pagina spiega come assegnare etichette ai tuoi ambienti Cloud Composer e come suddividere i costi di fatturazione in base a queste etichette.
Informazioni sulle etichette di ambiente
Le etichette di 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 di un singolo ambiente devono essere univoche. Puoi assegnare la stessa chiave e lo stesso valore a più ambienti.
Etichette di ambiente nei report di fatturazione
Le etichette di ambiente che assegni ai tuoi ambienti sono visibili nei report di fatturazione, quindi puoi suddividere i costi in base sia alle chiavi che ai valori delle etichette.
Le etichette non sono applicabili in modo retroattivo. Ad esempio, se assegni un'etichetta il 15 maggio, i costi di fatturazione del 14 maggio non conterranno l'etichetta assegnata.
Assegna etichette ai nuovi ambienti
Puoi assegnare le etichette quando crei un ambiente. Per ulteriori informazioni, consulta la sezione Creazione di ambienti.
Assegna etichette agli 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, quindi fai clic su Salva.
Attendi che l'ambiente venga aggiornato.
gcloud
Quando aggiorni un ambiente utilizzando il comando gcloud composer, i seguenti argomenti specificano le etichette per l'ambiente:
--clear-labelsrimuove tutte le etichette.--update-labelsaggiorna le etichette specificate; crea nuove etichette se non esistono già.--remove-labelsrimuove le etichette specificate; le etichette specificate che non esistono vengono ignorate.
Se utilizzi diversi 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_NAMEcon il nome dell'ambiente.LOCATIONcon la regione in cui si trova l'ambiente.LABEL_KEYcon la chiave di etichetta dell'ambiente che vuoi creare, aggiornare o rimuovere.LABEL_VALUEcon 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 Ambiente 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_KEYcon una chiave dell'etichetta dell'ambiente.LABEL_VALUEcon 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 ricerca 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 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_KEYcon una chiave dell'etichetta dell'ambiente.LABEL_VALUEcon 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 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 in una località specificata, modifica il blocco labels nella configurazione Terraform ed esegui terraform apply.
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
LABEL_KEY = "LABEL_VALUE"
}
}
Sostituisci:
LABEL_KEYcon la chiave di etichetta dell'ambiente che vuoi creare o aggiornare. Per rimuovere le etichette, elimina i campi corrispondenti.LABEL_VALUEcon il valore dell'etichetta dell'ambiente.
Esempio:
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
owner = "engineering-team"
env = "production"
}
}
Visualizza le etichette nei report
Dopo la propagazione delle etichette per il tuo ambiente ai report di fatturazione, puoi suddividere i costi di fatturazione in base a queste etichette:
Visualizza i report di fatturazione Cloud per il tuo 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.