Databricks 앱 시작

이 페이지에서는 단계별 예제를 사용하여 Databricks 앱을 시작하여 Azure Databricks 모범 사례를 따르는 템플릿을 사용하여 Azure Databricks 작업 영역에서 간단한 앱을 만들 수 있습니다.

이 예제에서는 다음을 안내합니다.

  • 템플릿에서 앱 만들기
  • 앱이 배포된 후 앱 보기
  • 추가 개발을 위해 앱 템플릿을 컴퓨터에 복사
  • 로컬로 앱 실행
  • 작업 영역에 앱 다시 배포

이 기사가 끝날 때까지 로컬에서 앱을 개발 및 수정하고 Databricks에 업데이트를 배포할 수 있습니다.

Tip

작업 영역 동기화 대신 Git 리포지토리에서 배포하려면 템플릿을 건너뛰고 만드는 동안 구성된 Git 리포지토리를 사용하여 사용자 지정 앱을 만듭니 다. 그런 다음 배포하려면 Git 리포지토리에서 배포를 참조하세요.

필수 조건

이 자습서를 완료하기 전에 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 작업 영역에서 앱 아이콘 을 클릭합니다. 앱 전환기를 선택하고 Databricks 앱을 선택합니다.

  2. + 앱 만들기를 클릭합니다.

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

    헬로 월드 템플릿을 선택하십시오

  4. 앱 이름을 gradio-hello-world로 지정하고 앱 만들기를 클릭합니다.

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

3단계: 앱 보기

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

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

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

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

Azure Databricks 앱 이름 및 작업 영역 ID에 따라 자동으로 앱 URL을 생성합니다. 앱을 만든 후에는 URL을 변경할 수 없습니다. 다른 URL이 필요한 경우 다른 이름으로 새 앱을 만듭니다. 자세한 내용은 앱 URL을 참조하세요.

4단계: 컴퓨터에 앱 복사

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

  1. IDE의 편집 아래에 있는 명령을 복사합니다.

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

  2. 터미널에서 만든 로컬 디렉터리로 gradio-hello-world 이동한 다음 복사된 명령을 실행합니다.

    databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app .

...
Export complete

gradio-hello-world % databricks sync --watch . /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app

...
Initial Sync Complete

    첫 번째 명령은 작업 영역에서 app.py, app.yaml, 및 requirements.txt 세 개의 파일을 로컬 디렉터리로 내보냅니다. 두 번째 명령은 로컬 파일 변경 내용을 감시하고 작업 영역에 자동으로 업로드하는 동기화 프로세스를 시작합니다.

    • app.py 에는 앱의 기능 및 사용자 인터페이스를 구현하는 코드가 포함되어 있습니다.
    • app.yaml 는 진입점 및 권한을 포함하여 앱의 구성을 정의합니다.
    • requirements.txt 앱에 필요한 Python 패키지를 나열합니다.

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 디버거 확장을 설치한 다음 Run>Start Debugging>Remote Attach로 이동합니다.

6단계: 작업 영역에 앱 다시 배포

앱을 다시 배포하려면 앱 개요 페이지에서 Databricks 앱에 배포 아래의 명령을 복사합니다.

명령을 복사하여 앱 배포

로컬 디렉터리 내에서 gradio-hello-world 명령을 실행합니다.

명령이 성공적으로 실행되었습니다.

{
  "create_time": "2026-02-03T23:25:38Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/4cfd4a36-2cef-4155-88c4-d258ed6d0d91/src/01f10157a60a113e980014bebd5f4a03"
  },
  "deployment_id": "01f10157a60a113e980014bebd5f4a03",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2026-02-03T23:25:41Z"
}

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

7단계(선택 사항): Git 리포지토리에서 배포

이전 단계에서는 작업 영역 동기화를 사용하여 앱을 배포합니다. 확장성 있는 워크플로를 위해 앱 코드를 Git 리포지토리로 푸시하고 여기에서 배포합니다. 이를 통해 버전 제어를 사용하고, 팀원과 공동 작업하고, 필요에 따라 모든 푸시에 자동 배포할 수 있습니다.

  1. 디렉터리에서 gradio-hello-world Git 리포지토리를 초기화하고 Git 공급자(예: GitHub)에 푸시합니다.

    git init
git add .
git commit -m "Initial app code"
git remote add origin https://github.com/your-org/gradio-hello-world
git push -u origin main

  2. 앱에서 Git 리포지토리를 구성합니다.

    databricks apps create-update gradio-hello-world \
   --json '{"update_mask": "git_repository", "git_repository": {"url": "https://github.com/your-org/gradio-hello-world", "provider": "gitHub"}}'

  3. 프라이빗 리포지토리의 경우 앱의 서비스 주체에 대한 Git 자격 증명을 추가합니다. Git 리포지토리에서 배포의 CLI 지침을 참조하세요.

  4. Git에서 배포:

    databricks apps deploy gradio-hello-world \
   --json '{"git_source": {"branch": "main"}}'

Git 배포를 구성한 후 리포지토리로 푸시하고 배포 명령을 다시 실행하여 다시 배포할 수 있습니다. 모든 푸시에서 자동으로 다시 배포하려면 자동 Git 배포를 사용하도록 설정합니다. 자동 Git 배포 사용(베타)을 참조하세요.

추가 리소스

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

  • Last updated on