Umgebungslabels verwalten und Umgebungskosten aufschlüsseln

Auf dieser Seite wird erläutert, wie Sie Ihren Cloud Composer-Umgebungen Labels zuweisen und anschließend 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 beispielsweise owner:engineering-team ein benutzerdefiniertes Label ist, dann ist owner der Schlüssel und engineering-team der Wert.

Jede Umgebung kann mehrere Labels haben, aber die Labelschlüssel für eine einzelne Umgebung müssen eindeutig sein. Sie können mehreren Umgebungen denselben Schlüssel und denselben Wert zuweisen.

Umgebungslabels in Abrechnungsberichten

Umgebungslabels, die Sie Ihren Umgebungen zuweisen, sind in Abrechnungsberichten sichtbar, sodass Sie die Kosten basierend auf Schlüsseln und Werten aus den Labels aufschlüsseln können.

Labels gelten nicht rückwirkend. Wenn Sie beispielsweise am 15. Mai ein Label zuweisen, enthalten die Abrechnungskosten für den 14. Mai das zugewiesene Label nicht.

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:

    Zu Umgebungen

  2. Wählen Sie Ihre Umgebung aus.

  3. Wechseln Sie zum Tab Labels.

  4. Klicken Sie 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 bestimmte Labels. Erstellt neue Labels, falls noch nicht vorhanden.

  • --remove-labels entfernt die angegebenen Labels. nicht 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 Compute Engine-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 Wert des Umgebungslabels.

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

Geben Sie beim Aktualisieren einer Umgebung in der Ressource Umgebung neue Labels für Ihre Umgebung an.

Alle Labels ersetzen

Nehmen Sie labels in den Abfrageparameter updateMask auf und geben Sie im Anfragetext eine Ersetzung an, um alle Labels zu ersetzen.

// 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 einem vorhandenen Label ein neues Label hinzufügen möchten, fügen Sie labels.LABEL_KEY in den Abfrageparameter updateMask ein und fügen Sie im Anfragetext einen Ersatz ein.

// 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

Zum Erstellen einer Umgebung mit Standardparametern geben Sie den Block labels in der Terraform-Konfiguration an und führen 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. Wenn Sie Labels entfernen möchten, löschen Sie die zugehörigen Felder.
  • LABEL_VALUE durch den Wert des Umgebungslabels.

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 übertragen wurden, können die Abrechnungskosten anhand der folgenden Labels aufgeschlüsselt werden:

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

  2. Auf der Seite Berichte:

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

Nächste Schritte