Udostępnij przez


Konfigurowanie wykonywania aplikacji usługi Databricks za pomocą polecenia app.yaml

Plik app.yaml w aplikacji usługi Databricks definiuje sposób działania aplikacji. Jeśli aplikacja wymaga innego punktu wejścia lub konfiguracji specyficznej dla środowiska, możesz uwzględnić ten opcjonalny plik w projekcie, aby zastąpić zachowanie domyślne.

Możesz użyć .yaml rozszerzenia lub .yml . Ten plik musi znajdować się w katalogu głównym projektu.

Obsługiwane ustawienia

Plik app.yaml obsługuje następujące ustawienia.

Setting Typ Description
command sequence Użyj tego ustawienia, gdy wymagane jest niestandardowe polecenie do uruchomienia aplikacji. Domyślnie usługa Azure Databricks uruchamia aplikacje języka Python przy użyciu polecenia python <my-app.py>, gdzie <my-app.py> jest pierwszym .py plikiem w strukturze plików aplikacji. Jeśli aplikacja zawiera Node.js, domyślne polecenie to npm run start. Zobacz Logika wdrażania.
Ponieważ usługa Azure Databricks nie uruchamia polecenia w powłoce, zmienne środowiskowe zdefiniowane poza konfiguracją aplikacji nie są dostępne dla twojej aplikacji. Jeśli aplikacja wymaga uruchomienia dodatkowych parametrów, użyj struktury env.
To ustawienie jest opcjonalne.
env list Usługa Azure Databricks automatycznie ustawia kilka domyślnych zmiennych środowiskowych w środowisku uruchomieniowym aplikacji. Ten klucz najwyższego poziomu definiuje opcjonalną listę dodatkowych zmiennych środowiskowych do przekazania do aplikacji. Każda zmienna może używać zakodowanej na stałe wartości lub odwoływać się do źródła zewnętrznego, takiego jak wpis tajny lub wpis bazy danych.
Prawidłowe elementy na liście to:

To ustawienie jest opcjonalne.

Przykład app.yaml aplikacji Streamlit

app.yaml Poniższy plik przedstawia sposób konfigurowania aplikacji Streamlit. Używa niestandardowego polecenia do uruchamiania aplikacji streamlit run i ustawia zmienne środowiskowe dla identyfikatora magazynu SQL oraz flagi śledzenia użycia.

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

Użyj takiej konfiguracji, jeśli aplikacja zależy od określonego zasobu obliczeniowego, takiego jak usługa SQL Warehouse, lub wymaga pewnych zmiennych środowiskowych w celu kontrolowania zachowania środowiska uruchomieniowego.

Przykład app.yaml aplikacji platformy Flask

W tym przykładzie pokazano, jak skonfigurować aplikację Platformy Flask przy użyciu serwera Gunicorn. Ustawienie command określa parametry uruchamiania Gunicorn, a część env ustawia ścieżkę do woluminu katalogu Unity jako zmiennej środowiskowej.

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

Użyj tego podejścia, gdy aplikacja wymaga serwera WSGI przeznaczonego do produkcji, takiego jak Gunicorn, i gdy zależy od danych przechowywanych w woluminie Unity Catalog lub innej ścieżki specyficznej dla środowiska.

Dalsze kroki