Erstelle eine Sandbox aus einem benutzerdefinierten Image

Important

Dieses Feature befindet sich in der Betaversion. Um diese Funktionsvorschau im Arbeitsbereich zu aktivieren, wähle die Databricks-Sandbox-Einstellung auf der Seite Vorschauen des Arbeitsbereichs an. Siehe Manage Azure Databricks Previews.

Du kannst eine Sandbox aus deinem eigenen Container-Image erstellen, das im Artifact Registry gespeichert ist. Artefaktregistrierung speichert Container-Images als verwaltete Anlagen im Unity Catalog, sodass Sie den Zugriff darauf über die Berechtigungen des Unity Catalog steuern können. Die Sandbox beginnt damit, dass die Pakete, Tools und Konfigurationen des Images bereits installiert sind, sodass du nicht jedes Mal Abhängigkeiten installieren musst, wenn du eine Sandbox erstellst.

Für einen Überblick über Databricks Sandbox siehe Databricks Sandbox.

Requirements

  • Dein Arbeitsbereich erfüllt die Databricks Sandbox-Voraussetzungen. Siehe Voraussetzungen.
  • Ihr Arbeitsbereich erfüllt die Voraussetzungen für die Artifact Registry, einschließlich der Aktivierung der Databricks Artifact Registry-Vorschau. Siehe Anforderungen.
  • Sie verfügen über die Berechtigungen USE CATALOG, USE SCHEMA und READ VOLUME für den Katalog und das Schema, die das Image enthalten. Siehe Berechtigungen erteilen.
  • Das Bild verwendet glibc 2.25 und höher. Wenn das Image eine Ubuntu-Basis verwendet, nutze Ubuntu 18.04 und höher. Images, die musl statt glibc verwenden, wie Alpine Linux und darauf basierende Images (zum Beispiel python:<version>-alpine oder node:<version>-alpine), werden nicht unterstützt.

Ein Image hochladen und eine Sandbox erstellen

  1. Baue das Image mit Docker und schiebe es ins Artifact Registry. Siehe Image übertragen.

  2. Warten Sie, bis der Beschleunigungsstatus des Images SUCCESS ist. Die Bildbeschleunigung läuft automatisch nach dem Pushen und kann 15 Minuten oder länger dauern. Siehe Status der Bildbeschleunigung prüfen.

  3. Erstellen Sie die Sandbox und setzen Sie image_uri auf den Unity Catalog-Namen des Images im Format catalog.schema.artifact:tag. Um eine exakte Version anzupinnen, verwenden Sie statt eines Tags einen Digest: catalog.schema.artifact@sha256:<digest>.

    Um zum Beispiel eine Sandbox aus dem main.agents.agent-base:v1 Bild zu erstellen, führe Folgendes aus:

    from databricks.sdk import WorkspaceClient
    from databricks.sdk.service.sandbox import EnvironmentSpec, Sandbox, SandboxSpec
    
    w = WorkspaceClient()
    
    created = w.sandbox.create_sandbox(
        sandbox=Sandbox(
            spec=SandboxSpec(
                environment=EnvironmentSpec(image_uri="main.agents.agent-base:v1"),
            ),
        ),
        sandbox_id="my-custom-sandbox",
    )
    print(created.name)   # "sandboxes/my-custom-sandbox"
    

Eine Sandbox, die aus einem benutzerdefinierten Image erstellt wird, behält das gleiche persistente Home-Verzeichnis und das gleiche Stop-and-Start-Verhalten wie jede andere Sandbox.

Troubleshooting

Wenn die Create-Anfrage fehlschlägt, überprüfen Sie die Fehlermeldung:

  • Image <uri> is not ready for use: Die Bildbeschleunigung ist noch nicht abgeschlossen. Überprüfen Sie den Beschleunigungsstatus des Images und versuchen Sie es erneut, nachdem es SUCCESS erreicht hat.
  • Not authorized to access image <uri>: Du hast nicht die erforderlichen Privilegien für das Bild. Bitten Sie den Katalog- oder Schemabesitzer, dies zu gewähren.

Limitations

  • Benutzerdefinierte Bilder müssen im Artifact Registry gespeichert werden. Du kannst keine Sandbox aus einem Image in einer externen Registry erstellen, und Azure Databricks erstellt keine Images für dich.
  • Sandboxen, die aus einem benutzerdefinierten Image erstellt werden, können länger zum Start benötigen als Sandboxen, die die Standardumgebung verwenden.

Weitere Ressourcen