捆绑部署历史

Important

此功能在 Beta 版中。

部署历史为你工作空间中每一次声明式自动化捆绑包部署提供了结构化、可审计的记录。 部署是指部署到特定目标的捆绑包。 每次部署,都会记录一个新的 版本 。

对于每次部署,您可以回顾:

  • 部署元数据:部署者身份、时间戳、目标及最终状态。
  • 源代码控制上下文:Git 仓库、分支、提交 SHA 以及与该版本相关的任何发布标签。
  • 资源变更:每个版本中创建、更新、删除或重创建的资源。

部署历史是一个验证部署、调查回归以及回答诸如谁最后修改作业或流水线等问题的单一平台。 它是将 Databricks 资源作为代码进行管理的团队实施受治理部署的基础。

有关捆绑包的概述,请参阅 什么是声明性自动化捆绑包?。 如需了解如何部署捆绑包,请参阅 部署捆绑包并从工作区运行工作流 和 声明式自动化捆绑包部署模式。

启用部署历史

注释

部署历史在 Databricks CLI 版本 1.23.0 及以上版本中可用。

从工作区部署的捆绑包默认启用部署历史记录。 你可以在账号中为所有工作区切换这个设置,或者在包配置中针对特定包设置。

部署历史账户设置

部署历史设置控制你从工作区部署的包是否记录部署历史。 该设置适用于你账户中的每个工作区。

要更改设置,请执行以下其中之一:

部署窗格中的部署历史开关

  • 点击工作区右上角的用户名,然后点击 设置。 在 “设置” 边栏中,选择“ 开发人员”。 在 实验功能中,启用或关闭 部署历史。

注释

部署历史用户设置仅适用于工作区中的部署。 要在使用 Databricks CLI 部署时记录部署历史,请将 experimental.deployment_history 设置为 true。 参见试验。

覆盖包的设置

要启用或禁用特定捆绑包的部署历史,请在捆绑包配置中设置 experimental.deployment_history :

experimental:
  deployment_history: true

查看部署情况

要查看部署,请选择以下之一:

  • 从一个捆绑包的 部署 面板中,打开该捆绑包的部署历史。 请参阅 部署捆绑包并从工作区运行工作流。
  • 对于由捆绑包管理的作业、管道或仪表板,请使用管理方指示器跳转到管理该资源的部署。
  • 按名称搜索捆绑包,可以直接打开其部署历史。

部署列表显示你CAN_READ访问的所有部署(以及对应的版本和资源)。

部署历史列表

您可以按以下列对列表进行筛选和排序:

列 说明
Name bundle 和 target,或者部署显示名。
Target 部署目标,如 dev 或 prod。
地位 最新部署的状态。

查看部署版本详情

从部署历史中选择某个部署以打开其详细信息,然后再选择某个版本,即可查看相关信息,例如部署的发起时间及发起人、源 Git 仓库和分支、提交 SHA(链接到你的 Git 提供平台中的差异对比),以及发布标签(如果适用)。

部署详情

使用页眉中的版本历史下拉菜单在各个版本之间切换。

资源变更会在表中列出,每行包含变更资源的键(如 jobs.ETL_Main)、对资源执行的操作(创建、更新、删除或重创建)、资源状态以及变更的时间戳。

通过命令行界面查看部署历史

对于自动化工作流,你可以用Databricks的CLI bundle-deployments 命令访问部署历史。 参见 databricks bundle-deployments。

局限性

  • 部署历史是基于尽力而为记录的,尚未成为部署状态的权威信息来源。 在极少数情况下,如在 Databricks 基础设施出现问题期间,即使部署成功,历史条目也可能缺失。
  • 部署的底层实体(如作业运行)可能具有保留策略。
  • 仅支持使用直接引擎的部署。 请参阅 “迁移到直接部署引擎”。

其他资源