Labels konfigurieren

Cloud Run-Labels sind Schlüssel/Wert-Paare, die auf Cloud Run-Jobs angewendet werden. Auf dieser Seite wird beschrieben, wie Sie Labels für Ihre Cloud Run-Jobs festlegen, ändern und löschen.

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.
  • Logs in Logging filtern.

Nutzungsregeln für Labels

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

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, um die zum Konfigurieren von Cloud Run-Jobs erforderlichen Berechtigungen zu erhalten:

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 Ihr Cloud Run-Job 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 die Google Cloud CLI oder YAML verwenden, um ein Label für einen Cloud Run-Job festzulegen.

gcloud

  1. So legen Sie ein Label für einen neuen Job fest:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    Ersetzen

    • JOB_NAME durch den Namen des Jobs.
    • KEY durch den Namen Ihres Labelschlüssels
    • VALUE durch den Wert für den Schlüssel
    • Ersetzen Sie IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.

  2. So legen Sie ein Label für einen vorhandenen Job fest:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE

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

    gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2

YAML

  1. Wenn Sie einen neuen Job erstellen, überspringen Sie diesen Schritt. Wenn Sie einen vorhandenen Job aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:

    gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. Aktualisieren Sie die labels-Attribute an zwei Stellen:

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE

    Ersetzen

    • LABEL durch den Namen des Labels
    • VALUE durch den gewünschten Wert.

    Sie können auch weitere Konfigurationen angeben, z. B. Umgebungsvariablen oder Speicherlimits.

  3. Aktualisieren Sie die vorhandene Jobkonfiguration:

    gcloud run jobs replace job.yaml

Jobs nach Label auflisten

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

  gcloud run jobs 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 in einem Job löschen

So löschen Sie alle Labels für einen Job:

gcloud run jobs update JOB --clear-labels

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

gcloud run jobs update JOB --remove-labels LABEL

Ersetzen

  • JOB durch den Namen des Cloud Run-Jobs
  • LABEL durch den Namen Ihres Labels