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.

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 CLI, YAML oder Terraform 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 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.

  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.

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