Umgebungslabels verwalten und Umgebungskosten aufschlüsseln

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

  1. Rufen Sie in der Google Cloud Console die Seite Umgebungen auf:

    Zur Seite Umgebungen

  2. Wählen Sie Ihre Umgebung aus.

  3. Öffnen Sie den Tab Labels.

  4. Klicken Sie zuerst auf Bearbeiten und dann auf Label hinzufügen.

  5. Fügen Sie ein Schlüssel/Wert-Paar für das Label hinzu und klicken Sie auf Speichern.

  6. 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-labels entfernt alle Labels.

  • --update-labels aktualisiert angegebene Labels; Erstellt neue Labels, wenn sie noch nicht vorhanden sind.

  • --remove-labels entfernt 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_NAME durch den Namen der Umgebung.
  • LOCATION durch die Region, in der sich die Umgebung befindet.
  • LABEL_KEY durch den Umgebungslabelschlüssel, den Sie erstellen, aktualisieren oder entfernen möchten.
  • LABEL_VALUE durch 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_KEY durch einen Schlüssel des Umgebungslabels.
  • LABEL_VALUE durch 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_KEY durch einen Schlüssel des Umgebungslabels.
  • LABEL_VALUE durch 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_KEY durch den Umgebungslabelschlüssel, den Sie erstellen oder aktualisieren möchten. Zum Entfernen von Labels löschen Sie die zugehörigen Felder.
  • LABEL_VALUE durch 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:

  1. Cloud Billing-Berichte für Ihr Cloud-Rechnungskonto aufrufen

  2. Auf der Seite Berichte:

    1. Klicke auf Filter einblenden.
    2. Erweitern Sie im Dialogfeld Filter den Abschnitt Labels.
    3. Filtern Sie die angezeigten Daten basierend auf Schlüsseln und Werten Ihrer Umgebungslabels.

Nächste Schritte