app.yaml Databricks 應用程式中的檔案定義了你的應用程式如何執行。 如果您的應用程式需要不同的進入點或環境特定設定,您可以在專案中包含此選擇性檔案,以覆寫默認行為。
您可以使用 .yaml 或 .yml 副檔名。 此檔案必須位於項目目錄的根目錄中。
支援的設定
檔案 app.yaml 支援下列設定。
| Setting | 類型 | Description |
|---|---|---|
command |
sequence |
當您需要自定義命令來執行應用程式時,請使用此設定。 根據預設,Azure Databricks 會使用 命令 python <my-app.py>執行 Python 應用程式,其中 <my-app.py> 是應用程式檔案結構中的第一個 .py 檔案。 如果應用程式包含 Node.js,則預設命令為 npm run start。 請參閱 部署邏輯。因為 Azure Databricks 不會在 shell 中執行這個指令,應用程式設定外定義的環境變數無法被你的應用程式使用。 如果您的應用程式需要其他參數才能執行,請使用 env 結構。此設定是選擇性的。 |
env |
list |
Azure Databricks 會在應用程式運行時間環境中自動設定數個 預設環境變數 。 此最上層金鑰會定義要傳遞至應用程式之其他環境變數的選擇性清單。 每個變數都可以使用硬編碼值或參考外部來源,例如機密或資料庫條目。 清單中的有效專案如下:
此設定是選擇性的。 |
Streamlit 應用程式範例app.yaml
下列 app.yaml 檔案示範如何設定 Streamlit 應用程式。 它使用自定義命令以streamlit run啟動應用程式,並設置與SQL倉庫ID及使用追蹤標誌相關的環境變數。
command: ['streamlit', 'run', 'app.py']
env:
- name: 'DATABRICKS_WAREHOUSE_ID'
value: 'quoz2bvjy8bl7skl'
- name: 'STREAMLIT_GATHER_USAGE_STATS'
value: 'false'
如果您的應用程式相依於特定的計算資源,例如 SQL 倉儲,或需要特定環境變數來控制運行時間行為,請使用這樣的設定。
Flask 應用程式範例app.yaml
此範例示範如何使用 Gunicorn 伺服器設定 Flask 應用程式。 此 command 設定會指定 Gunicorn 啟動參數,而 區段會將 env Unity 目錄磁碟區的路徑設定為環境變數。
command:
- gunicorn
- app:app
- -w
- 4
env:
- name: 'VOLUME_URI'
value: '/Volumes/catalog-name/schema-name/dir-name'
當您的應用程式需要生產就緒的 WSGI 伺服器,例如 Gunicorn,以及它相依於儲存在 Unity 目錄磁碟區或其他環境特定路徑中的數據時,請使用此方法。