Databricks 앱에서 app.yaml 파일은 애플리케이션의 실행 방식을 정의합니다. 앱에 다른 진입점 또는 환경별 구성이 필요한 경우 프로젝트에 이 선택적 파일을 포함하여 기본 동작을 재정의할 수 있습니다.
.yaml 또는 .yml 파일 확장자를 사용할 수 있습니다. 이 파일은 프로젝트 디렉터리의 루트에 있어야 합니다.
지원되는 설정
파일은 app.yaml 다음 설정을 지원합니다.
| Setting | 유형 | Description |
|---|---|---|
command |
sequence |
앱을 실행하기 위해 사용자 지정 명령이 필요한 경우 이 설정을 사용합니다. 기본적으로 Azure Databricks는 python <my-app.py>이 앱 파일 구조의 첫 번째 <my-app.py> 파일일 때 명령 .py을 사용하여 Python 앱을 실행합니다. 앱에 Node.js포함된 경우 기본 명령은 .입니다 npm run start.
배포 논리를 참조하세요.Azure Databricks는 셸에서 명령을 실행하지 않으므로 앱 구성 외부에서 정의된 환경 변수를 앱에서 사용할 수 없습니다. 앱을 실행하기 위해 추가 매개 변수가 필요한 경우 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'
앱에 Gunicorn과 같은 프로덕션 준비 WSGI 서버가 필요하고 Unity 카탈로그 볼륨 또는 다른 환경별 경로에 저장된 데이터에 따라 달라지는 경우 이 방법을 사용합니다.