部署 Databricks 应用

创建并开发 Azure Databricks 应用后，即可部署它。 部署使应用可在 Azure Databricks 工作区中访问，并使用项目文件中定义的设置运行它。

部署逻辑

Databricks Apps 支持部署使用 Python、Node.js或两者组合的应用程序。 这允许灵活的架构，例如一个 Node.js 前端与一个 Python 后端。

在部署期间，构建过程会检查应用程序目录根的 package.json 文件，以确定是否使用了 Node.js。 如果存在，它将包含特定于 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 配置执行的文件。 请参阅使用 app.yaml 配置 Databricks 应用执行。
• 依赖项 - 确保所有依赖项都可用。 请参阅 管理 Databricks 应用的依赖项。
• 机密或环境值 - 如果使用 env 中的 app.yaml节，请验证引用的机密或外部源是否已正确配置和可访问。 请参阅 将资源添加到 Databricks 应用。

此外，请确保应用 服务主体 有权访问源代码文件夹。

部署应用

Databricks 用户界面

若要从 Azure Databricks UI 部署应用，请执行以下作：

1. 将应用文件上传到 Azure Databricks 工作区。 有关说明，请参阅 导入文件。
2. 单击侧栏中的计算。
3. 转到“ 应用 ”选项卡，然后单击“ 名称 ”列中应用的链接。
4. 单击“ 部署 ”并选择在其中上传应用文件的工作区中的文件夹。
5. 单击 “选择”，然后单击 “部署”。
6. 查看配置，然后单击“ 部署”。

Databricks 命令行界面 (CLI)

若要使用 CLI 部署应用，请执行以下作：

1. 打开终端，导航到包含应用文件的目录，并运行 sync 命令将其上传到 Azure Databricks。 将路径替换为要上传文件的工作区位置。

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

   若要排除特定文件或目录，请将它们添加到您本地应用目录中的 .gitignore 文件中。

2. 若要查看工作区中的文件，请单击边栏中的 工作区 ”，然后转到为应用创建的目录。

3. 若要部署应用，请在终端中运行以下命令。 将源代码路径替换为应用文件的工作区位置。

   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。

部署后行为

部署后，应用在托管环境中运行。 若要查看部署状态，请转到应用的概述页。

若要查看已部署应用的输出，请单击应用链接。

转到“ 日志 ”选项卡进行调试和运行时监视。 请参阅 Databricks 应用的日志记录和监视。

更新或重新部署应用

如果对源代码进行了更改、更新 app.yaml 了文件或需要从其他源代码路径进行部署，则可能需要更新或重新部署应用。 重新部署会应用最新的更新，而无需从头开始重新创建应用。

若要更改已部署的应用，请执行以下作：

1. 更新应用代码或 app.yaml 配置。
2. 返回到 Azure Databricks 工作区中的 “应用” 页。
3. 选择应用，然后再次选择 “部署 ”。 如果源代码路径已更改，请单击“部署”旁边的箭头并选择“使用不同的源代码路径进行部署”

排查部署问题

如果应用无法部署或未按预期运行，请尝试以下故障排除步骤：

• 检查日志 - 在日志面板中查看错误消息或运行时输出。
• 驗證 app.yaml - 确保语法正确且支持设置已使用。
• 验证机密和环境变量 - 请确保 env 部分的所有引用都正确解析。
• 确认依赖项 - 确保包含或安装所有必需的包。