Cloud Workstations-Ressourcen mit Labels versehen

Auf dieser Seite wird beschrieben, wie Labels mit Cloud Workstations-Ressourcen verwendet werden.

Was sind Labels?

Ein Label ist ein Schlüssel/Wert-Paar, das Sie Google Cloud-Instanzen zuweisen können. Clusterlabels helfen Ihnen dabei, diese Ressourcen zu organisieren und Ihre Kosten in großem Umfang mit der erforderlichen Detailgenauigkeit zu verwalten. Sie können jeder Ressource ein Label zuweisen und dann die Ressourcen basierend auf ihren Labels filtern. Informationen zu Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die in Rechnung gestellten Gebühren nach Labels aufschlüsseln können. Dank integrierter Abrechnungsberichte können Sie Kosten nach Ressourcenlabels filtern und gruppieren. Sie können Labels auch verwenden, um Abrechnungsdatenexporte abzufragen.

Anforderungen an Labels

Die Labels, die auf eine Ressource angewendet werden, müssen die folgenden Anforderungen erfüllen:

Jede Ressource kann bis zu 64 Labels haben.
Jedes Label muss ein Schlüssel/Wert-Paar sein.
Schlüssel haben eine Mindestlänge von 1 Zeichen und eine maximale Länge von 63 Zeichen und dürfen nicht leer sein. Werte dürfen leer sein und haben eine maximale Länge von 63 Zeichen.
Schlüssel und Werte dürfen nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Alle Zeichen müssen UTF-8-codiert sein. Internationale Zeichen sind zulässig. Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen.
Der Schlüsselabschnitt eines Labels darf in einer einzelnen Ressource nur einmal vorkommen. Sie können jedoch denselben Schlüssel für mehrere Ressourcen verwenden.

Die Limits gelten für den Schlüssel und den Wert für jedes Label und für die einzelnen Google Cloud-Ressourcen, die Labels haben. Es gibt keine Beschränkung, wie viele Labels Sie auf alle Ressourcen in einem Projekt anwenden können.

Einsatzmöglichkeiten von Labels

Labels kommen u. a. in folgenden Situationen zum Einsatz:

Labels für Teams oder Kostenstellen: Fügen Sie Labels basierend auf einem Team oder einer Kostenstelle hinzu, um zwischen den Instanzen verschiedener Teams zu unterscheiden (z. B. team:research und team:analytics). Sie können diese Art von Label für die Kostenabrechnung oder Budgetplanung nutzen.
Labels für Komponenten: z. B. component:redis, component:frontend, component:ingest und component:dashboard.
Labels für Umgebungen oder Phasen: z. B. environment:production und environment:test.
Labels für Status: z. B. state:active, state:readytodelete und state:archive.
Labels für Eigentumsrechte: Wird verwendet, um die Teams zu identifizieren, die für den Betrieb verantwortlich sind, z. B. team:shopping-cart.

+ Labels für virtuelle Maschinen: An eine virtuelle Maschine kann ein Label angehängt werden. VM-Tags, die Sie zuvor definiert haben, werden als Label ohne Wert angezeigt.

Wir raten davon ab, eine große Anzahl eindeutiger Labels zu erstellen, z. B. für Zeitstempel oder einzelne Werte für jeden API-Aufruf. Das Problem bei diesem Ansatz besteht darin, dass es schwierig ist, Ressourcen effektiv zu filtern und Berichte über sie zu erstellen, wenn sich die Werte häufig ändern oder wenn Schlüssel verwendet werden, die den Katalog überlasten.

Labels und Tags

Labels können als abfragbare Annotationen für Ressourcen verwendet werden, aber nicht zum Festlegen von Bedingungen für Richtlinien. Mit Tags können Sie Richtlinien auf Basis der Bedingung genehmigen oder ablehnen, ob eine Ressource ein bestimmtes Tag hat. Dazu müssen Sie eine detaillierte Richtlinienkontrolle ermöglichen. Weitere Informationen finden Sie in der Tag-Übersicht.

Weitere Informationen zu Google Cloud-Labels finden Sie unter Ressourcen mithilfe von Labels organisieren.

Cloud Workstations-Ressourcenlabels

Cloud Workstations wendet automatisch die folgenden Labels auf alle Ressourcen an:

workstation_cluster_id
workstation_config_id
workstation_id
workstation_location
goog-drz-workstation-location
goog-drz-workstation-uuid
goog-workstations

Benutzerdefinierte Cloud Workstations-Labels

Sie können Ihre benutzerdefinierten Labels auch Workstationclustern, Workstationkonfigurationen und Workstations hinzufügen, wodurch sie rekursiv auf alle zugrunde liegenden Compute Engine-Ressourcen angewendet werden, jedoch nicht auf die zugrunde liegenden Cloud Workstations API-Ressourcen. Wenn Sie Compute Engine-Ressourcen für einzelne Workstations mit Labels versehen möchten, müssen Sie für jede einzelne Workstation Labels hinzufügen.

Verwenden Sie beim Aufrufen der Cloud Workstations API das Feld labels.

In der folgenden Beispieldatei config.json ist beispielsweise webserver ein Schlüssel und backend der entsprechende Wert. Entsprechend ist media ein Schlüssel und images der entsprechende Wert.

    {
      "idleTimeout": "7200s",
      "host": {
        "gce_instance": {
          "machine_type": "e2-standard-8",
          "pool_size": 1
        }
      },
      "persistentDirectories": [
        {
        "mountPath": "/home",
        "gcePd": {
          "sizeGb": 200,
          "fsType": "ext4"
        }
      }
      ],
      "labels": {
        "webserver": "backend",
        "media": "images"
      }
    }