Databricks 앱 배포

Azure Databricks 앱을 만들고 개발한 후 Azure Databricks 작업 영역에서 액세스할 수 있도록 배포합니다. 배포는 앱을 빌드하고, 종속성을 설치하고, 프로젝트 파일에 정의된 구성을 사용하여 실행합니다. Azure Databricks UI 또는 Azure Databricks CLI를 사용하여 앱을 배포할 수 있습니다.

배포 논리

Databricks Apps는 Python, Node.js또는 둘의 조합을 사용하는 애플리케이션 배포를 지원합니다. 이렇게 하면 Python 백 엔드가 있는 Node.js 프런트 엔드와 같은 유연한 아키텍처를 사용할 수 있습니다.

배포하는 동안 빌드 프로세스는 앱 디렉터리의 루트에 있는 package.json 파일을 확인하여 Node.js가 사용되는지 여부를 판단합니다. 있는 경우 Python 단계와 함께 노드별 빌드 단계가 포함됩니다. 배포 논리는 다음 패턴을 따릅니다.

있는 경우package.json:

1. npm install을 실행합니다.
2. 실행 pip install -r requirements.txt (있는 경우)
3. npm run build을 실행하세요 (build에 스크립트가 정의된 경우 package.json)
4. 지정된 app.yaml명령을 실행하거나 npm run start 명령이 지정되지 않은 경우

없는 경우package.json:

1. 실행 pip install -r requirements.txt (있는 경우)
2. 지정된 app.yaml명령을 실행하거나 python <my-app>.py 명령이 지정되지 않은 경우

배포 준비

앱을 배포하기 전에 프로젝트에 필요한 구성 요소가 포함되어 있는지 확인합니다.

• 기본 스크립트 - 진입점 파일(예: app.py 또는 app.js.
• 선택적 app.yaml 파일 - 앱에 사용자 지정 명령 또는 환경 변수가 필요한 경우 실행을 구성하는 파일을 포함합니다 app.yaml . Databricks 앱 실행 구성을 app.yaml 참조하세요.
• 종속성 - 모든 종속성을 사용할 수 있는지 확인합니다. Databricks 앱에 대한 종속성 관리를 참조하세요.
• 비밀 또는 환경 값 - 섹션env을 app.yaml 사용하는 경우 참조된 비밀 또는 외부 원본이 올바르게 구성되고 액세스할 수 있는지 확인합니다. Databricks 앱에 리소스 추가를 참조하세요.

또한 앱 서비스 주체 가 소스 코드 폴더에 액세스할 수 있는지 확인합니다.

앱 배포

Databricks 사용자 인터페이스

Azure Databricks UI에서 앱을 배포하려면 다음을 수행합니다.

1. Azure Databricks 작업 영역에 앱 파일을 업로드합니다. 자세한 내용은 파일 가져오기를 참조하세요.
2. 사이드바에서 컴퓨팅을 클릭합니다.
3. 앱 탭으로 이동하여 이름 열에서 앱에 대한 링크를 클릭합니다.
4. 배포를 클릭하고 앱 파일을 업로드한 작업 영역에서 폴더를 선택합니다.
5. 선택, 배포를 차례로 클릭합니다.
6. 구성을 검토하고 배포를 클릭합니다.

Databricks 명령줄 인터페이스 (CLI)

CLI를 사용하여 앱을 배포하려면 다음을 수행합니다.

1. 터미널을 열고 앱 파일이 포함된 디렉터리로 이동합니다.

2. 명령을 사용하여 Azure Databricks 작업 영역에 앱 파일을 업로드합니다 sync . 경로를 파일을 업로드할 작업 영역 위치로 바꿉다.

   databricks sync --watch . /Workspace/Users/my-email@org.com/my-app
   

   플래그는 --watch 동기화 프로세스를 계속 실행하고 파일을 로컬로 수정할 때 변경 내용을 자동으로 업로드합니다. 특정 파일 또는 디렉터리를 동기화에서 제외하려면 로컬 앱 디렉터리의 파일에 추가 .gitignore 합니다. 제외할 일반적인 파일은 node_modules/, .env, __pycache__/및 .DS_Store모든 큰 데이터 파일 또는 빌드 아티팩트입니다.

3. 작업 영역에서 파일을 확인하여 업로드를 확인합니다. 사이드바에서 작업 영역을 클릭하고 앱에 대해 만든 디렉터리로 이동합니다.

4. 다음 명령을 실행하여 앱을 배포합니다. 앱 이름 및 소스 코드 경로를 값으로 바꿉다.

   databricks apps deploy my-app-name \
      --source-code-path /Workspace/Users/my-email@org.com/my-app
   

   CLI는 배포 진행률을 표시하고 앱이 실행되는 시기를 확인합니다.

배포되면 Azure Databricks는 command가 파일에 정의된 대로 app.yaml을(를) 기반으로 시작하거나 기본적으로 python app.py을(를) 실행합니다.

배포 후 동작

배포가 완료되면 Azure Databricks는 관리되는 환경에서 앱을 시작합니다. 앱 세부 정보 페이지는 현재 상태를 표시하고 로그, 배포 기록 및 환경 정보에 대한 액세스를 제공합니다.

배포된 앱의 출력을 보려면 앱 링크를 클릭합니다.

디버깅 및 런타임 모니터링을 위해 로그 탭으로 이동합니다. Databricks 앱에 대한 로깅 및 모니터링을 참조하세요.

앱 업데이트 또는 다시 배포

소스 코드를 변경하거나, 파일을 업데이트 app.yaml 하거나, 다른 소스 코드 경로에서 배포해야 하는 경우 앱을 업데이트하거나 다시 배포할 수 있습니다. 다시 배포하면 앱을 처음부터 다시 만들 필요 없이 최신 업데이트가 적용됩니다.

배포된 앱을 변경하려면 다음을 수행합니다.

1. 앱 코드 또는 app.yaml 구성을 업데이트합니다.
2. Azure Databricks 작업 영역의 앱 페이지로 돌아갑니다.
3. 앱을 선택하고 배포 를 다시 선택합니다. 소스 코드 경로가 변경된 경우 배포 옆의 화살표를 클릭하고 다른 소스 코드 경로를 사용하여 배포를 선택합니다.

배포 문제 해결

앱이 배포에 실패하거나 예상대로 실행되지 않는 경우 다음 문제 해결 단계를 시도합니다.

• 로그 확인 - 로그 패널에서 오류 메시지 또는 런타임 출력을 봅니다.
• 확인 app.yaml - 구문이 올바르고 지원되는 설정이 사용되는지 확인합니다.
• 비밀 및 환경 변수 확인 - env 섹션에서 모든 참조가 올바르게 해결되는지 확인합니다.
• 종속성 확인 - 필요한 모든 패키지가 포함되거나 설치되어 있는지 확인합니다.

다음 단계

• Databricks 앱에 대한 로깅 및 모니터링
• Databricks 앱에 대한 권한 구성
• 를 사용하여 Databricks 앱 실행 구성 app.yaml