Quickstart: Erstellen und ausführen Sie eine Azure Container Apps Sandbox mit dem Python SDK

In diesem Quickstart nutzt du das Python SDK, um eine Sandbox-Gruppe bereitzustellen, eine Sandbox zu starten, einen Befehl auszuführen und alle erstellten Ressourcen zu bereinigen.

Voraussetzungen

  • Ein Azure-Abonnement mit der Berechtigung, Ressourcengruppen zu erstellen.
  • Azure CLI (az) installiert und angemeldet.
  • uv mit Python 3.13+.

Richten Sie Ihre Umgebung ein

Installiere das SDK, melde dich bei Azure an und schreibe eine .env Datei für die Skripte in diesem Quickstart.

uv venv
uv pip install azure-containerapps-sandbox azure-mgmt-resource azure-mgmt-authorization

# Sign in so DefaultAzureCredential picks up your identity
az login

cat > .env <<EOF
AZURE_SUBSCRIPTION_ID=$(az account show --query id -o tsv)
AZURE_RESOURCE_GROUP=my-rg
AZURE_SANDBOX_GROUP=my-sandbox-group
AZURE_REGION=eastus2
AZURE_PRINCIPAL_ID=$(az ad signed-in-user show --query id -o tsv)
EOF

Erstellen Sie die Ressourcengruppe und Sandbox-Gruppe und gewähren Sie sich selbst Zugriff auf die Datenebene. Speichern als setup.py:

import os, uuid
from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ResourceManagementClient
from azure.mgmt.authorization import AuthorizationManagementClient
from azure.containerapps.sandbox import SandboxGroupManagementClient

credential = DefaultAzureCredential()
sub = os.environ["AZURE_SUBSCRIPTION_ID"]
rg = os.environ["AZURE_RESOURCE_GROUP"]
group = os.environ["AZURE_SANDBOX_GROUP"]
region = os.environ["AZURE_REGION"]

ResourceManagementClient(credential, sub).resource_groups.create_or_update(
    rg, {"location": region},
)

SandboxGroupManagementClient(
    credential, subscription_id=sub, resource_group=rg,
).begin_create_group(group, location=region).result()

# Container Apps SandboxGroup Data Owner (built-in role)
ROLE_DEF_ID = "c24cf47c-5077-412d-a19c-45202126392c"
scope = f"/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.App/sandboxGroups/{group}"

AuthorizationManagementClient(credential, sub).role_assignments.create(
    scope=scope,
    role_assignment_name=str(uuid.uuid4()),
    parameters={
        "properties": {
            "roleDefinitionId": f"/subscriptions/{sub}/providers/Microsoft.Authorization/roleDefinitions/{ROLE_DEF_ID}",
            "principalId": os.environ["AZURE_PRINCIPAL_ID"],
            "principalType": "User",
        }
    },
)
print(f"Setup complete: rg={rg}, sandbox_group={group}, role granted.")

uv run --env-file .env python setup.py

Rollenzuweisungen brauchen 30 bis 60 Sekunden, bis sie wirksam werden. Wenn ein main.py 403 zurückkommt, warte eine Minute und versuche es erneut.

Erstelle und betreib eine Sandbox

Speichern als main.py:

import os
from azure.identity import DefaultAzureCredential
from azure.containerapps.sandbox import SandboxGroupClient, endpoint_for_region

credential = DefaultAzureCredential()
client = SandboxGroupClient(
    endpoint_for_region(os.environ["AZURE_REGION"]), credential,
    subscription_id=os.environ["AZURE_SUBSCRIPTION_ID"],
    resource_group=os.environ["AZURE_RESOURCE_GROUP"],
    sandbox_group=os.environ["AZURE_SANDBOX_GROUP"],
)

# Create a sandbox
sandbox = client.begin_create_sandbox(disk="ubuntu").result()

# Run a command
result = sandbox.exec("echo 'Hello from Azure Container Apps Sandbox.'")
print(result.stdout)

# Clean up
sandbox.delete()

Führen Sie das Skript aus:

uv run --env-file .env python main.py

Bereinigen von Ressourcen

Um die Sandbox-Gruppe und die Ressourcengruppe zu löschen, speichern Sie den folgenden Code als teardown.py:

import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ResourceManagementClient
from azure.containerapps.sandbox import SandboxGroupManagementClient

credential = DefaultAzureCredential()
sub = os.environ["AZURE_SUBSCRIPTION_ID"]
rg = os.environ["AZURE_RESOURCE_GROUP"]

SandboxGroupManagementClient(
    credential, subscription_id=sub, resource_group=rg,
).begin_delete_group(os.environ["AZURE_SANDBOX_GROUP"]).result()

ResourceManagementClient(credential, sub).resource_groups.begin_delete(rg).result()
print(f"Teardown complete: {rg} deleted.")

Führe das Reinigungsskript aus.

uv run --env-file .env python teardown.py

Nächste Schritte

Momentaufnahmen und Zustandsverwaltung für Azure Container Apps-Sandboxen

  • Zuletzt aktualisiert um