Развертывание приложения Databricks

После создания и разработки приложения Azure Databricks разверните его, чтобы сделать его доступным в рабочей области Azure Databricks. Развертывание создает приложение, устанавливает зависимости и запускает его с помощью конфигурации, определенной в файлах проекта. Вы можете развертывать приложения с помощью пользовательского интерфейса Azure Databricks или Интерфейса командной строки Azure Databricks.

Замечание

Если вы создаете приложение из шаблона, Azure Databricks развертывает его автоматически при первом создании. Однако его можно повторно развернуть позже после внесения изменений. См. статью "Создание приложения Databricks" из шаблона.

Логика развертывания

Databricks Apps поддерживает развертывание приложений, использующих Python, Node.jsили сочетание обоих. Это позволяет использовать гибкие архитектуры, например интерфейс Node.js с серверной частью Python.

Во время развертывания процесс сборки проверяет наличие 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 если команда не указана.

Замечание

Если в app.yaml не указана команда, Azure Databricks выполняет npm run start, даже если приложение содержит код на Python. Чтобы запустить процессы Python и Node.js, определите пользовательский start скрипт, использующий инструмент, такой как concurrently, чтобы запустить оба. Например: concurrently "npm run start:node" "python my_app.py".

Если 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, выполните следующие действия.

1. Отправьте файлы приложения в рабочую область Azure Databricks. Инструкции см. в разделе "Импорт файла".
2. Щелкните "Вычисления" на боковой панели.
3. Перейдите на вкладку "Приложения" и щелкните ссылку на приложение в столбце "Имя ".
4. Щелкните «Развернуть» и выберите папку в рабочей области, в которую вы загрузили файлы приложения.
5. Нажмите кнопку "Выбрать", а затем "Развернуть".
6. Просмотрите конфигурацию и нажмите кнопку "Развернуть".

Databricks 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
   

   Интерфейс командной строки отображает ход развертывания и подтверждает выполнение приложения.

После развертывания 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