Label-Repositories

Verwenden Sie Labels, um damit verwandte Repositories ermitteln und gruppieren zu können. Sie können für ein Repository mehrere Labels angeben.

Um Repositories und andere Ressourcen in Google Cloud Berichterstellung, Auditing und Zugriffssteuerung in Ihrer Google Cloud-Organisation Verwenden Sie Tags. Tags und Labels funktionieren unabhängig voneinander. Sie können beide auf dasselbe Repository anwenden.

Was sind Labels?

Ein Label ist ein Schlüssel/Wert-Paar, das Sie Google Cloud-Repositories 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 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

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

  • Labels für Teams oder Kostenstellen: Fügen Sie Labels nach Teams oder Kostenstellen hinzu, um zwischen den Repositories von unterschiedlichen Teams zu unterscheiden (z. B. team:research und team:analytics). Diese Art von Labels können Sie 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 und aktualisieren

Sie können einem Repository ein oder mehrere Labels hinzufügen. Sie können auch den Wert eines vorhandenen Labels ändern.

So fügen Sie ein Label zu einem Repository hinzu:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Wählen Sie ein Repository aus.

  3. Wenn das Infofeld neben der Repository-Liste nicht geöffnet ist, klicken Sie auf Infofeld ansehen.

  4. Klicken Sie im Infofeld auf den Tab Labels.

  5. Labels hinzufügen oder bearbeiten:

    1. Zum Hinzufügen eines Labels klicken Sie auf Label hinzufügen. Geben Sie dann das Schlüssel/Wert-Paar für das Label an und klicken Sie auf Speichern.
    2. Zum Bearbeiten eines vorhandenen Labels ändern Sie einfach dessen Wert und klicken Sie auf Speichern.

gcloud

Sie können ein oder mehrere Labels angeben, die Sie hinzufügen oder bearbeiten möchten.

  • Wenn ein Label vorhanden ist, wird der entsprechende Wert aktualisiert.
  • Wenn kein Label vorhanden ist, wird es erstellt.
  • Wenn der Befehl das Flag --clear-labels enthält, werden alle vorhandenen Labels entfernt, bevor neue Labels hinzugefügt werden.

Führen Sie dazu diesen Befehl aus:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."

Dabei gilt:

  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen des Flags dieses Standard-Repository verwendet.
  • PROJECT ist die Google Cloud-Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
  • LOCATION ist ein regionaler oder multiregionalerSpeicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standardstandort konfiguriert, können Sie dieses Flag weglassen, um die Standardeinstellung zu verwenden.
  • KEY=VALUE,... ist eine Liste von durch Kommas getrennten Labels, die als Schlüssel/Wert-Paare angegeben sind. Beispiel: team=team-1,product=example_product,stage=development.

Für weitere Informationen zu dem Befehl führen Sie den folgenden Befehl aus:

gcloud artifacts repositories update --help

Repositories nach Label filtern

Sie können Repositorylisten in der Google Cloud Console oder mit der Google Cloud CLI nach Label filtern.

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Wählen Sie im Feld Filter die Option Labels als Filterkriterium aus und klicken Sie dann und geben Sie den Schlüssel, den Wert oder das Schlüssel/Wert-Paar ein.

    Wenn Sie beispielsweise nur Repositories mit dem Label env:dev anzeigen lassen möchten, können Sie eine der folgenden Optionen eingeben:

    • Schlüssel eingeben: env
    • Geben Sie den Wert ein: dev
    • Geben Sie das Schlüssel/Wert-Paar ein: env:dev

gcloud

Wenn Sie nach Labels filtern möchten, verwenden Sie das Flag --filter mit dem Befehl gcloud artifacts repositories list.

Der Wert des Flags --filter muss im Format labels.KEY=VALUE angegeben werden. Wenn Sie z. B. nach Repositories filtern möchten, Projekt auf einem Label mit env als Schlüssel und dev als Wert haben, können Sie Folgendes ausführen: diesem Befehl:

gcloud artifacts repositories list --filter labels.env=dev

Weitere Informationen zur Filtersyntax in der gcloud CLI finden Sie in der gcloud topic filters-Dokumentation .

Labels löschen

So löschen Sie Labels:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie auf Repository auswählen.

  3. Wenn das Infofeld neben der Repository-Liste nicht geöffnet ist, klicken Sie auf Infofeld ansehen.

  4. Klicken Sie im Infofeld auf den Tab Labels.

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

gcloud

Sie können bestimmte Labels löschen oder alle Labels für ein Repository entfernen.

Um bestimmte Labels zu entfernen, führen Sie folgenden Befehl aus:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

Um alle Labels zu entfernen, führen Sie folgenden Befehl aus:

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

Dabei gilt:

  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen des Flags dieses Standard-Repository verwendet.
  • PROJECT ist die Google Cloud-Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
  • LOCATION ist ein regional oder multiregional Standort Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standardstandort konfiguriert, können Sie dieses Flag weglassen, um die Standardeinstellung zu verwenden.
  • LABEL,... ist eine Liste durch Kommas getrennte Labels aus den KEY=VALUE-Paaren. Beispiel: team,product.

Für weitere Informationen zu dem Befehl führen Sie den folgenden Befehl aus:

   gcloud artifacts repositories update --help