Befehle in einer Sandbox ausführen

Führen Sie Shell-Befehle aus, warten Sie auf die Ausgabe, streamen Sie Ereignisse, und brechen Sie die Arbeit in einer ausgeführten Sandbox ab.

Beginnen Sie mit einer Sandbox im Status RUNNING. Legen Sie das Profil, die Region und die Sandbox-ID für die Sessionauthentifizierung fest:

profile_name="DEFAULT"
region="us-chicago-1"
sandbox_id="SANDBOX_ID"

Befehl ausführen und auf Ausgabe warten

Verwenden Sie run-and-wait für einen Befehl, dessen Ergebnis Sie möchten, bevor Sie fortfahren:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-command run-and-wait \
  --sandbox-id "$sandbox_id" \
  --command "pwd && ls -la /workspace" \
  --timeout PT5M

Überprüfen Sie die zurückgegebene Befehls-ID, die Standardausgabe, den Standardfehler und den Exit-Code. Ein Exit-Code ungleich null gibt an, dass der Befehl einen Fehler gemeldet hat.

Streamingausgabe

Verwenden Sie run-and-stream, um die Ausgabe zu lesen, während der Befehl ausgeführt wird. In diesem Beispiel werden drei Meldungen ausgegeben:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-command run-and-stream \
  --sandbox-id "$sandbox_id" \
  --command "sh -lc 'for i in 1 2 3; do echo message-\$i; sleep 1; done'" \
  --timeout PT5M \
  --file -

Befehl asynchron starten

Verwenden Sie run, um einen Befehl zu starten und seine ID zum Abrufen oder Abbrechen der Ausgabe zu speichern:

command_id=$(oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-command run \
  --sandbox-id "$sandbox_id" \
  --command "sleep 30" \
  --timeout PT2M \
  --query 'data.id' --raw-output)

Erfasste Ausgabe abrufen:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-command get-output \
  --sandbox-id "$sandbox_id" \
  --command-id "$command_id" \
  --from-seq 0

Oder streamen Sie Ereignisse für den vorhandenen Befehl:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-command stream \
  --sandbox-id "$sandbox_id" \
  --command-id "$command_id" \
  --from-seq 0

Der Sequenzwert 0 startet den Abruf von Anfang an.

Befehle abbrechen

Um die Beendigung eines ausgeführten Befehls anzufordern, senden Sie SIGTERM:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-command cancel \
  --sandbox-id "$sandbox_id" \
  --command-id "$command_id" \
  --signal SIGTERM

Das Abbrechen eines Befehls und das Stoppen der Sandbox sind separate Vorgänge. Informationen zum Beenden der Laufzeit finden Sie unter Sandbox stoppen.

Service auf einem veröffentlichten Port ausführen

Verwenden Sie beim Erstellen der Sandbox --publish-ports, um den Port anzugeben, den Ihr Service benötigt. Beispiel:

project_id="PROJECT_OCID"

sandbox_id=$(oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox create \
  --project-id "$project_id" \
  --display-name preview-sandbox \
  --runtime python-3.11 \
  --shape SMALL \
  --publish-ports '["8080"]' \
  --expiration-duration PT30M \
  --wait-for-state RUNNING \
  --query 'data.id' --raw-output)
Wichtig

Veröffentlichte Ports haben keine von der Plattform bereitgestellte Anwendungsauthentifizierung. Jeder, der eine veröffentlichte URL erhält, kann diesen Port erreichen, während die Sandbox ausgeführt wird, es sei denn, Ihre Anwendung schränkt den Zugriff ein. Fügen Sie bei Bedarf die Authentifizierung hinzu, und veröffentlichen Sie nur die Ports, die Ihre Workload benötigt.

Bei einer temporären Vorschau, die nur nicht sensible Dateien enthält, starten Sie einen Server in einem dedizierten Verzeichnis:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-command run \
  --sandbox-id "$sandbox_id" \
  --command "mkdir -p /workspace/preview && python3 -m http.server 8080 --bind 0.0.0.0 --directory /workspace/preview" \
  --timeout PT30M

Rufen Sie die Sandbox ab, und lesen Sie den Eintrag published-ports, dessen key 8080 ist. Die value ist die URL für den Service:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox get \
  --sandbox-id "$sandbox_id"

Warten Sie, bis der Server bereit ist, bevor Sie eine Verbindung herstellen. Stoppen Sie den Befehl oder die Sandbox, wenn Sie die Vorschau abgeschlossen haben.