Umgebungslabels verwalten und Umgebungskosten aufschlüsseln

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"
  }
}