Freigeben über

Konfigurieren der Ausführung von Databricks-Apps mit app.yaml

Die app.yaml Datei in einer Databricks-App definiert, wie Ihre App ausgeführt wird. Wenn Ihre App eine andere Einstiegspunkt- oder umgebungsspezifische Konfiguration erfordert, können Sie diese optionale Datei in Ihr Projekt einschließen, um das Standardverhalten außer Kraft zu setzen.

Sie können die .yaml- oder .yml-Dateierweiterung verwenden. Diese Datei muss sich im Stammverzeichnis Des Projekts befinden.

Unterstützte Einstellungen

Die app.yaml Datei unterstützt die folgenden Einstellungen.

Setting Typ Description
command sequence Verwenden Sie diese Einstellung, wenn Sie einen benutzerdefinierten Befehl zum Ausführen Ihrer App benötigen. Standardmäßig führt Azure Databricks Python-Apps mit dem Befehl python <my-app.py>aus. Dabei <my-app.py> handelt es sich um die erste .py Datei in der Dateistruktur Ihrer App. Wenn Ihre App Node.jsenthält, lautet npm run startder Standardbefehl . Siehe Bereitstellungslogik.
Da Azure Databricks den Befehl nicht in einer Shell ausführt, stehen Umgebungsvariablen, die außerhalb der App-Konfiguration definiert sind, für Ihre App nicht zur Verfügung. Wenn Ihre App zusätzliche Parameter zum Ausführen benötigt, verwenden Sie die env Struktur.
Diese Einstellung ist optional.
env list Azure Databricks legt automatisch mehrere Standardumgebungsvariablen in der App-Laufzeitumgebung fest. Dieser Schlüssel der obersten Ebene definiert eine optionale Liste zusätzlicher Umgebungsvariablen, die an Ihre App übergeben werden sollen. Jede Variable kann einen hartcodierten Wert verwenden oder auf eine externe Quelle verweisen, z. B. einen geheimen Schlüssel oder einen Datenbankeintrag.
Die gültigen Elemente in der Liste sind:
  • name: Der Name der Umgebungsvariable.
  • Eine der folgenden:

Diese Einstellung ist optional.

Beispiel app.yaml für eine Streamlit-App

Die folgende app.yaml Datei zeigt, wie Sie eine Streamlit-App konfigurieren. Sie verwendet einen benutzerdefinierten Befehl, um die App mit streamlit run zu starten, und setzt Umgebungsvariablen für die SQL Warehouse-ID und ein Verwendungsnachverfolgungsflag.

command: ['streamlit', 'run', 'app.py']
env:
  - name: 'DATABRICKS_WAREHOUSE_ID'
    value: 'quoz2bvjy8bl7skl'
  - name: 'STREAMLIT_GATHER_USAGE_STATS'
    value: 'false'

Verwenden Sie ein Setup wie diese, wenn Ihre App von einer bestimmten Computeressource, z. B. einem SQL Warehouse, abhängt oder bestimmte Umgebungsvariablen zum Steuern des Laufzeitverhaltens benötigt.

Beispiel app.yaml für eine Flask-App

In diesem Beispiel wird gezeigt, wie Sie eine Flask-App mit dem Gunicorn-Server konfigurieren. Die command Einstellung gibt die Gunicorn-Startparameter an, und der env Abschnitt legt den Pfad zu einem Unity-Katalogvolume als Umgebungsvariable fest.

command:
  - gunicorn
  - app:app
  - -w
  - 4
env:
  - name: 'VOLUME_URI'
    value: '/Volumes/catalog-name/schema-name/dir-name'

Verwenden Sie diesen Ansatz, wenn Ihre App einen produktionsfähigen WSGI-Server wie Gunicorn benötigt und von Daten abhängt, die in einem Unity-Katalogvolume oder einem anderen umgebungsspezifischen Pfad gespeichert sind.

Nächste Schritte

  • Last updated on