Bereitstellen einer Databricks-App

Nachdem Sie Ihre Azure Databricks-App erstellt und entwickelt haben, stellen Sie sie bereit, um sie im Azure Databricks-Arbeitsbereich zugänglich zu machen. Die Bereitstellung erstellt Ihre App, installiert Abhängigkeiten und führt sie mithilfe der in Ihren Projektdateien definierten Konfiguration aus. Sie können Apps mithilfe der Azure Databricks-Benutzeroberfläche oder der Azure Databricks CLI bereitstellen.

Bereitstellungslogik

Databricks-Apps unterstützen die Bereitstellung von Anwendungen, die Entweder Python, Node.jsoder eine Kombination aus beiden verwenden. Dies ermöglicht flexible Architekturen, z. B. ein Node.js-Frontend mit einem Python-Back-End.

Während der Bereitstellung überprüft der Buildprozess eine package.json Datei im Stammverzeichnis Ihres App-Verzeichnisses, um festzustellen, ob Node.js verwendet wird. Wenn vorhanden, enthält es nodespezifische Buildschritte zusammen mit Python-Schritten. Die Bereitstellungslogik folgt diesem Muster:

Wenn package.json vorhanden:

1. Führen Sie npm install aus.
2. pip install -r requirements.txt ausführen (falls vorhanden)
3. Führen Sie npm run build aus (wenn ein build Skript in package.json definiert ist)
4. Führen Sie den angegebenen Befehl in app.yaml aus, oder npm run start aus, wenn kein Befehl angegeben ist

Wenn package.json nicht vorhanden:

1. pip install -r requirements.txt ausführen (falls vorhanden)
2. Führen Sie den angegebenen Befehl in app.yaml aus, oder python <my-app>.py aus, wenn kein Befehl angegeben ist

Vorbereiten der Bereitstellung

Bevor Sie Ihre App bereitstellen, stellen Sie sicher, dass Ihr Projekt die erforderlichen Komponenten enthält:

• Hauptskript – Ihre Einstiegspunktdatei, wie zum Beispiel app.py oder app.js.
• Optionale Datei – app.yaml Wenn Ihre App einen benutzerdefinierten Befehl oder Umgebungsvariablen erfordert, schließen Sie eine app.yaml Datei ein, um die Ausführung zu konfigurieren. Siehe Konfigurieren der Databricks-App-Ausführung mit app.yaml.
• Abhängigkeiten – Stellen Sie sicher, dass alle Abhängigkeiten verfügbar sind. Siehe Verwalten von Abhängigkeiten für eine Databricks-App.
• Geheime Schlüssel oder Umgebungswerte – Wenn Sie den env Abschnitt verwenden app.yaml, überprüfen Sie, ob die referenzierten geheimen Schlüssel oder externen Quellen ordnungsgemäß konfiguriert und zugänglich sind. Siehe Hinzufügen von Ressourcen zu einer Databricks-App.

Stellen Sie außerdem sicher, dass der App-Dienstprinzipal Zugriff auf den Quellcodeordner hat.

Bereitstellen der App

Databricks UI

So stellen Sie eine App über die Azure Databricks-Benutzeroberfläche bereit:

1. Laden Sie die App-Dateien in Ihren Azure Databricks-Arbeitsbereich hoch. Anweisungen finden Sie unter Importieren einer Datei.
2. Klicken Sie auf Compute in der Randleiste.
3. Wechseln Sie zur Registerkarte "Apps ", und klicken Sie in der Spalte "Name " auf den Link zu Ihrer App.
4. Klicken Sie auf "Bereitstellen" , und wählen Sie den Ordner in Ihrem Arbeitsbereich aus, in den Sie die App-Dateien hochgeladen haben.
5. Klicken Sie auf "Auswählen" und dann auf "Bereitstellen".
6. Überprüfen Sie die Konfiguration, und klicken Sie auf "Bereitstellen".

Databricks-Befehlszeilenschnittstelle

So stellen Sie eine App mit der CLI bereit:

1. Öffnen Sie ein Terminal, und navigieren Sie zu dem Verzeichnis, das Ihre App-Dateien enthält.

2. Laden Sie Ihre App-Dateien mithilfe des sync Befehls in den Azure Databricks-Arbeitsbereich hoch. Ersetzen Sie den Pfad durch den Arbeitsbereichsspeicherort, an dem Sie die Dateien hochladen möchten.

   databricks sync --watch . /Workspace/Users/my-email@org.com/my-app
   

   Das --watch Kennzeichen führt die Ausführung des Synchronisierungsprozesses durch und lädt änderungen automatisch hoch, wenn Sie Dateien lokal ändern. Um bestimmte Dateien oder Verzeichnisse von der Synchronisierung auszuschließen, fügen Sie sie einer .gitignore Datei in Ihrem lokalen App-Verzeichnis hinzu. Allgemein auszuschließende Dateien sind node_modules/, .env, __pycache__/, .DS_Store sowie alle großen Daten oder Build-Artefakte.

3. Überprüfen Sie den Upload, indem Sie die Dateien in Ihrem Arbeitsbereich anzeigen. Klicken Sie auf Arbeitsbereich im Seitenbereich und navigieren Sie zu dem Verzeichnis, das Sie für Ihre App erstellt haben.

4. Stellen Sie die App bereit, indem Sie den folgenden Befehl ausführen. Ersetzen Sie den App-Namen und den Quellcodepfad durch Ihre Werte.

   databricks apps deploy my-app-name \
      --source-code-path /Workspace/Users/my-email@org.com/my-app
   

   Die CLI zeigt den Bereitstellungsfortschritt an und bestätigt, wann die App ausgeführt wird.

Nach der Bereitstellung startet Azure Databricks Ihre App basierend auf dem definierten command in Ihrer app.yaml-Datei oder standardmäßig mit dem Ausführen von python app.py.

Verhalten nach der Bereitstellung

Nach Abschluss der Bereitstellung startet Azure Databricks Ihre App in einer verwalteten Umgebung. Die Seite "App-Details" zeigt den aktuellen Status an und bietet Zugriff auf Protokolle, Bereitstellungsverlauf und Umgebungsinformationen.

Um die Ausgabe der bereitgestellten App zu sehen, klicken Sie auf den App-Link.

Wechseln Sie zur Registerkarte "Protokolle " zum Debuggen und zur Laufzeitüberwachung. Siehe Protokollierung und Überwachung für Databricks-Apps.

Aktualisieren oder erneutes Bereitstellen der App

Möglicherweise möchten Sie Ihre App aktualisieren oder erneut bereitstellen, wenn Sie Änderungen am Quellcode vorgenommen, die app.yaml Datei aktualisiert oder aus einem anderen Quellcodepfad bereitgestellt werden müssen. Durch die erneute Bereitstellung werden Ihre neuesten Updates angewendet, ohne die App von Grund auf neu zu erstellen.

So nehmen Sie Änderungen an einer bereitgestellten App vor:

1. Aktualisieren Sie Ihren App-Code oder die „app.yaml“-Konfiguration.
2. Kehren Sie zur Seite "Apps" im Azure Databricks-Arbeitsbereich zurück.
3. Wählen Sie Ihre App und dann erneut "Bereitstellen" aus. Wenn sich der Quellcodepfad geändert hat, klicken Sie auf den Pfeil neben "Bereitstellen" , und wählen Sie "Bereitstellen mit einem anderen Quellcodepfad" aus.

Behandeln von Bereitstellungsproblemen

Wenn Ihre App nicht wie erwartet bereitgestellt wird oder nicht wie erwartet ausgeführt wird, führen Sie die folgenden Schritte zur Problembehandlung aus:

• Protokolle überprüfen – Anzeigen von Fehlermeldungen oder Laufzeitausgabe im Protokollbereich.
• Validieren app.yaml – Stellen Sie sicher, dass die Syntax korrekt ist und unterstützte Einstellungen verwendet werden.
• Überprüfen Sie Geheimnisse und Umgebungsvariablen - Stellen Sie sicher, dass alle Verweise im env Abschnitt ordnungsgemäß aufgelöst werden.
• Bestätigen Von Abhängigkeiten – Stellen Sie sicher, dass alle erforderlichen Pakete enthalten oder installiert sind.

Nächste Schritte

• Protokollierung und Überwachung für Databricks-Apps
• Konfigurieren von Berechtigungen für eine Databricks-App
• Konfigurieren der Ausführung von Databricks-Apps mit app.yaml