Bagikan melalui

Mengonfigurasi eksekusi aplikasi Databricks dengan app.yaml

File app.yaml dalam aplikasi Databricks menentukan cara aplikasi Anda berjalan. Jika aplikasi Anda memerlukan titik masuk atau konfigurasi khusus lingkungan yang berbeda, Anda dapat menyertakan file opsional ini dalam proyek Anda untuk mengambil alih perilaku default.

Anda dapat menggunakan .yaml ekstensi file atau .yml . File ini harus terletak di akar direktori proyek Anda.

Pengaturan yang didukung

File app.yaml mendukung pengaturan berikut.

Setting Tipe Description
command sequence Gunakan pengaturan ini saat Anda memerlukan perintah kustom untuk menjalankan aplikasi Anda. Secara default, Azure Databricks menjalankan aplikasi Python menggunakan perintah python <my-app.py>, di mana <my-app.py> merupakan file pertama .py dalam struktur file aplikasi Anda. Jika aplikasi Anda menyertakan Node.js, perintah defaultnya adalah npm run start. Lihat Logika penyebaran.
Karena Azure Databricks tidak menjalankan perintah di shell, variabel lingkungan yang ditentukan di luar konfigurasi aplikasi tidak tersedia untuk aplikasi Anda. Jika aplikasi Anda memerlukan parameter tambahan untuk dijalankan, gunakan env struktur.
Pengaturan ini bersifat opsional.
env list Azure Databricks secara otomatis mengatur beberapa variabel lingkungan default di lingkungan runtime aplikasi. Kunci tingkat atas ini mendefinisikan daftar opsional variabel lingkungan tambahan untuk diteruskan ke aplikasi Anda. Setiap variabel dapat menggunakan nilai yang dikodekan secara permanen atau mereferensikan sumber eksternal, seperti entri rahasia atau database.
Item yang valid dalam daftar adalah:

Pengaturan ini bersifat opsional.

Contoh app.yaml untuk aplikasi Streamlit

File berikut app.yaml menunjukkan cara mengonfigurasi aplikasi Streamlit. Ini menggunakan perintah kustom untuk memulai aplikasi dengan streamlit run, dan mengatur variabel lingkungan untuk ID gudang SQL dan bendera pelacakan penggunaan.

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

Gunakan penyiapan seperti ini jika aplikasi Anda bergantung pada sumber daya komputasi tertentu, seperti gudang SQL, atau memerlukan variabel lingkungan tertentu untuk mengontrol perilaku runtime.

Contoh app.yaml untuk aplikasi Flask

Contoh ini menunjukkan cara mengonfigurasi aplikasi Flask menggunakan server Gunicorn. Pengaturan command menentukan parameter startup Gunicorn, dan env bagian mengatur jalur ke volume Unity Catalog sebagai variabel lingkungan.

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

Gunakan pendekatan ini saat aplikasi Anda memerlukan server WSGI siap produksi seperti Gunicorn dan ketika bergantung pada data yang disimpan dalam volume Katalog Unity atau jalur khusus lingkungan lainnya.

Langkah selanjutnya

  • Last updated on