Kapsule Orbit 中的快照和还原

每个 Orbit 项目每晚都会对两样内容进行快照备份,这两样内容一旦删除就无法通过其他方式恢复:您的 配置存储 条目和您的 环境变量。保留三十个晚上的快照,包括免费计划在内的所有计划都有此功能,您可以在一次确认操作中自行恢复其中任何一个。

本指南介绍快照包含的内容、不包含的内容、如何恢复快照以及如何撤销恢复。

快照包含的内容

每个晚间快照都包含其所属项目的以下内容:

• 每个配置存储条目: 键、值,以及该条目是否注入到页面中。
• 每个环境变量, 包括项目级变量和各环境覆盖变量,包括它们的值、目标环境类型和分支范围。

值在静止时使用与您环境变量相同的密钥和密码进行加密,因此快照不会使密钥比其来源的变量更容易访问。

快照不包含的内容

在依赖快照之前,值得阅读此部分。

• 您的 Git 仓库。 它存储在您的 Git 提供商处,属于您。Orbit 不会复制它。
• Blob 存储对象。 您的 Blob 存储已具有持久性,不属于快照的一部分。
• 构建工件。 成功的构建会保留在您计划的部署保留期内,这是项目上的单独设置。恢复快照不会恢复构建,回滚部署也不会恢复配置或环境变量。请参阅 回滚部署。
• 数据库、日志、分析或应用程序在运行时写入的任何内容。

快照保留时间

三十个晚上,所有计划均适用。之后,快照会自动删除。

有一个刻意的例外。三个最近的快照始终保留, 即使它们超过三十个晚上。如果您有两个月没有触及某个项目,否则所有快照会在同一个晚上过期,在您最终需要恢复时,您将没有任何快照可用。

恢复快照

1. 在 Orbit 中打开您的项目。
2. 打开 设置,然后打开 快照。
3. 找到您想要的晚上。每行显示它包含多少个配置条目和环境变量,以及何时将被删除。
4. 单击 恢复此快照。
5. 按所示内容精确输入确认短语。它会命名您的项目和您正在恢复的晚上,例如 restore my-blog 2026-08-30。
6. 单击 立即恢复。

恢复需要拥有项目的账户具有 所有者 或 管理员 角色。任何可以看到项目的人都可以读取其快照历史记录。

恢复的实际作用

恢复会将您的项目恢复到该晚上的状态。这意味着它不是合并:

• 当时存在但现在缺少的条目和变量会被 重新创建,使用原始值;
• 自那以后值已更改的条目和变量会被 设置回 原始值;
• 您在该晚上 之后 添加的条目和变量会被 删除。

屏幕之后会准确告诉您发生了什么: 对于配置存储和环境变量,分别添加了多少个、更改了多少个和删除了多少个。

撤销恢复

在恢复写入任何内容之前,Orbit 会对其即将覆盖的状态进行快照。 它在您的列表中显示为 恢复前 行,确认屏幕在恢复完成时会命名它。

因此,如果您恢复了错误的晚上,恢复该行,您就会回到开始时的状态。恢复的任何部分都不是单向的。

恢复环境变量后

正在运行的部署拥有构建和启动时使用的环境变量。恢复它们会改变您 下一次 部署将使用的内容,因此如果您需要已恢复的值处于活跃状态,请重新部署。当您的配置自上次部署以来已更改时,项目会显示一个横幅。

恢复创建、更改或删除的每个变量都会记录在项目的环境变量历史记录中,显示谁进行了操作以及何时进行的,就像手动更改一样。

常见问题

快照何时运行? 晚间,在 UTC 04:00,作为修剪旧构建工件的同一晚间通过的一部分。

我可以按需获取一个吗? 今天在屏幕上无法获取。恢复始终首先进行一次快照,因此任何恢复前的状态始终被捕获。

快照需要花费任何费用吗? 不需要。所有计划都包含快照,配置存储本身读写是免费的。

恢复会显露我标记为只写的密钥吗? 不会。恢复会放回值;它不会显示它。只写变量保持只写。