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.

Verwenden Sie Tags, um Repositories und andere Ressourcen in Google Cloud für die Berichterstellung, Prüfung und Zugriffssteuerung in Ihrer Google Cloud-Organisation zu gruppieren. 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 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 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.

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.

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

Öffnen Sie in der Cloud Console die Seite Repositories.

Zur Seite „Repositories“
Wählen Sie ein Repository aus.
Wenn das Infofeld neben der Repository-Liste nicht geöffnet ist, klicken Sie auf Infofeld ansehen.
Klicken Sie im Infofeld auf den Tab Labels.
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,..."

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 multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
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 Repository-Listen in der Google Cloud Console oder über die Google Cloud CLI nach Label filtern.

Console

Öffnen Sie in der Cloud Console die Seite Repositories.

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

Wenn Sie beispielsweise nur Repositories mit dem Label env:dev anzeigen möchten, können Sie eine der folgenden Eingaben eingeben:
- Schlüssel eingeben: env
- Geben Sie den Wert ein: dev
- Geben Sie das Schlüssel/Wert-Paar ein: env:dev

gcloud

Verwenden Sie zum Filtern anhand von Labels das Flag --filter mit dem Befehl gcloudZulassen von Artefakten Liste der Labels.

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

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

Öffnen Sie in der Cloud Console die Seite Repositories.

Zur Seite „Repositories“
Klicken Sie auf Repository auswählen.
Wenn das Infofeld neben der Repository-Liste nicht geöffnet ist, klicken Sie auf Infofeld ansehen.
Klicken Sie im Infofeld auf den Tab Labels.
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

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 multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
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