Labels für Instanzen konfigurieren

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

Mögliche Anwendungsfälle:

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

Nutzungsregeln für Labels

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

In Cloud Run dürfen nur gültige Google Cloud Labels verwendet werden.

Labels für Abrechnungsdaten und Logging

Cloud Billing und Cloud Logging erhalten nur Labels, die in dem spec.template.metadata.labels Attribut in YAML oder unter template in Terraform angegeben sind. Wenn Sie Labels mit der Google Cloud CLI konfigurieren, fügt Cloud Run die Labels sowohl den Attributen metadata.labels als auch spec.template.metadata.labels hinzu.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren und Bereitstellen von Cloud Run-Instanzen benötigen:

Eine Liste der IAM-Rollen und -Berechtigungen im Zusammenhang mit Cloud Run finden Sie unter IAM-Rollen für Cloud Run und IAM-Berechtigungen für Cloud Run. Wenn Ihre Cloud Run-Instanz mit Google Cloud APIs wie Cloud-Clientbibliotheken verknüpft ist, lesen Sie die Konfigurationsanleitung für Dienstidentitäten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Bereitstellungsberechtigungen und Zugriff verwalten.

Labels festlegen oder ändern

Sie können Labels mit der Google Cloud CLI festlegen oder ändern:

gcloud

Sie können Labels für eine Instanz mit dem folgenden Befehl aktualisieren:

gcloud beta run instances update INSTANCE --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 Folgendes:

  • INSTANCE: Der Name Ihrer Cloud Run-Instanz.
  • KEY: Der Name Ihres Labelschlüssels.
  • VALUE: Der Wert für den Schlüssel.

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

gcloud beta run instances deploy INSTANCE --image IMAGE --labels KEY=VALUE

Wenn Sie während der Bereitstellung mehrere Labels erstellen möchten, geben Sie eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren an.

YAML

  1. Wenn Sie eine neue Instanz erstellen, überspringen Sie diesen Schritt. Wenn Sie eine vorhandene Instanz aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. Das folgende Beispiel enthält die YAML-Konfiguration:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    Ersetzen Sie Folgendes:

    • INSTANCE: Der Name Ihrer Cloud Run-Instanz.
    • KEY und VALUE: Die Schlüssel/Wert-Paare für Labels.

    metadata.labels legt Labels für das Instanzobjekt fest, während spec.template.metadata.labels Labels für die erstellte Überarbeitung festlegt. Cloud Run gibt nur Labels, die für die Überarbeitung festgelegt wurden, an Cloud Billing und Cloud Logging weiter.

  3. Erstellen oder aktualisieren Sie die Instanz mit dem folgenden Befehl:

    gcloud beta run instances replace instance.yaml

Instanzen nach Label auflisten

Sie können Instanzen mithilfe eines Google Cloud CLI-Filters nach Label auflisten:

  gcloud beta run instances list --filter metadata.labels.LABEL=VALUE

Ersetzen Sie Folgendes:

  • LABEL: Der Name des Labels.
  • VALUE: Der Wert, der in die gefilterte Liste aufgenommen werden soll.

Label in einer Instanz löschen

Sie können die Google Cloud CLI verwenden, um Labels in einer Instanz zu löschen.

gcloud

So löschen Sie alle Labels für eine Instanz:

gcloud beta run instances update INSTANCE --clear-labels

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

gcloud beta run instances update INSTANCE --remove-labels LABEL

Ersetzen Sie Folgendes:

  • INSTANCE: Der Name Ihrer Cloud Run-Instanz.
  • LABEL: Der Name Ihres Labels.