Label-Workflows

Labels sind Schlüssel/Wert-Paare, mit denen Sie verwandte Workflows ermitteln und gruppieren und Metadaten zu einem Workflow speichern können. Sie können mehrere Labels für einen Workflow angeben.

Auf dieser Seite wird erläutert, wie Sie Labels für Ihre Workflows verwenden können. Außerdem wird beschrieben, wie Labels hinzugefügt, aktualisiert und entfernt werden.

Verwenden Sie Tags, um Workflows und andere Ressourcen in Ihrer Google Cloud Organisation für Berichte, Audits und die Zugriffssteuerung zu gruppieren. Google Cloud Tags und Labels funktionieren unabhängig voneinander. Sie können beide auf denselben Workflow anwenden.

Was sind Labels?

Ein Label ist ein Schlüssel/Wert-Paar, das Sie Google Cloud Workflows 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 nach Labels filtern. Informationen zu Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die abgerechneten Gebühren nach Label 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

Es folgen einige gängige Anwendungsfälle für Labels:

  • Labels für Teams oder Kostenstellen: Fügen Sie Labels basierend auf einem Team oder einer Kostenstelle hinzu, um zwischen den Workflows von verschiedenen 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.

Es wird empfohlen, nicht zu viele eindeutige Labels zu erstellen, etwa für Zeitstempel oder einzelne Werte für einzelne 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.

Labels hinzufügen oder aktualisieren

Sie können einem Workflow beim Erstellen ein oder mehrere Labels hinzufügen. Sie können Labels auch hinzufügen oder bearbeiten, wenn Sie einen Workflow aktualisieren.

Wenn Sie ein vorhandenes Label aktualisieren oder ein neues hinzufügen, kann es bis zu 10 Minuten dauern, bis das neue Label wirksam wird.

Workflows nach Label filtern

Sie können nach bestimmten Workflows suchen und sie auflisten, indem Sie sie nach Label filtern.

Console

  1. Rufen Sie in der Google Cloud console die Workflows Seite auf.

    Zur Seite "Workflows"

  2. Wählen Sie im Feld Filter die Option Labels als Filterkriterium aus und wählen Sie in der Liste Werte ein Schlüssel/Wert-Paar aus.

gcloud

Verwenden Sie das --filter Flag mit dem Befehl gcloud workflows list:

gcloud workflows list \
    --filter labels.KEY=VALUE

Ersetzen Sie KEY und VALUE durch ein Label-Schlüssel/Wert-Paar.

Weitere Informationen zur Filtersyntax in der Google Cloud CLI finden Sie unter gcloud topic filters.

Workflow-Labels werden von Ausführungen des Workflows übernommen. Verwenden Sie die workflows.executions.list Methode, um Ausführungs Labels aufzurufen und Workflowausführungen aufzulisten und zu filtern.

Labels löschen

Sie können ein bestimmtes Label über die Google Cloud console löschen oder mit der gcloud CLI alle Labels aus einem Workflow löschen.

Console

  1. Rufen Sie in der Google Cloud console die Workflows Seite auf.

    Zur Seite "Workflows"

  2. Klicken Sie auf den Namen des Workflows, den Sie aktualisieren möchten.

    Die Seite Workflowdetails wird angezeigt.

  3. Klicken Sie auf „Bearbeiten“ Edit.

    Die Seite Workflow bearbeiten wird angezeigt.

  4. Klicken Sie neben dem Label, das Sie entfernen möchten, auf Element löschen.

  5. Klicken Sie auf Weiter.

  6. Klicken Sie auf Bereitstellen, um den Workflow noch einmal bereitzustellen.

gcloud

Verwenden Sie das --labels Flag mit einem leeren Wert und dem gcloud workflows deploy Befehl:

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

Ersetzen Sie Folgendes:

  • WORKFLOW_NAME: Der Name Ihres Workflows.

  • YAML_OR_JSON_SOURCE_FILE: Die Quelldatei für den Workflow im YAML- oder JSON-Format. Beispiel: myFirstWorkflow.yaml.