Tutorial: Erstellen und Bereitstellen eines Bündels im Arbeitsbereich

Um Ihnen den Einstieg in die Nutzung von Databricks Asset Bundles im Arbeitsbereich zu erleichtern, führt Sie dieses Lernprogramm durch die Erstellung eines Bundles mit einem Auftrag, dessen Bereitstellung und das Ausführen des Auftrags im Bundle – alles aus dem Arbeitsbereich heraus.

Anforderungen für die Verwendung von Bündeln im Arbeitsbereich finden Sie unter Databricks Asset Bundles in den Arbeitsbereichsanforderungen.

Weitere Informationen zu Bundles finden Sie unter Was sind Databricks Asset Bundles?.

Bundle erstellen

Erstellen Sie zunächst ein Bündel im Databricks-Arbeitsbereich:

1. Navigieren Sie zu dem Git-Ordner, in dem Sie Ihr Bündel erstellen möchten.

   Tipp

   Wenn Sie den Git-Ordner zuvor im Editor im Arbeitsbereich geöffnet haben, können Sie das Kontextmenü für die Dokumenterstellung des Arbeitsbereichsbrowsers verwenden, um schnell zum Git-Ordner zu navigieren. Siehe Dokumenterstellungskontexte.

2. Klicken Sie auf die Schaltfläche " Erstellen ", und klicken Sie dann auf " Bestandspaket". Alternativ klicken Sie mit der rechten Maustaste auf den Git-Ordner oder den zugehörigen Kebab in der Arbeitsbereichsstruktur, und klicken Sie auf "Objektbundle>":

   

3. Geben Sie im Dialogfeld "Asset Bundle erstellen " dem Bestandspaket einen Namen, z. B. total-awesome-bundle. Der Bündelname darf nur Buchstaben, Zahlen, Gedankenstriche und Unterstriche enthalten. Wählen Sie "Leeres Projekt " aus, und klicken Sie dann auf "Erstellen und Bereitstellen" .

   

Dadurch wird ein erstes Bundle im Git-Ordner erstellt, das eine .gitignore Git-Konfigurationsdatei und die erforderliche Datei "Databricks Asset Bundles" databricks.yml enthält. Die databricks.yml Datei enthält die Hauptkonfiguration für das Bundle. Weitere Informationen finden Sie unter Databricks Asset Bundle-Konfiguration.

Hinzufügen eines Notizbuchs

Fügen Sie als Nächstes ihrem Bündel ein Notizbuch hinzu. Das Notizbuch im folgenden Beispiel druckt "Hello World!".

1. Klicken Sie auf die Projektkachel " Notizbuchbündel hinzufügen ". Klicken Sie alternativ auf den Kebab für das Bundle im Inhaltsverzeichnis, und klicken Sie dann auf "Notizbuch>".

2. Benennen Sie das Notizbuch in helloworld um.

3. Legen Sie die Sprache des Notizbuchs auf Python fest, und fügen Sie Folgendes in die Zelle des Notizbuchs ein:

   print("Hello World!")
   

Definieren eines Auftrags

Definieren Sie nun einen Auftrag, der das Notizbuch ausführt.

1. Klicken Sie auf das Bereitstellungssymbol für das Bundle, um zum Bereich "Bereitstellungen " zu wechseln.

   

2. Klicken Sie im Abschnitt "Bündelressourcen" auf "Hinzufügen" und dann auf "Neue Auftragsdefinition".

   

3. Geben Sie run-notebook in das Job-Name Feld des Dialogfelds Job zu bestehendem Paket hinzufügen ein. Klicken Sie auf "Hinzufügen" und "Bereitstellen".

4. Es wird ein Dialogfeld zur Bestätigung der Entwicklung mit Informationen zu der Auftragsressource angezeigt, die im Dev-Zielarbeitsbereich erstellt wird. Klicken Sie auf "Bereitstellen".

5. Navigieren Sie zurück zu den Dateien des Bundles, indem Sie auf das Ordnersymbol oberhalb des Bereitstellungssymbols klicken. Eine Auftragsressource run-notebook.job.yml wurde mit grundlegender YAML für den Job und einigen zusätzlichen auskommentierten Beispiel-Job-Aufgaben-YAML erstellt.

6. Fügen Sie der Auftragsdefinition eine Notizbuchaufgabe hinzu. Ersetzen Sie das Beispiel YAML in der run-notebook.job.yml Datei durch Folgendes:

   resources:
     jobs:
       run_notebook:
         name: run-notebook
         queue:
           enabled: true
         tasks:
           - task_key: my-notebook-task
             notebook_task:
               notebook_path: ../helloworld.ipynb
   

   

Ausführliche Informationen zum Definieren eines Auftrags in YAML finden Sie unter "Auftrag". Informationen zur YAML-Syntax für andere unterstützte Auftragsaufgabentypen finden Sie unter Hinzufügen von Aufgaben zu Aufträgen in Databricks Asset Bundles.

Bereitstellen des Pakets

Stellen Sie als Nächstes das Bundle bereit, und führen Sie den Auftrag aus, der die helloworld Notizbuchaufgabe enthält.

1. Klicken Sie im Bereich "Bereitstellungen " für das Bundle unter "Ziele" auf das Dropdownmenü, um den dev Zielarbeitsbereich auszuwählen, falls es noch nicht ausgewählt ist. Zielarbeitsbereiche werden in der targets Zuordnung des Bundles databricks.ymldefiniert. Weitere Informationen finden Sie unter Bereitstellungsmodi für Databricks-Ressourcenbundle.

   

2. Klicken Sie auf die Schaltfläche "Bereitstellen". Das Bündel wird überprüft, und Details der Überprüfung werden in einem Dialogfeld angezeigt.

3. Überprüfen Sie die Bereitstellungsdetails in diesem Dialogfeld " Bereitstellen für Entwicklerbestätigung ", und klicken Sie dann auf "Bereitstellen".

   

   Von Bedeutung

   Durch das Bereitstellen von Bündeln und das Ausführen von Bundleressourcen wird Code im Kontext des aktuellen Benutzers ausgeführt. Stellen Sie sicher, dass Sie dem Code im Bundle vertrauen, einschließlich YAML, das Konfigurationseinstellungen enthalten kann, die Befehle ausführen.

Der Status der Bereitstellung wird im Projektausgabefenster ausgegeben.

Ausführung des Auftrags

Bereitgestellte Bundleressourcen werden unter "Bundle-Ressourcen" aufgeführt. Klicken Sie auf das Wiedergabesymbol, das der Auftragsressource zugeordnet ist, um es auszuführen.

Navigieren Sie zu Jobs ausführen in der linken Navigationsleiste, um das ausgeführte Bundle zu sehen. Der Name des Bündelauftragslaufs wird mit einem Präfix versehen, zum Beispiel [dev someone] run-notebook.

Nächste Schritte

• Hinzufügen einer vorhandenen Ressource zu einem Bündel
• Zusammenarbeiten, Überprüfen und Bereitstellen in die Produktion