时间点键值
Azure 应用程序配置将维护键值更改记录。 此记录提供键值更改的时间线。 可以重新构造任何键的历史记录,并在键值历史记录周期(免费层存储为 7 天,标准层存储为 30 天)内的任何时刻提供其过去的值。 通过此功能,可以向后查看并检索旧的键值。 例如,可以恢复最近部署前使用的配置设置,以便将应用程序回滚到以前的配置。
还原键值
可以使用 Azure 门户或 Azure CLI 检索以往的键值。
登录 Azure 门户。 选择“所有资源”,然后选择在其中存储了键值的应用程序配置存储实例。
在“操作”菜单中,选择“还原”。
选择“日期: 选择日期”以选择要还原到的日期和时间。
在日期和时间字段的外部单击,或按 Tab 以验证选择。 现在可以查看在所选日期和时间与当前时间之间更改了哪些键值。 此步骤可帮助你了解要准备还原到哪些键和值。
门户将显示一个键值表。 第一列中的符号指示了如果还原所选日期和时间的数据会发生什么情况:
- 红色减号 (-) 表示该键值在所选日期和时间不存在,将被删除。
- 绿色加号 (+) 表示该键值在所选日期和时间存在,但现在不存在。 如果还原到所选日期和时间,该键值将重新添加到配置中。
- 橙色项目符号 (•) 表示自从选择的日期和时间以来,该键值已修改。 该键将还原到在所选日期和时间使用的值。
选中行中的复选框可以选择/取消选择键值以执行操作。 选中后,将显示当前与所选日期和时间之间的键值差异。
在以上示例中,预览显示了键 TestApp:Settings:BackgroundColor,其当前值为 #FFF。 如果我们继续还原数据,此值将修改为 #45288E。
可以在表中选中一个或多个复选框,以便对所选的键值执行操作。 还可以使用列表顶部的“全选”复选框来选择/取消选择所有键值。
选择“还原”,将所选的键值还原到所选的日期和时间。
如下所述使用 Azure CLI 来检索和还原以往的键值。
在 CLI 中,使用 az appconfig revision list
查看更改或使用 az appconfig kv restore
还原键值(请添加相应的参数)。 通过提供存储名称 (--name <app-config-store-name>
) 或使用连接字符串 (--connection-string <your-connection-string>
) 来指定 Azure 应用程序配置实例。 通过指定特定的时间点 (--datetime
)、标签 (--label
) 和要返回的最大项数 (--top
) 来限制输出。
指定要返回的最大项数 (--top
)。
检索所记录的所有键值更改。
az appconfig revision list --name <your-app-config-store-name>
将所有键值还原到特定的时间点。
az appconfig kv restore --name <app-config-store-name> --datetime "2019-05-01T11:24:12Z"
按照从 v1 开始的任何标签还原 到特定的时间点。
az appconfig kv restore --name <app-config-store-name> --label v1.* --datetime "2019-05-01T11:24:12Z"
有关用于还原键值的 CLI 命令和可选参数的更多示例,请参阅 Azure CLI 文档。
还可以访问特定键值的历史记录。 使用此功能可以检查特定的键在所选时间点的值,并在不更新任何其他键值的情况下将它还原到过去的值。
键值的历史/时间线视图
提示
如果你只是进行少量的更改,则此方法很方便,因为配置资源管理器只允许逐个地对键进行更改。 如果需要一次性还原多个键值,请改用“还原”菜单。
还可以在门户中访问特定键值的修订历史记录。
在“操作”菜单中,选择“配置资源管理器”。
选择要浏览的键对应的“更多操作”,然后选择“历史记录”
现在,可以查看所选键的修订历史记录和有关更改的信息。
选择“还原”,将键和值还原到此时间点。
如下所述使用 Azure CLI 来检索和还原单个键值。
在 CLI 中,使用 az appconfig revision list
查看键值更改或使用 az appconfig kv restore
还原键值(请添加相应的参数)。 通过提供存储名称 (--name <app-config-store-name>
) 或使用连接字符串 (--connection-string <your-connection-string>
) 来指定 Azure 应用程序配置实例。 通过指定特定的键 (--key
) 来限制输出。 (可选)指定标签 (--label
)、时间点 (--datetime
) 和要返回的最大项数 (--top
)。
列出带有任何标签的键“颜色”的修订历史记录。
az appconfig revision list --name <app-config-store-name> --key color
列出带有标签的特定键值的修订历史记录。
az appconfig revision list --name <app-config-store-name> --key color --label test
列出带有多个标签的键值的修订历史记录。
az appconfig revision list --name <app-config-store-name> --key color --label test,prod,\0
检索特定时间点的键 color
的所有记录的更改。
az appconfig revision list --name <app-config-store-name> --key color --datetime "2019-05-01T11:24:12Z"
检索特定时间点的键 color
的最后 10 条已记录的更改。
az appconfig revision list --name <app-config-store-name> --key color --top 10 --datetime "2019-05-01T11:24:12Z"
有关更多示例和可选参数,请参阅 Azure CLI 文档。
后续步骤