用途:修复 Databricks Asset Bundles(DAB)部署时的常见陷阱及配套基础设施运维问题,覆盖 UC 目录/外部位置绑定、Terraform 状态读取、GRANT 顺序、客户管理密钥(CMK)轮换和 PrivateLink 成本泄漏五类场景。
主要能力:提供两个钩子——PreToolUse 的 bundle-deploy-guard.py 在 databricks bundle deploy 前校验本地 Terraform 状态是否为合法 JSON,缓存已知良好备份,状态损坏或缩小时告警(D5);PostToolUse 的 bundle-grant-retry.py 仅在出现 D6 签名错误时建议重试一次并说明原因。两者均为建议性:前者不阻止部署,后者不掩盖真实错误。scripts/ 目录提供 UC 资源导入方案生成、工作区排空/恢复、VPC 端点审计与修复 Terraform 生成;references/ 提供引擎取舍、按云 CMK 轮换、成本泄漏映射等资料。控制面状态来自 databricks-workspace-mcp 或 CLI,缺失时可回退到粘贴输入的咨询模式。
使用方式:按症状选择流程并指明确切错误串或 issue 编号。状态失败时可用 DATABRICKS_BUNDLE_ENGINE=direct databricks bundle deploy -t "$TARGET";首次部署报 GRANT 顺序错误时原样重跑一次;UC 资源绑定用 python3 import-uc-resource-to-bundle.py --type external_location --name raw_zone --resource-key raw_zone_loc 生成导入计划;CMK 轮换先列举计算资源再运行 drain-workspace.py(默认演练);VPC 审计用 audit-vpc-endpoints.py --present s3 --vpc-id vpc-abc --region us-east-1 --emit-terraform。
适用场景:平台团队处理 DAB 部署失败、UC 资源纳管、CMK 轮换维护窗口及 PrivateLink 后 NAT 费用异常。
限制:需 Databricks CLI 已认证,并安装 terraform 与 jq;CMK 轮换需账户级 OAuth M2M 服务主体,工作区 PAT 不足,且需先排空全部计算;钩子随插件包安装。价格、平台支持及其他细节资料暂未提供。