Labels verwenden

Auf dieser Seite wird beschrieben, wie Sie Labels für Ihren Cloud Run-Dienst und Ihre Überarbeitungen festlegen, ändern und löschen. Bei Cloud Run sind Labels Schlüssel/Wert-Paare, die auf den Dienst und die Überarbeitungen angewendet werden. Wenn Sie ein Label für einen Cloud Run-Dienst festlegen, wird für diesen Dienst eine neue Überarbeitung mit diesem Label erstellt. Das Label wird nicht auf ältere Überarbeitungen angewendet.

Mögliche Anwendungsfälle:

  • Verwendung für die Kostenzuordnung und Abrechnungsaufschlüsselung.
  • Ressourcen identifizieren, die von einzelnen Teams oder Kostenstellen verwendet werden.
  • Bereitstellungsumgebungen unterscheiden (Produktion, Staging, QA oder Test).
  • Inhaber, Labels für Status identifizieren.

Nutzungsregeln für Labels

Die folgende Regel gilt für die Verwendung von Labels, die für einen Cloud Run-Dienst festgelegt sind:

Nur gültige Google Cloud-Labels dürfen in Cloud Run verwendet werden

Labels festlegen oder ändern

Jede Konfigurationsänderung führt zur Erstellung einer neuen Überarbeitung. Für nachfolgende Überarbeitungen gilt automatisch dieselbe Konfigurationseinstellung, sofern Sie sie nicht explizit aktualisieren.

Sie können Labels über die Cloud Console, die gcloud-Befehlszeile oder eine YAML-Datei ändern, wenn Sie eine neue Überarbeitung bereitstellen.

Console

  1. Öffnen Sie Cloud Run.

  2. Aktivieren Sie das Kästchen links neben dem Dienst, für den Sie das Label festlegen möchten.

  3. Achten Sie darauf, dass das Infofeld ganz rechts aktiviert ist (Infofeld anzeigen).

  4. Klicken Sie auf Labels, um den Bereich mit den Labels aufzurufen.

    Label festlegen

  5. Wenn Sie ein vorhandenes Schlüssel/Wert-Paar-Label bearbeiten möchten, suchen Sie nach dem Label und ändern Sie den Wert wie gewünscht.

  6. Wenn Sie ein neues Label für den Dienst festlegen möchten, klicken Sie auf Label hinzufügen und geben Sie den Schlüssel und den Wert ein.

  7. Klicken Sie auf Speichern.

Befehlszeile

Sie können Labels für einen Dienst mit dem folgenden Befehl aktualisieren:

gcloud run services update SERVICE --update-labels KEY=VALUE

Wenn Sie mehrere Labels aktualisieren möchten, geben Sie eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren an. Beachten Sie, dass mit dem Befehl update-labels ein neuer Wert für den Labelschlüssel festgelegt wird, wenn das Label bereits vorhanden ist. Andernfalls wird ein neues Label erstellt.

Ersetzen Sie

  • SERVICE durch den Namen Ihres Cloud Run-Dienstes
  • KEY durch den Namen Ihres Labelschlüssels
  • VALUE durch den Wert für den Schlüssel

Sie können Labels auch während der Bereitstellung festlegen:

gcloud run deploy SERVICE --image IMAGE --labels KEY=VALUE

Sie können während der Bereitstellung mehrere Labels erstellen. Geben Sie dafür eine durch Kommas getrennte Liste mit Schlüssel/Wert-Paaren an.

YAML

Sie können die vorhandene Dienstkonfiguration mit dem Befehl gcloud run services describe --format export herunterladen und aufrufen, was bereinigte Ergebnisse im YAML-Format liefert. Anschließend können Sie die unten beschriebenen Felder ändern und die geänderte YAML-Datei mit dem Befehl gcloud run services replace hochladen. Achten Sie darauf, dass Sie die Felder nur wie dokumentiert ändern.

  1. So rufen Sie die Konfiguration auf und laden sie herunter:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Aktualisieren Sie das Attribut labels:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
      labels:
        LABEL: 'VALUE'

    Ersetzen Sie:

    • SERVICE durch den Namen Ihres Cloud Run-Dienstes.
    • LABEL durch den Namen des Labels.
    • VALUE durch den gewünschten Wert.
  3. Ersetzen Sie den Dienst mit dem folgenden Befehl durch die neue Konfiguration:

    gcloud run services replace service.yaml

Dienste nach Label auflisten

Sie können Dienste mithilfe eines Cloud SDK-Filters nach Label auflisten:

  gcloud run services list --filter metadata.labels.LABEL=VALUE
  

Ersetzen Sie:

  • LABEL durch den Namen des Labels.
  • VALUE durch den Wert, der in die gefilterte Liste aufgenommen werden soll

Label löschen

Sie können Labels über die Console oder die Befehlszeile löschen.

Console

  1. Öffnen Sie Cloud Run.

  2. Aktivieren Sie das Kästchen links neben dem Dienst, für den Sie das Label löschen möchten.

  3. Achten Sie darauf, dass das Infofeld ganz rechts aktiviert ist (Infofeld anzeigen).

  4. Klicken Sie auf Labels, um den Bereich mit den Labels aufzurufen.

  5. Suchen Sie das Label, das Sie löschen möchten.

  6. Bewegen Sie den Mauszeiger rechts neben das Textfeld Wert für das Label, damit das Papierkorbsymbol angezeigt wird, und klicken Sie darauf.

  7. Klicken Sie auf Speichern.

Befehlszeile

So löschen Sie alle Labels aus einem Dienst:

gcloud run services update SERVICE --clear-labels

Wenn Sie bestimmte Labels aus einem Dienst löschen möchten, geben Sie eine durch Kommas getrennte Liste von Schlüsseln an:

gcloud run services update SERVICE --remove-labels LABEL

Ersetzen Sie

  • SERVICE durch den Namen Ihres Cloud Run-Dienstes
  • LABEL durch den Namen Ihres Labels