Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3
Auf dieser Seite wird erläutert, wie Sie Cloud Composer-Umgebungen Labels zuweisen und dann die Abrechnungskosten basierend auf diesen Labels aufschlüsseln.
Informationen zu Umgebungslabels
Umgebungslabels sind Schlüssel/Wert-Paare, die Sie Ihren Umgebungen zuweisen können. Wenn owner:engineering-team beispielsweise ein benutzerdefiniertes Label ist, ist owner der Schlüssel und engineering-team der Wert.
Jede Umgebung kann mehrere Labels haben, die Labelschlüssel für eine einzelne Umgebung müssen jedoch eindeutig sein. Sie können mehreren Umgebungen denselben Schlüssel und Wert zuweisen.
Umgebungslabels in Abrechnungsberichten
Umgebungslabels, die Sie Ihren Umgebungen zuweisen, werden in Abrechnungsberichten angezeigt. Sie können die Kosten also nach Schlüsseln und Werten der Labels aufschlüsseln.
Labels gelten nicht rückwirkend. Wenn Sie beispielsweise am 15. Mai ein Label zuweisen, enthalten die Abrechnungskosten für 14. Mai nicht das zugewiesene Label.
Labels neuen Umgebungen zuweisen
Sie können beim Erstellen einer Umgebung Labels zuweisen. Weitere Informationen finden Sie unter Umgebungen erstellen.
Labels vorhandenen Umgebungen zuweisen
Console
Rufen Sie in der Google Cloud Console die Seite Umgebungen auf:
Wählen Sie Ihre Umgebung aus.
Öffnen Sie den Tab Labels.
Klicken Sie zuerst auf Bearbeiten und dann auf Label hinzufügen.
Fügen Sie ein Schlüssel/Wert-Paar für das Label hinzu und klicken Sie auf Speichern.
Warten Sie, bis die Umgebung aktualisiert wurde.
gcloud
Wenn Sie eine Umgebung mit dem Befehl gcloud composer aktualisieren, geben die folgenden Argumente Labels für die Umgebung an:
--clear-labelsentfernt alle Labels.--update-labelsaktualisiert angegebene Labels; Erstellt neue Labels, wenn sie noch nicht vorhanden sind.--remove-labelsentfernt angegebene Labels; Nicht existente angegebene Labels werden ignoriert.
Wenn Sie mehrere dieser Argumente verwenden, werden sie in der folgenden Reihenfolge angewendet: --clear-labels, --update-labels, --remove-labels.
Labels aktualisieren oder erstellen
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--update-labels LABEL_KEY=LABEL_VALUE
Angegebene Labels entfernen
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--remove-labels LABEL_KEY
Alle Labels entfernen
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--clear-labels
Ersetzen Sie:
ENVIRONMENT_NAMEdurch den Namen der Umgebung.LOCATIONdurch die Region, in der sich die Umgebung befindet.LABEL_KEYdurch den Umgebungslabelschlüssel, den Sie erstellen, aktualisieren oder entfernen möchten.LABEL_VALUEdurch den Umgebungslabelwert.
Beispiel
Im folgenden Beispiel wird das Label owner aktualisiert, das neue Label env erstellt und das Label misc entfernt:
gcloud composer environments update example-environment \
--location us-central1 \
--update-labels owner=engineering-team,env=production \
--remove-labels misc
API
Wenn Sie eine Umgebung aktualisieren, geben Sie in der Ressource Umgebung neue Labels Ihrer Umgebung an.
Alle Labels ersetzen
Wenn Sie alle Labels ersetzen möchten, fügen Sie labels in den Abfrageparameter updateMask ein und geben im Anfragetext einen Ersatz an.
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels
{
"labels":{
"LABEL_KEY": "LABEL_VALUE"
}
}
Ersetzen Sie:
LABEL_KEYdurch einen Schlüssel des Umgebungslabels.LABEL_VALUEdurch einen neuen Wert für das Umgebungslabel.
Beispiel:
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels
{
"labels": {
"owner": "engineering-team",
"env": "production"
}
}
Alle Labels entfernen
Wenn Sie alle Labels entfernen möchten, fügen Sie labels in den Abfrageparameter updateMask ein und geben Sie den Ersatzwert nicht an.
Einzelne Labels aktualisieren
Wenn Sie ein Label aktualisieren oder vorhandenen Labels ein neues Label hinzufügen möchten, fügen Sie labels.LABEL_KEY in den Abfrageparameter updateMask ein und geben Sie im Anfragetext einen Ersatzwert an.
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY
{
"labels":{
"LABEL_KEY": "LABEL_VALUE"
}
}
Ersetzen Sie:
LABEL_KEYdurch einen Schlüssel des Umgebungslabels.LABEL_VALUEdurch einen neuen Wert für das Umgebungslabel.
Beispiel:
// 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"
}
}
Einzelne Labels entfernen
Wenn Sie Labels entfernen möchten, fügen Sie labels.LABEL_KEY in den Abfrageparameter updateMask ein und geben Sie den Ersatzwert nicht an.
Terraform
Wenn Sie eine Umgebung mit Standardparametern angeben möchten, die an einem angegebenen Standort ist, bearbeiten Sie den Block labels in der Terraform-Konfiguration und führen Sie terraform apply aus.
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
LABEL_KEY = "LABEL_VALUE"
}
}
Ersetzen Sie:
LABEL_KEYdurch den Umgebungslabelschlüssel, den Sie erstellen oder aktualisieren möchten. Zum Entfernen von Labels löschen Sie die zugehörigen Felder.LABEL_VALUEdurch den Umgebungslabelwert.
Beispiel:
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
owner = "engineering-team"
env = "production"
}
}
Labels in Berichten ansehen
Nachdem die Labels für Ihre Umgebung in die Abrechnungsberichte übernommen wurden, können Sie die Abrechnungskosten nach diesen Labels aufschlüsseln:
Cloud Billing-Berichte für Ihr Cloud-Rechnungskonto aufrufen
Auf der Seite Berichte:
- Klicke auf Filter einblenden.
- Erweitern Sie im Dialogfeld Filter den Abschnitt Labels.
- Filtern Sie die angezeigten Daten basierend auf Schlüsseln und Werten Ihrer Umgebungslabels.