Sandboxes für Jobs konfigurieren

Cloud Run-Sandboxes bieten eine schnelle, sichere und isolierte Umgebung, um Agent-Code auszuführen, Datentransformationen vorzunehmen und Skripts sicher in Ihrem vorhandenen Job auszuführen. Sandboxes sind stark auf Latenz optimiert und werden in derselben Instanz wie Ihr Container ausgeführt. Sie teilen sich die zugewiesene CPU und den zugewiesenen Arbeitsspeicher.

Auf dieser Seite wird beschrieben, wie Sie Sandboxes in Ihrem Container konfigurieren. Weitere Informationen zum Schreiben von Code für die Interaktion mit der Sandbox über die Befehlszeile finden Sie unter Code-Ausführung in Cloud Run.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Installieren und initialisieren Sie die gcloud CLI.
  7. Erstellen Sie einen Cloud Run-Job.

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 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.

Sandboxes aktivieren

Verwenden Sie die Google Cloud CLI, eine YAML-Konfiguration oder Terraform, um Sandboxes in Cloud Run-Jobs zu aktivieren:

gcloud

Geben Sie zum Erstellen oder Aktualisieren des Jobs das Flag --sandbox-launcher an:

  • Führen Sie den folgenden Befehl aus, um einen Job zu erstellen:

    gcloud beta run jobs create JOB --image IMAGE_URL --sandbox-launcher

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.
    • IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest
  • Führen Sie den folgenden Befehl aus, um einen vorhandenen Job zu aktualisieren:

    gcloud beta run jobs update JOB --sandbox-launcher

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 --format export > job.yaml
  2. Aktualisieren Sie Ihre YAML-Datei, um das Attribut sandboxLauncher in Ihrer Containerkonfiguration auf true festzulegen:

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB
      annotations:
        run.googleapis.com/launch-stage: BETA
    spec:
      template:
        spec:
          template:
            spec:
              containers:
              - name: CONTAINER
                image: IMAGE_URL
                sandboxLauncher: true
    

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.
    • CONTAINER: Der Name des Containers.
    • IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest
  3. Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:

    gcloud run jobs replace job.yaml

    Der Befehl gcloud run jobs replace verwendet standardmäßig die Datei job.yaml, falls vorhanden.

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"
  location = "REGION"

  template {
    template {
      containers {
        image            = "IMAGE_URL"
        sandbox_launcher = true
      }
    }
  }
}

Ersetzen Sie Folgendes:

  • JOB: Der Name Ihres Cloud Run-Jobs.
  • REGION: die Region Google Cloud . Beispiel: europe-west1
  • IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest

Sandboxes teilen sich die CPU und den Arbeitsspeicher, die dem Hostcontainer zugewiesen sind. Achten Sie darauf, dass die CPU- und Arbeitsspeicherlimits Ihres Hauptcontainers sowohl für Ihre Anwendung als auch für alle aktiven Sandboxes, die Sie gleichzeitig ausführen, ausreichen.

Sandboxes deaktivieren

Wenn Sie die Möglichkeit, eine Sandbox in Ihrem Job zu starten, deaktivieren möchten, verwenden Sie die Google Cloud CLI oder eine YAML-Konfiguration:

gcloud

Aktualisieren Sie den Job mit dem Flag --no-sandbox-launcher, indem Sie den folgenden Befehl ausführen:

gcloud beta run jobs update JOB --no-sandbox-launcher

Ersetzen Sie JOB durch den Namen Ihres Jobs.

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 --format export > job.yaml
  2. Aktualisieren Sie Ihre YAML-Datei, um das Attribut sandboxLauncher aus der Containerkonfiguration zu entfernen:

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB
    spec:
      template:
        spec:
          template:
            spec:
              containers:
              - name: CONTAINER
                image: IMAGE_URL
    

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.
    • CONTAINER: Der Name des Containers.
    • IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest
  3. Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:

    gcloud run jobs replace job.yaml

    Der Befehl gcloud run jobs replace verwendet standardmäßig die Datei job.yaml, falls vorhanden.

Sandbox-Einstellungen aufrufen

So rufen Sie die aktuellen Sandbox-Einstellungen für Ihren Cloud Run-Job auf:

Console

  1. Rufen Sie in der Google Cloud Console die Cloud Run-Seite Jobs auf:

    Zu Cloud Run-Jobs

  2. Klicken Sie auf den gewünschten Job, um die Seite Jobdetails zu öffnen.

  3. Klicken Sie auf dem Tab Verlauf in der Liste auf die ID des ausgeführten Jobs.

  4. Suchen Sie auf dem Tab Container nach der Einstellung Sandbox-Launcher, um zu sehen, ob Container in einer Sandbox aktiviert oder deaktiviert sind.

gcloud

  1. Verwenden Sie den folgenden Befehl:

    gcloud run jobs executions describe EXECUTION_NAME --format yaml

    Ersetzen Sie EXECUTION_NAME durch den Namen der Jobausführung.

  2. Suchen Sie in der zurückgegebenen Konfiguration nach dem Attribut sandboxLauncher: true, um zu prüfen, ob Container in einer Sandbox aktiviert sind.

Informationen zum Ausführen von nicht vertrauenswürdigem Code in einer Sandbox aus Ihrem Job finden Sie unter Code-Ausführung in Cloud Run.

Sandbox-Vorlagen konfigurieren

Mit Sandbox-Vorlagen können Sie Container-Images für Sandboxes definieren. Anstatt Sandbox-Sitzungen in Ihrem Hauptanwendungscontainer auszuführen, starten die Befehle sandbox do --template und sandbox run --template neue Container mit den von Ihnen angegebenen Images, z. B. Python, Node.js oder einer benutzerdefinierten Ausführungsumgebung. Diese Sandboxes werden in eigenen Containern ausgeführt und teilen sich die CPU- und Arbeitsspeicherlimits des Hauptcontainers. Sie können für eine Vorlage keine separaten CPU- und Arbeitsspeicherlimits festlegen. Cloud Run unterstützt bis zu 10 Sandbox-Vorlagen. Volume-Bereitstellungen müssen auf ein In-Memory-Volume in Ihrer Cloud Run-Ressource verweisen. Sandbox-Vorlagen bieten die folgenden Funktionen:

  • Dedizierte Container-Images: Deklarieren Sie separate Container-Images wie python:3.12-slim oder busybox:latest als Sandbox-Vorlagen. Sie können auch andere Laufzeiten und Tools für Sandboxes verwenden, die in Ihrem Hauptcontainer nicht erforderlich sind. Dadurch bleibt Ihr Hauptcontainer schlank, da Tools und Laufzeiten, die nur für das Sandboxing verwendet werden, isoliert werden.

  • On-Demand-Instanziierung: Die Sandbox-Befehlszeile (/usr/local/gcp/bin/sandbox) erstellt neue Sandbox-Container aus einer Vorlage, ohne neue VMs bereitzustellen oder neue Instanzen abzurechnen.

  • Isolierte Dateifreigabe pro Sandbox: Sie können ein In-Memory-Volume zwischen Ihrem Hauptcontainer und mehreren Sandboxes freigeben und gleichzeitig jede Sandbox auf ihr eigenes isoliertes Unterverzeichnis beschränken, um zu verhindern, dass Sandboxes andere Dateien sehen oder ändern.

Sie können Sandbox-Vorlagen mit einer YAML-Konfiguration oder der Cloud Run Admin API konfigurieren:

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 --format export > job.yaml
  2. Aktualisieren Sie die YAML-Datei des Jobs, um die sandboxes-Vorlagenkonfiguration einzuschließen:

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB
      annotations:
        run.googleapis.com/launch-stage: BETA
    spec:
      template:
        spec:
          template:
            spec:
              containers:
              - image: IMAGE_URL
                sandboxLauncher: true
                volumeMounts:
                - name: VOLUME_NAME
                  mountPath: CONTAINER_MOUNT_PATH
              volumes:
              - name: VOLUME_NAME
                emptyDir:
                  medium: Memory
              sandboxes:
                templates:
                - name: TEMPLATE_NAME
                  image: TEMPLATE_IMAGE_URL
                  volumeMounts:
                  - name: VOLUME_NAME
                    mountPath: SANDBOX_MOUNT_PATH
                    subPath: SUBPATH
    

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.

    • IMAGE_URL: die Container-Image-URL, die für den Hauptcontainer verwendet werden soll.
    • TEMPLATE_NAME: der Name der Vorlage.
    • TEMPLATE_IMAGE_URL: die Container-Image-URL, die für die Sandbox-Vorlage verwendet werden soll.
    • Optional: VOLUME_NAME: der Name des Volumes, das bereitgestellt werden soll.
    • Optional: CONTAINER_MOUNT_PATH: der Pfad, in dem das Volume im Hauptcontainer bereitgestellt wird.
    • Optional: SANDBOX_MOUNT_PATH: der Pfad, in dem das Volume im Sandbox-Container bereitgestellt wird.
    • Optional: SUBPATH: ein relativer Unterverzeichnispfad innerhalb des Volumes, das im Sandbox-Container bereitgestellt werden soll, z. B. my-subdir. Wenn Sie für jede Sandbox zur Laufzeit ein anderes Unterverzeichnis festlegen möchten, verwenden Sie einen $(VARIABLE_NAME)-Platzhalter, z. B. $(SANDBOX_DIR):
      • VARIABLE_NAME darf nur ASCII-Buchstaben und Unterstriche enthalten. Ziffern und Bindestriche werden nicht unterstützt.
      • Wenn Sie den Platzhalter zur Laufzeit auflösen möchten, übergeben Sie das Flag --template-var=VARIABLE_NAME=VALUE zusammen mit --template.
      • subPath erstellt Verzeichnisse nicht automatisch. Erstellen Sie das aufgelöste Verzeichnis SUBPATH im Volume aus dem Hauptcontainer, z. B. mit mkdir -p, bevor Sie sandbox do oder sandbox run ausführen.
  3. Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:

    gcloud run jobs replace job.yaml

    Der Befehl gcloud run jobs replace verwendet standardmäßig die Datei job.yaml, falls vorhanden.

REST API

Senden Sie eine PATCH-Anfrage an die Cloud Run Admin API, um Sandbox-Vorlagen zu konfigurieren:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-X PATCH \
"https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB" \
-d '{
  "launchStage": "BETA",
  "template": {
    "template": {
      "containers": [
        {
          "image": "IMAGE_URL",
          "sandboxLauncher": true,
          "volumeMounts": [
            {
              "name": "VOLUME_NAME",
              "mountPath": "CONTAINER_MOUNT_PATH"
            }
          ]
        }
      ],
      "sandboxes": {
        "templates": [
          {
            "name": "TEMPLATE_NAME",
            "image": "TEMPLATE_IMAGE_URL",
            "volumeMounts": [
              {
                "name": "VOLUME_NAME",
                "mountPath": "SANDBOX_MOUNT_PATH",
                "subPath": "SUBPATH"
              }
            ]
          }
        ]
      },
      "volumes": [
        {
          "name": "VOLUME_NAME",
          "emptyDir": {
            "medium": "MEMORY"
          }
        }
      ]
    }
  }
}'

Ersetzen Sie Folgendes:

  • JOB: Der Name Ihres Cloud Run-Jobs.

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • REGION: die Region, in der Ihre Cloud Run-Ressource bereitgestellt wird.
  • IMAGE_URL: die Container-Image-URL, die für den Hauptcontainer verwendet werden soll.
  • TEMPLATE_NAME: der Name der Vorlage.
  • TEMPLATE_IMAGE_URL: die Container-Image-URL, die für die Sandbox-Vorlage verwendet werden soll.
  • Optional: VOLUME_NAME: der Name des Volumes, das bereitgestellt werden soll.
  • Optional: CONTAINER_MOUNT_PATH: der Pfad, in dem das Volume im Hauptcontainer bereitgestellt wird.
  • Optional: SANDBOX_MOUNT_PATH: der Pfad, in dem das Volume im Sandbox-Container bereitgestellt wird.
  • Optional: SUBPATH: ein relativer Unterverzeichnispfad innerhalb des Volumes, das im Sandbox-Container bereitgestellt werden soll, z. B. my-subdir. Wenn Sie für jede Sandbox zur Laufzeit ein anderes Unterverzeichnis festlegen möchten, verwenden Sie einen $(VARIABLE_NAME)-Platzhalter, z. B. $(SANDBOX_DIR):
    • VARIABLE_NAME darf nur ASCII-Buchstaben und Unterstriche enthalten. Ziffern und Bindestriche werden nicht unterstützt.
    • Wenn Sie den Platzhalter zur Laufzeit auflösen möchten, übergeben Sie das Flag --template-var=VARIABLE_NAME=VALUE zusammen mit --template.
    • subPath erstellt Verzeichnisse nicht automatisch. Erstellen Sie das aufgelöste Verzeichnis SUBPATH im Volume aus dem Hauptcontainer, z. B. mit mkdir -p, bevor Sie sandbox do oder sandbox run ausführen.

Informationen zum Ausführen von Vorlagen mit der Befehlszeile in Ihrem Jobcontainer finden Sie unter Befehle mit Sandbox-Vorlagen ausführen.