SuperAPI AI 工具集

deploy

部署与运维

查看项目

更新于 10-15 20:33

技能介绍

用途:把智能体应用部署到 Databricks Apps,使用 Databricks Asset Bundles(DAB)完成打包、部署与启动。

主要能力:读取 .env 中的 DATABRICKS_CONFIG_PROFILE 并在所有 CLI 命令中带上 --profile;按 agent-* 前缀命名应用;执行预检、校验、部署与运行;处理“应用已存在”错误(绑定或删除重建);解绑应用;用 OAuth 令牌查询已部署应用;查看日志与状态;支持 OBO 用户身份认证;部署后为自动扩缩 Lakebase 授予表权限。

使用方式:先读 .env 获取 profile,命令形如 databricks <command> --profile <profile>。部署流程:uv run preflight、databricks bundle validate、databricks bundle deploy、databricks bundle run {{BUNDLE_NAME}}。注意 bundle deploy 只上传文件与配置资源,必须再执行 bundle run 才会用新代码启动应用。应用名在 databricks.yml 的 resources.apps 下配置,需用 agent-* 前缀。

绑定已有应用:用 databricks apps get <name> --output json | jq '{name, budget_policy_id, description}' 获取配置并同步到 databricks.yml;生产模式需设置 workspace.root_path;用 databricks bundle summary 检查是否已绑定,未绑定则 databricks bundle deployment bind {{BUNDLE_NAME}} <existing-app-name> --auto-approve。删除重建会永久删除 URL、OAuth 凭据与服务主体。解绑用 databricks bundle deployment unbind {{BUNDLE_NAME}},不会删除应用。

查询与调试:Databricks Apps 仅支持 OAuth 令牌,PAT 会返回 302。用 databricks auth token | jq -r '.access_token' 获取令牌,再向 <app-url>/invocations 发送请求;使用记忆时可在 custom_inputs 中传 user_id。日志用 databricks apps logs <app-name> --follow,状态与 URL 用 databricks apps get。

限制与注意:应用名不可变,改名会触发销毁重建;Terraform 状态为远程存储;部署前应检查计划中的 # forces replacement;流式响应中 200 OK 不代表无错误;依赖用 uv add 添加;Lakebase 原生 postgres 资源需 CLI v0.295.0+。其余细节暂未提供。