Repositories mit Labels versehen

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

Was sind Labels?

Ein Label ist ein Schlüssel/Wert-Paar, das Sie Cloud de Confiance by S3NS 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 nach Labels filtern.

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 Cloud de Confiance -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 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 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 de Confiance 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,..."

Ersetzen Sie Folgendes:

  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • PROJECT ist die Cloud de Confiance by S3NS -Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
  • LOCATION ist der regionale Speicherort des Repositorys. Sie können das Flag „--location“ weglassen, um den Standardspeicherort zu verwenden.
  • KEY=VALUE,... ist eine Liste von kommagetrennten 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 Cloud de Confiance Console oder mit der Google Cloud CLI nach Label filtern.

Console

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

    Zur Seite „Repositories“

  2. Wählen Sie im Feld Filter die Option Labels als Filterkriterien aus und geben Sie dann Ihren Schlüssel, Wert oder Ihr Schlüssel-Wert-Paar ein.

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

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

gcloud

Um nach Labels zu filtern, 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 beispielsweise Repositorys im aktiven Projekt nach einem Label mit env als Schlüssel und dev als Wert filtern möchten, können Sie folgenden 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

  1. Öffnen Sie in der Cloud de Confiance 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

Ersetzen Sie Folgendes:

  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • PROJECT ist die Cloud de Confiance by S3NS -Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
  • LOCATION ist der regionale Speicherort des Repositorys. 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 kommagetrennter Labels, die Schlüssel aus jedem KEY=VALUE-Paar. Beispiel: team,product

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

   gcloud artifacts repositories update --help