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
- 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.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
- Installieren und initialisieren Sie die gcloud CLI.
- 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:
- Rolle Cloud Run-Entwickler (
roles/run.developer) für den Cloud Run-Job - Dienstkontonutzer (
roles/iam.serviceAccountUser) für die Dienstidentität
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
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
Aktualisieren Sie Ihre YAML-Datei, um das Attribut
sandboxLauncherin Ihrer Containerkonfiguration auftruefestzulegen: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: trueErsetzen 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
Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:
gcloud run jobs replace job.yaml
Der Befehl
gcloud run jobs replaceverwendet standardmäßig die Dateijob.yaml, falls vorhanden.
Terraform
Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.
Fügen Sie einergoogle_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
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
Aktualisieren Sie Ihre YAML-Datei, um das Attribut
sandboxLauncheraus der Containerkonfiguration zu entfernen:apiVersion: run.googleapis.com/v1 kind: Job metadata: name: JOB spec: template: spec: template: spec: containers: - name: CONTAINER image: IMAGE_URLErsetzen 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
Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:
gcloud run jobs replace job.yaml
Der Befehl
gcloud run jobs replaceverwendet standardmäßig die Dateijob.yaml, falls vorhanden.
Sandbox-Einstellungen aufrufen
So rufen Sie die aktuellen Sandbox-Einstellungen für Ihren Cloud Run-Job auf:
Console
Rufen Sie in der Google Cloud Console die Cloud Run-Seite Jobs auf:
Klicken Sie auf den gewünschten Job, um die Seite Jobdetails zu öffnen.
Klicken Sie auf dem Tab Verlauf in der Liste auf die ID des ausgeführten Jobs.
Suchen Sie auf dem Tab Container nach der Einstellung Sandbox-Launcher, um zu sehen, ob Container in einer Sandbox aktiviert oder deaktiviert sind.
gcloud
Verwenden Sie den folgenden Befehl:
gcloud run jobs executions describe EXECUTION_NAME --format yaml
Ersetzen Sie EXECUTION_NAME durch den Namen der Jobausführung.
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-slimoderbusybox:latestals 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
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
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: SUBPATHErsetzen 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=VALUEzusammen mit--template. subPatherstellt Verzeichnisse nicht automatisch. Erstellen Sie das aufgelöste Verzeichnis SUBPATH im Volume aus dem Hauptcontainer, z. B. mitmkdir -p, bevor Siesandbox doodersandbox runausführen.
Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:
gcloud run jobs replace job.yaml
Der Befehl
gcloud run jobs replaceverwendet standardmäßig die Dateijob.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=VALUEzusammen mit--template. subPatherstellt Verzeichnisse nicht automatisch. Erstellen Sie das aufgelöste Verzeichnis SUBPATH im Volume aus dem Hauptcontainer, z. B. mitmkdir -p, bevor Siesandbox doodersandbox runausführen.
Informationen zum Ausführen von Vorlagen mit der Befehlszeile in Ihrem Jobcontainer finden Sie unter Befehle mit Sandbox-Vorlagen ausführen.