Worker-Pool-Beschreibungen festlegen

Auf dieser Seite wird beschrieben, wie Sie eine benutzerdefinierte Beschreibung für Ihre Cloud Run-Worker-Pools festlegen. Eine Beschreibung ist ein optionaler für Menschen lesbarer Text, der an den Worker-Pool angehängt ist.

Beschreibungen sind auf 512 Zeichen beschränkt. Falls vorhanden, wird die Beschreibung beim Aufrufen der Details zu einem Worker-Pool mit gcloud beta run worker-pools describe angezeigt.

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-Worker-Pools 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-Workerpool 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.

Beschreibung festlegen oder ändern

Legen Sie eine Beschreibung für Cloud Run-Worker-Pools mit der Google Cloud CLI fest, wenn Sie einen neuen Worker-Pool erstellen:

gcloud

Sie können die Beschreibung während der Bereitstellung festlegen oder aktualisieren:

gcloud beta run worker-pools deploy WORKER_POOL --description DESCRIPTION

Ersetzen Sie Folgendes:

  • WORKER_POOL: Der Name Ihres Cloud Run-Worker-Pools
  • DESCRIPTION: die Beschreibung des Worker-Pools

YAML

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

    gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

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

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/launch-stage: BETA
    run.googleapis.com/description: DESCRIPTION

    Ersetzen Sie Folgendes:

    • WORKER_POOL: Der Name Ihres Cloud Run-Worker-Pools
    • DESCRIPTION: die Beschreibung des Worker-Pools

  3. Erstellen oder aktualisieren Sie den Worker-Pool mit dem folgenden Befehl:

    gcloud beta run worker-pools replace workerpool.yaml

Terraform

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

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  description = "DESCRIPTION"
}

Ersetzen Sie Folgendes:

  • WORKER_POOL: der Name des Worker-Pools
  • REGION: Die Google Cloud Region, z. B. europe-west1
  • IMAGE_URL: ein Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • DESCRIPTION: die Beschreibung des Worker-Pools