Databricks 앱으로 시작된 Get

아티클
01/23/2025

Important

Databricks 앱은 공개 미리 보기로 제공됩니다.

이 문서는 단계별 예제를 사용하여 Databricks Apps를 get 로컬 개발 환경에서 간단한 앱을 만들고 Azure Databricks 작업 영역에 앱을 배포하는 데 도움이 됩니다. 이 예제에서는 다음을 안내합니다.

로컬에서 앱을 만들고 테스트합니다.
로컬로 테스트한 후 Databricks CLI를 사용하여 Azure Databricks 작업 영역에 앱을 추가합니다.
작업 영역에서 앱의 세부 정보 페이지 보기
앱의 소스 코드 및 아티팩트 복사를 작업 영역에 복사합니다.
작업 영역에서 앱의 출력 보기

예제를 단계별로 실행하기 전에 Azure Databricks 작업 영역 및 로컬 개발 환경이 요구 사항을 충족하는지 확인합니다.

Databricks는 앱을 개발할 때 Python 가상 환경을 사용하는 것이 좋습니다. 이 문서의 예제에서는 pipenv를 사용하여 가상 환경을 만듭니다. 자세한 내용은 Python Virtual Environments: A Primer를 참조 하세요.

이 예제는 Databricks Apps 템플릿 라이브러리에서도 사용할 수 있습니다. Databricks 앱 UI에서 앱을 만드는 어떻게 할까요? 참조하세요.

1단계: 로컬 환경을 설정 Set

터미널을 열고 다음 명령을 실행하여 다음을 수행합니다.

Python 가상 환경을 만들고 시작합니다.
예제 앱에 필요한 Python 라이브러리를 설치합니다.
앱의 원본 및 구성 파일에 대한 로컬 디렉터리를 만듭니다.

pipenv --python 3.11
pipenv shell
pip install gradio
pip install pandas
mkdir <app-dir-name>
cd <app-dir-name>

예를 들어 <app-dir-name>앱 파일의 로컬 디렉터리 이름으로 바꿉 gradio-hello-world 다.

2단계: 앱의 원본 및 구성 추가

텍스트 편집기 또는 즐겨 찾는 IDE(통합 개발 환경)에서 다음 코드를 사용하여 새 Python 파일을 만들고 만든 디렉터리에 저장합니다. 이 예제에서는 Python 파일의 파일 이름을 app.py 사용합니다.

import gradio as gr
import pandas as pd

data = pd.DataFrame({'x': [x for x in range(30)],
                     'y': [2 ** x for x in range(30)]})

# Display the data with Gradio
with gr.Blocks(css='footer {visibility: hidden}') as gradio_app:
    with gr.Row():
        with gr.Column(scale=3):
            gr.Markdown('# Hello world!')
            gr.ScatterPlot(value=data, height=400, width=700,
                           container=False, x='x', y='y',
                           y_title='Fun with data', x_title='Apps')

if __name__ == '__main__':
    gradio_app.launch()

텍스트 편집기 또는 IDE에서 다음 내용이 포함된 새 YAML 파일을 만들고 만든 디렉터리에 있는 파일에 app.yaml 저장합니다.
```
command: [
  "python",
  "<app-name.py>"
]
```
앱에 대한 코드를 포함하는 Python 파일의 이름으로 바꿉 <app-name.py> 습니다. 예들 들어 app.py입니다.

3단계: 로컬에서 앱 테스트

앱을 로컬로 테스트하려면 터미널을 열고 실행하여 앱에 대한 코드가 포함된 파일의 이름으로 바꿔 python <app-name.py> 서 실행<app-name.py>합니다.
```
python app.py
Running on local URL:  http://127.0.0.1:7860
...
```
앱의 출력을 보려면 브라우저 windowhttp://127.0.0.1:7860 엽니다.

4단계: 작업 영역에 앱 배포

작업 영역에서 새 앱을 만들고 로컬 환경에서 작업 영역으로 코드를 배포하려면 터미널을 열고 다음 단계를 완료합니다.

Azure Databricks 작업 영역에서 앱을 만듭니다.
참고 항목
- 앱을 만든 후에는 Databricks 앱에 할당된 이름을 변경할 수 없으며, Azure Databricks 작업 영역에 액세스할 수 있는 사용자는 작업 영역에 있는 모든 Databricks 앱의 이름과 배포 기록을 볼 수 있습니다. 또한 앱 이름은 시스템 tables에 기록된 레코드에 포함됩니다. 이러한 가시성 때문에 Databricks 앱의 이름을 지정할 때 중요한 정보를 포함해서는 안 됩니다.
- 이름은 앱을 호스트하는 Azure Databricks 작업 영역에서 고유해야 하며 소문자, 숫자 및 하이픈만 포함해야 합니다.
```
databricks apps create <app-name>
```
<app-name> 앱의 이름으로 대체합니다. 예들 들어 gradio-hello-world입니다.
create 명령이 완료되면 작업 영역에서 앱을 보려면, 사이드바에서 컴퓨트를 클릭하고, 앱 탭으로 이동한 다음, 이름column에서 앱 링크를 클릭합니다.
Sync 로컬 환경에서 Azure Databricks 작업 영역으로 파일을 전송하십시오. 로컬 환경에서 작업 영역으로 파일을 하는 명령은 파일의 작업 영역 경로를 포함하여 원본 파일을 Databricks 아래로 전송합니다. 이 명령을 복사하려면 클릭합니다 .
터미널에서 앱 파일이 포함된 디렉터리로 전환하고 복사한 sync 명령을 실행합니다.

참고 항목

명령으로 전송 databricks sync 하지 않으려는 특정 파일 또는 디렉터리가 로컬 앱 디렉터리에 있는 경우 해당 파일 또는 디렉터리를 .gitignore 로컬 앱 디렉터리의 파일에 추가합니다. 예를 들어 앱과 동일한 디렉터리에 Python 가상 환경 디렉터리가 있는 경우 파일에 .gitignore 디렉터리의 이름을 추가하고 파일을 전송할 sync 때 해당 디렉터리를 건너뜁니다.
```
databricks sync --watch . /Workspace/Users/user@databricks.com/gradio-hello-world
...
Initial Sync Complete
```
명령이 완료될 때 sync 작업 영역에서 동기화된 파일을 보려면 사이드바에서 작업 영역을 클릭하고 앱에 대해 만든 디렉터리로 이동합니다.
앱을 배포하려면 터미널에서 다음 명령을 실행하여 앱 파일의 작업 영역 경로로 대체 <app-path> 합니다.

databricks apps deploy gradio-hello-world --source-code-path <app-path>
배포 상태를 보려면 앱의 세부 정보 페이지로 이동합니다.

배포된 앱의 출력을 보려면 세부 정보 페이지의 앱 이름 아래에 있는 앱 링크를 클릭합니다.