Labels für Jobs 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:

  • 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 einen Cloud Run-Job 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 im Attribut spec.template.metadata.labels in YAML oder unter template in Terraform angegeben sind. Wenn Sie Labels über dieGoogle Cloud -Konsole oder die 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 von Cloud Run-Jobs 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 Ihr Cloud Run-Job mitGoogle 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 Console, die Google Cloud CLI, YAML oder Terraform verwenden, um ein Label für einen Cloud Run-Job festzulegen.

Console

  1. Wechseln Sie in der Google Cloud -Console zur Seite Cloud Run-Jobs:

    Zu Cloud Run

  2. Aktivieren Sie das Kästchen links neben dem Job, 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.

  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.

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 Sie Folgendes:

    • JOB_NAME durch den Namen des Jobs.
    • KEY durch den Namen Ihres Labelschlüssels.
    • VALUE durch den Wert für den Schlüssel.
    • IMAGE_URL: Ein 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 Sie Folgendes:

    • LABEL durch den Namen des Labels.
    • VALUE durch den ausgewählten Wert.

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

    Cloud Run gibt nur Labels, die im Attribut spec.template.metadata.labels festgelegt sind, an Cloud Billing und Cloud Logging weiter.

  3. Aktualisieren Sie die vorhandene Jobkonfiguration:

    gcloud run jobs replace job.yaml

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Fügen Sie einer google_cloud_run_v2_job-Ressource in Ihrer Terraform-Konfiguration Folgendes hinzu:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

Ersetzen Sie Folgendes:

  • JOB_NAME: Der Name Ihres Cloud Run-Jobs.
  • REGION: die Google Cloud Region. Beispiel: europe-west1.
  • LABEL: der Name des Labels.
  • VALUE: der ausgewählte Wert.

Cloud Run gibt nur Labels, die unter template festgelegt sind, an Cloud Billing und Cloud Logging weiter.

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 Folgendes:

  • LABEL: der Name des Labels
  • VALUE: Der 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 Sie Folgendes:

  • JOB: Der Name Ihres Cloud Run-Jobs.
  • LABEL: der Name Ihres Labels