다음을 통해 공유


Databricks 앱 시작

이 문서는 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단계: 앱 만들기

  1. Databricks 작업 영역에서 왼쪽 사이드바에서 + 새>앱을 클릭합니다.

  2. 템플릿에서 설치에서 Gradio 탭으로 이동합니다.

  3. Hello World 템플릿을 선택합니다.

    Hello World 템플릿 선택

  4. 이름을 gradio-hello-world로 지정하고 설치를 클릭합니다.

그러면 선택한 템플릿을 기반으로 새 앱이 만들어지고 작업 영역에 배포됩니다.

3단계: 앱 보기

앱을 만든 후 자동으로 시작되고 미리 보기에 사용할 수 있는 URL이 표시됩니다. 개요 페이지에서 앱 URL 및 배포 상태를 확인합니다.

앱 배포 후 앱 세부 정보 페이지 보기

URL을 클릭하여 앱을 봅니다.

hello world 앱의 출력을 로컬로 봅니다.

4단계: 컴퓨터에 앱 복사

앱을 만든 후 로컬 컴퓨터에 소스 코드를 다운로드하여 사용자 지정할 수 있습니다.

  1. 파일 동기화에서 첫 번째 명령을 복사합니다.

    앱을 만든 후 앱 세부 정보 페이지 보기

  2. 터미널에서 만든 로컬 디렉터리로 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.pyapp.yaml라는 이름의 디렉터리에 복사합니다. app.yaml 는 진입점 및 권한을 포함하여 앱의 구성을 정의합니다. app.py 에는 앱의 기능 및 사용자 인터페이스를 구현하는 코드가 포함되어 있습니다.

5단계: 로컬에서 앱 수정 및 테스트

  1. 필요에 따라 로컬에서 앱을 사용자 지정하고 개발합니다. 예를 들어 데이터를 대화형으로 만들거나, 테마 또는 스타일 지정 옵션을 추가하거나, 데이터 업로드를 허용하도록 수정 app.py 할 수 있습니다.

  2. 앱을 테스트하려면 다음을 실행 python app.py합니다.

    python app.py
    
    Running on local URL:  http://127.0.0.1:7860
    ...
    
  3. 앱을 보려면 브라우저 창으로 이동합니다 http://127.0.0.1:7860 .

  4. 필요에 따라 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"
}

배포 상태를 보려면 앱의 개요 페이지로 이동합니다.

다음 단계

이제 첫 번째 앱을 배포하고 사용자 지정했으므로 다음을 수행할 수 있습니다.

  • 앱에 액세스하고 편집할 수 있는 사용자를 관리하도록 권한 부여를 구성합니다.
  • Azure Databricks 비밀 또는 Databricks SQL과 같은 Azure Databricks 플랫폼 기능과 앱을 통합합니다.
  • 작업 영역 또는 조직 전체의 다른 사용자와 앱을 공유합니다.
  • 더 많은 앱 템플릿을 탐색하여 다양한 프레임워크 및 기능을 실험합니다.