이 문서는 Azure Databricks 모범 사례를 따르는 템플릿을 사용하여 Azure Databricks 작업 영역에서 간단한 앱을 만드는 단계별 예제를 사용하여 Databricks Apps를 시작하는 데 도움이 됩니다.
이 예제에서는 다음을 안내합니다.
- 템플릿에서 앱 만들기
- 앱이 배포된 후 앱 보기
- 추가 개발을 위해 앱 템플릿을 컴퓨터에 복사
- 로컬로 앱 실행
- 작업 영역에 앱 다시 배포
이 기사가 끝날 때까지 로컬에서 앱을 개발 및 수정하고 Databricks에 업데이트를 배포할 수 있습니다.
필수 조건
이 자습서를 완료하기 전에 Azure Databricks 작업 영역 및 로컬 개발 환경이 올바르게 구성되었는지 확인합니다. Databricks Apps 작업 영역 및 개발 환경 설정을 참조하세요.
1단계: 종속성 설치
터미널을 열고 다음 명령을 실행하여 다음을 수행합니다.
- 예제 앱에 필요한 Python 라이브러리를 설치합니다.
- 앱의 원본 및 구성 파일에 대한 로컬 디렉터리를 만듭니다.
pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world
gradio-hello-world 는 앱 파일의 로컬 디렉터리입니다.
2단계: 앱 만들기
Databricks 작업 영역에서 왼쪽 사이드바에서 + 새>앱을 클릭합니다.
템플릿에서 설치에서 Gradio 탭으로 이동합니다.
Hello World 템플릿을 선택합니다.
앱 이름을 gradio-hello-world로 지정하고 설치를 클릭합니다.
그러면 선택한 템플릿을 기반으로 새 앱이 만들어지고 작업 영역에 배포됩니다.
3단계: 앱 보기
앱을 만든 후 자동으로 시작되고 미리 보기에 사용할 수 있는 URL이 표시됩니다. 개요 페이지에서 앱 URL 및 배포 상태를 확인합니다.
URL을 클릭하여 앱을 봅니다.
4단계: 컴퓨터에 앱 복사
앱을 만든 후 로컬 컴퓨터에 소스 코드를 다운로드하여 사용자 지정할 수 있습니다.
파일 동기화에서 첫 번째 명령을 복사합니다.
터미널에서 만든 로컬 디렉터리로
gradio-hello-world이동한 다음 복사된sync명령을 실행합니다.databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app . ... Export complete이 명령은 두 개의 새 파일을
app.py와app.yaml라는 이름의 디렉터리에 복사합니다.app.yaml는 진입점 및 권한을 포함하여 앱의 구성을 정의합니다.app.py에는 앱의 기능 및 사용자 인터페이스를 구현하는 코드가 포함되어 있습니다.
5단계: 로컬에서 앱 수정 및 테스트
필요에 따라 로컬에서 앱을 사용자 지정하고 개발합니다. 예를 들어 데이터를 대화형으로 만들거나, 테마 또는 스타일 지정 옵션을 추가하거나, 데이터 업로드를 허용하도록 수정
app.py할 수 있습니다.앱을 테스트하려면 다음을 실행
python app.py합니다.python app.py Running on local URL: http://127.0.0.1:7860 ...앱을 보려면 브라우저 창으로 이동합니다
http://127.0.0.1:7860.필요에 따라 databricks 앱 실행-로컬 명령을 사용하여 앱을 실행하고 디버그합니다.
databricks apps run-local --prepare-environment --debug이 명령은 모든 종속성을 설치하고 가상 환경을 준비한 다음 포트 5678에서 앱과 디버거를 시작합니다.
http://localhost:8001앱을 보려면 이동합니다.Visual Studio Code에서 중단점을 설정하려면 Python 디버거 확장을 설치한 다음, 실행>시작 디버깅>원격 연결로 이동합니다.
6단계: 작업 영역에 앱 다시 배포
앱을 다시 배포하려면 앱 세부 정보 페이지의 Databricks 앱에 배포 아래 명령을 복사합니다.
로컬 디렉터리 내에서 gradio-hello-world 명령을 실행합니다.
명령이 성공적으로 실행되었습니다.
{
"create_time": "2025-06-09T19:36:50Z",
"creator": "my-email@org.com",
"deployment_artifacts": {
"source_code_path": "/Workspace/Users/1234abcd-5678-90ab-cdef-123456abcdef/src/abcd1234efgh5678ijkl9012mnop3456"
},
"deployment_id": "abcd1234efgh5678ijkl9012mnop3456",
"mode": "SNAPSHOT",
"source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app",
"status": {
"message": "App started successfully",
"state": "SUCCEEDED"
},
"update_time": "2025-06-09T19:36:51Z"
}
배포 상태를 보려면 앱의 개요 페이지로 이동합니다.
다음 단계
이제 첫 번째 앱을 배포하고 사용자 지정했으므로 다음을 수행할 수 있습니다.