备份与恢复
Rediacc 会备份加密仓库,并在同一台机器或另一台机器上恢复它们。备份之所以是加密的,是因为仓库本身就是加密的:离开机器的只有密文,恢复时需要仓库的 LUKS 凭据。
备份有两种方式,它们回答的是不同的问题。
- 快照到分块存储(
rdc backup snapshot)保留一段可以回溯的历史,这是主要路径。 - 在另一台机器上留一份副本(
rdc repo push、rdc repo pull),在你自己掌控的硬件上保留仓库当下的原样。这个过程不涉及任何云账户。
这两种方式相互独立。用一种方式备份过的仓库,并不算用另一种方式也备份过。
快照的工作原理
仓库镜像会在一个固定的网格上被切分成固定大小的单元格。每个单元格要么是一个”洞”(意味着那里从未写入过任何内容),要么保存在一个键下,而这个键就是该单元格密文的 SHA-256。
正是这一个决定,带来了下面所有的特性。
只有真正的变更才会产生成本。 第一次快照会上传所有已写入的单元格。之后每次运行都会向文件系统查询哪些区段(extent)被改动过,只读取并哈希这些区段,再只上传存储中尚不存在的单元格。一个数据几乎没怎么变化的仓库几乎不会上传任何内容,运行时间只需几分钟,而不是随镜像大小线性增长。
相同的数据只保存一次。 由于键就是内容的哈希,共享同一个单元格的两个快照会共享同一个对象;仓库和它的分支(fork)也是如此:一个分支家族是针对同一个血统进行备份的,而不是重复备份其父级。
恢复一个旧快照,并不比恢复一个新快照更慢。 这里没有一条必须按顺序回放的增量链。恢复操作会把快照解析成一份完整的单元格列表,然后直接获取这些单元格,因此恢复所需的时间取决于镜像大小和你的带宽,而不是你做备份已经做了多久。洞依然是洞,因此稀疏镜像恢复后依然稀疏;在镜像中多处出现的同一个单元格也只会被下载一次。
每个快照都能独立成立。 不存在那种”绝对不能丢”的”完整备份”,也不存在某个损坏的增量会让之后所有增量都失效的窗口期。列表中的任何一个快照都可以直接恢复。
校验靠的是重新哈希,而不是信任。 既然键就是内容的哈希,校验一份备份就意味着取回单元格并重新哈希它们。rdc backup verify 做抽样校验;rdc backup verify --deep 会对每一个记录在案的单元格重新哈希。
中断的运行不会白费。 上传会在恢复时跳过已经送达的单元格,不会重复发送;重新开始一次中断了一半的恢复,会对磁盘上已有的内容重新哈希并复用,而不是重新下载。
这会花费你什么
配额是按物理上唯一存储的字节数计算的:也就是去重之后实际占用的量,而不是所有快照在逻辑上代表的总量之和。一个变化缓慢的仓库,做三十次快照的成本接近于做一次。
rdc backup usage 会显示已存储字节数相对于配额的占比;配额是按订阅计的数值,Community 套餐从 10 GB 起步。
使用免费许可证的机器没有托管备份,备份命令会以升级提示拒绝。注册账户(Community 套餐免费),并将机器登录到该账户后,其备份将计入 10 GB 的托管存储。
快照需要什么
快照上传要经过账户服务器,后者会根据仓库已安装的许可证为每次运行授权,并向机器下发一个短期有效的写入许可。因此这条路径需要机器能够访问到账户服务器,并且仓库要有有效许可证。少了这些,快照不会被悄悄跳过,而是会被拒绝,rdc backup manifests、rdc backup usage 和 rdc backup retention 也就没有可读取的内容。
这同样适用于 --dry-run。因为在判断本次运行究竟是在做计划还是在上传之前,系统就会先读取许可证,所以试运行是对实际工作的预览,而不是一种在没有凭据的情况下试用命令的方式。
机器到机器的 push 和 pull 两者都不需要。它们是两台已经在你配置中的机器之间的直接传输。
快照不做出的承诺
- 一个快照只覆盖一个仓库,不会一次性覆盖整台机器。 每个仓库都是在各自的那一瞬间被捕获的。如果两个仓库彼此依赖,它们的快照并不是一对协调好的整体。
- 这不是持续复制。 快照是你捕获的某一个时间点,自上次快照以来写入的所有内容都可能丢失,具体丢多少取决于你运行的频率。
- 存储的对象只写一次,不是经过认证的 WORM。 单元格是以”仅创建”的条件写入的,机器获得的许可无法删除任何东西,删除操作是按保留策略在服务器端执行的。这对”被攻陷的机器摧毁自己的备份”是一道真实的屏障,但它不是合规认证,也不会按合规标准接受审计。
目标
一个策略可以写入 home 存储、第二个托管区域,或已注册的客户存储桶,每个目标都是各自独立的恢复点。存储、为目标指定存储、使用 --from 恢复以及按目标查看状态,都在备份目标页面中说明。repo push 和 repo pull 的 --to 与 --from 仍然只接受机器名。
分块存储命令
# 上传一个快照。首次运行播种,之后只发送变化的单元格。
rdc backup snapshot my-app
# 只计划不上传:报告会移动哪些内容。
rdc backup snapshot my-app --dry-run
# 停止容器,冻结,重启,然后上传。
rdc backup snapshot my-app --cold
# 不信任本地锚点,重新上传完整清单。
# 这会重新上传所有内容并重新计入配额;仅在已确认
# 锚点损坏时使用。
rdc backup snapshot my-app --reseed
# 检查已存储的清单和你的配额。
rdc backup verify my-app
rdc backup manifests my-app
rdc backup usage
| 选项 | 描述 |
|---|---|
<repo-ref>(位置参数) | 要做快照的仓库 |
--dry-run | 仅计划:不上传。报告会移动哪些内容 |
--cold | 停止容器,冻结,重启,然后上传。不能与 --dry-run 同时使用 |
--reseed | 不信任本地锚点,上传完整清单。重新上传所有内容并重新计入配额 |
--accept-identity-change | 当镜像的 LUKS 标识发生变化或镜像变小时,把它作为新的基线。会上传完整快照,定时运行永远不会带上该选项 |
--read-bwlimit <limit> | 快照从磁盘读取镜像的速度上限,单位与 --bwlimit 相同(默认 50M,0 = 不限速) |
--hash-parallelism <n> | 哈希工作线程数(默认 1,0 = 每个 CPU 一个,最多 16) |
--debug | 启用详细输出 |
上传上限与读取上限相互独立。--bwlimit 限制发送量,默认不限速;--read-bwlimit 限制从磁盘读取并计算镜像哈希的速度。ionice 只对 BFQ I/O 调度器生效,因此在 mq-deadline 或 none 下,真正约束磁盘负载的是读取上限。
冷快照(--cold)
冷快照会在冻结之前先停止仓库,因此保存下来的镜像是应用一致的,而不是崩溃一致的。这个命令直接在机器本身上运行:
# 默认数据存储上的所有仓库。
sudo renet backup snapshot --cold
# 只处理你指定的仓库。--repo 接受一个仓库 GUID,可重复指定。
sudo renet backup snapshot --cold --repo <guid> --repo <guid>
--cold 不能与 --dry-run 同时使用。一个会停止容器的试运行就不算是”试”运行了,而一个不停止容器的运行也算不上”冷”,因此 renet 会直接拒绝这种组合,而不是替你决定它的含义。
一次冷运行会做什么
对每个被选中的仓库,按以下顺序执行:
- 停止其容器。
- 将仓库挂载点和数据存储刷写到磁盘。
- 确认容器确实已经停止。
- 对仓库镜像做一次写时复制(copy-on-write)reflink。
- 重新启动容器。
只有在此之后上传才会开始,此时所有仓库都已经重新启动完毕。
停机时间指的是冻结,而不是传输。reflink 只是元数据,因此无论仓库是 1 GB 还是 100 GB,所需时间都一样。上传就不是这样了:它会随着变化的字节数增长,而首次快照要上传整个非空清单。如果一直让容器保持停止状态直到上传完成,停机时间就会被拴在数据量上,而在首次播种时,这意味着要花上数小时,而不是几毫秒。
被选中的所有仓库是在一个统一的时间窗口内一起停止的,而不是逐个停止。这会让每个仓库的停机时间略微延长一些,但换来的是整个集合有一个统一的一致性时间点。
一个没有任何容器在运行的仓库本来就已经是安静的。它会在没有任何停机的情况下被拍下快照,这是一个正常的结果,而不是失败。
停机时间的成本
在一台真实机器上测得的总停机时间是 222 毫秒:
| 阶段 | 实测值 | 发生了什么 |
|---|---|---|
cold_down | 64 ms | 容器停止 |
cold_sync | 26 ms | 仓库挂载点和数据存储被刷写到磁盘 |
cold_verify | 31 ms | 确认容器已经停止 |
cold_stage | 0 ms | 仓库镜像的 reflink |
cold_up | 99 ms | 容器重新启动 |
占大头的是容器重启,而暂存(staging)几乎不花时间:reflink 在毫秒级分辨率下根本测不出来。不过,读这个”零”的时候不要孤立地看,要结合每个仓库各自的记录一起读。一次拒绝了所有仓库的运行同样会报告 cold_stage=0ms,只有这些记录才能告诉你到底是哪种情况。
这份细分数据是证据,不是装饰。这五个阶段没有一个会读取或发送仓库数据,因此备份越大,它们也不会随之增长。唯一会增长的部分是上传,而它是在停机结束之后才运行的。
renet 会在运行结束时打印同样的数字,这样你就能在自己的机器上实测,而不必只相信我们给出的数字:
Cold backup: <n> repositories quiesced, outage 222ms (cold_down=64ms cold_sync=26ms cold_verify=31ms cold_stage=0ms cold_up=99ms)
每个仓库的 JSON 记录也保存着同样的停机时间和各阶段数据,因此之后查阅的人无需靠猜测时间,就能分辨出一次快照是冷快照还是热快照。
什么时候选择冷快照
默认是热快照,对大多数仓库来说这也是正确的选择。热快照是崩溃一致的,相当于一次断电后仓库会处于的状态,而且完全不需要任何停机时间。大多数数据库和队列都能自行从这种状态恢复。
冷快照应该用于那些在写入过程中无法被安全捕获的数据。一个拥有自己的预写日志(write-ahead log)和内存内状态的数据库,就是最典型的例子。你是在用一段短暂的、可测量的停机时间,换取一个应用无需先执行恢复流程就能直接打开的快照。
一次冷运行会拒绝什么
拒绝正是这个功能的意义所在。一个号称”冷”但实际上什么都没有静止下来的备份,是一个要等到恢复时才会被发现的谎言,因此 renet 绝不会悄悄地把一次冷运行降级成热运行:
- 没有停止的容器。 停止操作之后,renet 会向仓库自己的 Docker socket 询问是否还有东西在运行。如果有,该仓库就会被拒绝,而不是被拍下快照。这项检查会朝安全的方向失败:如果无法连接 socket,或者无法读取容器列表,静止状态就会被视为”未确认”,而未确认就会被拒绝。
- 无法读取的许可证。 许可证检查是在停机之前进行的,而不是之后,因为一个许可证读不出来的仓库,原本就不可能上传任何内容。这样的仓库会被跳过,而不会被停止。如果所选的仓库中没有一个拥有可读的许可证,那么在任何一个容器被关闭之前,整次运行就会被拒绝。
- 同一个数据存储上的第二次冷运行。 锁覆盖的是整个数据存储,如果锁正被占用,第二次运行会立即被拒绝,不会停止任何东西。两次重叠的运行会各自停止自己认为归自己所有的容器,而第二次运行还会重启第一次运行仍在冻结中的仓库。跳过这次运行、等下一次再运行,要比那样好得多。
如果容器处于停止状态时运行被中断(比如 systemctl stop 或者重启),renet 会在退出之前把它们重新启动起来。机器一侧的恢复机制是最后一道防线:它会发现一个”主人失踪”的冷备份,并把这些仓库重新拉起来。
将备份推送到另一台机器
通过 SSH 将一个仓库复制到第二台机器:
rdc repo push my-app --to server-1
--to <machine> 会从你的配置中解析目标机器,--to-machine <machine> 则是明确指定同样的内容。存储名会被拒绝:那条路径已经废止。
加密镜像是以相同的 GUID 被复制的,因此这属于备份或迁移,而不是分支(fork)。如果需要一份独立的副本,请先执行 rdc repo fork,再推送这个分支。
第一次推送会传输整个镜像。此后每一次推送都只会针对两台机器上都保留的一个不可变基础镜像,发送发生变化的块,无需设置任何标志。如果你需要自行指定该基础镜像,可以使用 --delta-base <guid>。
被推送的副本会作为一个备份产物落在目标机器上,而不是一个正在运行的仓库。用 rdc backup restore 把它变成一个仓库:
rdc backup restore my-app@server-1 --as my-app --machine server-1 --up
如果需要按特定时间点做备份,请改用分块存储:rdc backup snapshot my-app 只上传发生变化的单元格,而 rdc backup restore my-app --at <snapshot> 可以将其中任意一个恢复回来。
| 选项 | 描述 |
|---|---|
<ref>(位置参数) | 要推送的仓库引用 |
--to <remote> | 目标机器或集群 |
--to-machine <machine> | 明确指定的目标机器 |
--provision <provider> | 如果目标机器不存在,通过此云提供商进行配置 |
--checkpoint | 推送前创建 CRIU 检查点(用于带有 rediacc.checkpoint=true 标签的容器)。目标会在 repo up 时自动恢复 |
--force | 覆盖已有的备份 |
--bwlimit <limit> | rsync 传输的带宽限制(例如 10M、500K) |
--delta-base <guid> | 只传输相对于该不可变基础 GUID 发生变化的块。省略则自动选择基础镜像 |
--strategy <strategy> | 使用增量基础时的块增量策略:auto、physical 或 shared |
--debug | 启用详细输出 |
--skip-router-restart | 操作后跳过路由服务器的重启 |
从另一台机器拉取备份
从保存着仓库的那台机器把它取回来:
rdc repo pull my-app --from server-1
添加 --up 可以在同一条命令中完成挂载和部署。若要改从分块存储恢复,请使用 rdc backup restore my-app --at <snapshot-id>。
Pull 会拒绝覆盖当前处于挂载状态的仓库。请先卸载,再执行 pull,然后用 rdc repo up 重新拉起。基于目录的仓库是例外:它们会在挂载状态下原地同步。
| 选项 | 描述 |
|---|---|
<ref>(位置参数) | 要拉取的仓库引用 |
--from <remote> | 源机器或集群 |
--from-machine <machine> | 明确指定的源机器 |
--force | 覆盖已有的本地备份 |
--up | 拉取后挂载并部署仓库 |
--bwlimit <limit> | rsync 传输的带宽限制(例如 10M、500K) |
--delta-base <guid> | 只接收相对于该不可变基础 GUID 发生变化的块 |
--strategy <strategy> | 使用增量基础时的块增量策略:auto、physical 或 shared |
--debug | 启用详细输出 |
--skip-router-restart | 操作后跳过路由服务器的重启 |
列出备份
列出分块存储中的快照:
rdc backup manifests my-app
每一行都是一个被保存下来的时间点:
| 列 | 含义 |
|---|---|
Repo | 从本地配置解析出的仓库名(不在配置中的仓库会回退显示 GUID) |
Snapshot | 快照 ID。这就是 rdc backup restore --at 所接受的值 |
Created | 拍摄快照的 UTC 时间 |
Total | 该快照所代表的仓库镜像大小 |
Added | 该快照相对于之前的快照,实际额外上传的字节数 |
Chunks | 它新增了多少个单元格 |
要查看某次 rdc repo push --to <machine> 在目标机器上留下了什么,可以询问那台机器它持有什么:
rdc repo list --machine server-1
被推送的副本会以它自己的名字出现。旁边如果有第二行显示一个原始的 GUID,那就是保留下来的增量基础(delta base),正是它让下一次推送到那台机器时能做增量传输,而不是完整传输。
rdc backup list --machine <machine> 读取的是定时运行写入的 hot/ 和 cold/ 文件夹,因此对于 push 留下的副本来说,这是个用错了地方的工具,它不会向你显示任何内容。
| 列 | 含义 |
|---|---|
Mode | hot 或 cold。这条记录所属的定时备份文件夹 |
Name | 从本地配置解析出的仓库名(不在配置中的仓库会回退显示 GUID) |
GUID | 磁盘上的仓库 GUID |
Size | 备份文件的可读大小 |
Modified | 该文件在机器上的 UTC 时间戳 |
保留策略
服务器会对分块存储强制执行保留策略,因此旧快照会被自动清理,无需手动删除任何内容。策略属于仓库的谱系:仓库及其 fork 共享同一份历史,在仓库名上设置的策略会覆盖整个家族。在谱系内部,每个备份流(某台机器上的某个仓库)也会单独受到保护,所以无论策略怎么写,保留机制都不会让某个流失去它最新的快照或当前的锚点。第二台机器或某个 fork 清理自己的历史时,也无法占用其他流的保底份额。
如果没有声明策略,则使用服务器默认值(套餐设置了默认值时使用套餐默认值),并保留每个流最新的快照。
# 当前生效的策略及其来源。
rdc backup retention my-app
# 下一次清理会删除什么,以及能释放多少空间。不会删除任何内容。
rdc backup retention preview my-app
# 保留一个滚动窗口:7 个每日、4 个每周、6 个每月。
rdc backup retention set my-app --keep-daily 7 --keep-weekly 4 --keep-monthly 6
# 只对一个备份流应用不同的策略。
rdc backup retention set my-app --stream <stream-id> --keep-last 3
# 移除已声明的策略。
rdc backup retention clear my-app
rdc backup retention clear my-app --stream <stream-id>
# 立即删除一个快照。只有该快照使用的数据会在下一次 GC 时释放。
rdc backup snapshots delete my-app <snapshot-id>
策略可以为其覆盖的仓库声明保留策略:rdc backup strategy set daily --retention last=7,daily=7,weekly=4,monthly=6(--retention none 可移除)。
| 选项 | 描述 |
|---|---|
--keep-last <n> | 保留最近的这么多个快照 |
--keep-hourly <n> | 在这么多个小时中,各保留每小时最新的一个快照 |
--keep-daily <n> | 在这么多天中,各保留每天最新的一个快照 |
--keep-weekly <n> | 在这么多周中,各保留每周最新的一个快照 |
--keep-monthly <n> | 在这么多个月中,各保留每月最新的一个快照 |
--keep-yearly <n> | 在这么多年中,各保留每年最新的一个快照 |
--keep-within <duration> | 保留距该备份流最新快照这段时间之内的所有快照,例如 24h;时间从最新快照起算而不是从当前时刻起算,因此已停止运行的备份流不会删除其窗口内的任何内容 |
--stream <id> | 把策略应用到一个备份流,而不是整个仓库的默认值 |
至少要给出一条规则。set 会替换所有参数而不是合并,因此每次都要传入完整的策略。不带规则的 set 不会被当作”什么都不保留”来处理,而是会被拒绝,因为清空策略是 clear 的职责。clear 会移除已声明的策略,改回套餐或服务器的默认设置;它既不表示”什么都不保留”,也不表示”全部保留”。
恢复
rdc backup restore 会把一份备份变成一个正在运行的仓库,两条路径用的都是同一个动词。区别在于你指向的是什么。
# 分块存储中的某个时间点。
rdc backup restore my-app --as my-app-yesterday --at <snapshot-id> --up
# push 留在某台机器上的一个产物。
rdc backup restore my-app@server-1 --as my-app --machine server-1 --up
--at 接受一个来自 rdc backup manifests 的快照 ID,或者一个 RFC 3339 格式的时间,例如 2026-08-14T12:00:00Z,它会被解析为该时刻或之前拍摄的最新快照。如果指定的时间之前没有任何快照,该请求会被拒绝,而不是向后舍入。
时间只会在该仓库于其源机器上的快照中解析。其他机器或同一谱系的 fork 写入的快照不在考虑范围内,除非用 --any-stream 有意扩大搜索范围。无法确定仓库自己的备份流时,恢复会被拒绝并要求使用 --any-stream,而不是猜测。
当有多个存储保存着该仓库时,恢复会读取最新快照通过了最近一次验证的那个存储,并在某个存储出现故障时转到下一个存储。--from <storeId> 只读取指定的那一个存储,不会回退到其他存储。参见备份目标。
用 --as 以新名称恢复不会覆盖任何东西,因此可以在一台正在运行的机器上安全地做恢复演练。恢复到一个已经存在的名称会被拒绝。
| 选项 | 描述 |
|---|---|
<artifact-ref>(位置参数) | 要恢复的对象。分块存储的快照用 repo,机器上的产物用 repo@place |
--as <name> | 恢复出的仓库的名称(默认使用产物本身的名称) |
-m, --machine <machine> | 要恢复到的机器 |
--datastore <name> | 恢复到这个具名数据存储,由与之关联的机器承载 |
--at <time> | 恢复某个时间点:快照 ID 或 RFC 3339 格式的时间 |
--from <storeId> | 从该备份存储读取快照。省略时读取持有最新已验证快照的存储,存储出现故障时转到下一个。使用 --from 时不会回退 |
--any-stream | 配合 --at,同时考虑其他机器和该谱系 fork 的快照 |
--up | 传输完成后部署恢复出的仓库 |
--allow-unopenable | 即使仓库口令无法打开镜像,也照常放置它(口令变更之前生成的快照) |
--salvage | 跳过丢失或损坏的分块继续恢复,并把对应的单元留作空洞。需要配合 --as |
--health-window <seconds> | 观察已部署仓库健康状况的时长 |
--health-timeout <seconds> | 等待其变为健康状态的时长 |
-y, --yes | 跳过确认 |
--debug | 启用详细输出 |
恢复一个仓库需要用到你配置中保存的 LUKS 凭据。如果你启用了 config storage,该凭据会随配置一起在新机器上恢复。如果没有启用,请把配置的副本保存在不会随该机器故障一起消失的地方。
恢复会在放置任何内容之前先验证口令。镜像组装完成、大小和 LUKS 头都核对无误后,会用配置中的口令试着打开它。能打开,恢复就报告成功;打不开,恢复就失败,且不会放置任何内容,而组装好的镜像会保留在暂存区,这样换用正确口令重试时不必重新下载。口令变更之前生成的快照只能用旧口令打开;--allow-unopenable 仍会放置这样的镜像,并说明它没有被打开。
在每台机器上验证恢复
一台从未完整走过来回流程的机器,无论其上传看起来多么顺利,都不能算是有备份。上传和恢复失败的原因是不同的,后一种失败只有在你真正尝试恢复时才会显现。
在依赖这些备份之前,请在每台机器上都执行一次以下流程:
- 做一个快照:
rdc backup snapshot my-app。 - 确认它已被记录:
rdc backup manifests my-app。 - 用一个一次性名称恢复它:
rdc backup restore my-app --as my-app-drill --at <snapshot-id>。 - 将恢复出的仓库与源仓库比对,然后用
rdc repo delete my-app-drill --yes删除这份演练副本。
整个流程完全不会触碰正在运行的仓库,因此即使在正承载流量的机器上执行也是安全的。如果你正在从一套更老的备份方案迁移过来,请让旧方案继续运行,直到这套流程在该机器上至少成功通过一次为止。两条备份路径要付出的是存储成本;一条未经验证的路径要付出的则是数据本身。
一次同步一个仓库
Push 和 pull 都作用于以引用(name、name:tag 或 name@machine)指定的单个仓库。不存在”一次处理所有仓库”这种形式:请针对每个仓库各运行一次命令。
同时指定分支和机器的引用,和普通名称的工作方式相同:
rdc repo push shop:nightly@server-1 --to server-2
rdc repo pull shop:nightly@server-1 --from server-2
完整的选项列表在将备份推送到另一台机器和从另一台机器拉取备份中。
验证与修复备份
上传成功的快照,并不等于能恢复的快照。每个快照都带有一个验证状态,下面这些检查会推动它前进。
验证阶梯
| 状态 | 由什么设置 | 证明了什么 |
|---|---|---|
unverified | 每个新快照 | 目前什么也没证明 |
verified | 运行后的抽查、--deep,或一次干净的 --store 检查 | 机器上的锚点或已存储的分块与其哈希一致。内部的文件系统不在评判范围内 |
proven | rdc backup check 或 --restore-test | 口令能打开真实内容 |
failed | 任何发现问题的检查 | 不可依赖 |
failed 的快照会一直保持失败,直到有一次读取同一数据的检查通过。除了保留最近若干份的数量之外,保留策略还会为每个未处于 failed 的流保留最新的 verified 快照和最新的 proven 快照,因此连续几晚的失败不会把所有好版本都挤掉。删除这两个快照中的任何一个都会被拒绝。
rdc backup verify my-app --deep
rdc backup verify my-app --store
rdc backup verify my-app --restore-test
--deep 会重新计算机器上每个单元的哈希。--store 让服务器重新计算每个已存储分块的哈希,并指出所有缺失或损坏的分块。--restore-test 直接从存储中把锚点对应的快照恢复到一个临时名称下,进行比对,记录结果,然后删除这份副本。这三个选项不能同时使用。
验证计划
rdc backup schedule 会在生成的单元中加入验证。快照服务以对随机单元的抽查收尾,失败的快照永远不会被标记为已验证。一个错开时间的每日定时器每次运行会对一个仓库做完整验证,并受 CPUQuota=100% 限制,按顺序轮流覆盖各个仓库:周期以夜为单位,取 7 与仓库数量中较大的那个。策略中可选的 verify 块通过 spotAfterRun、deepSchedule(一个 cron 表达式)和 off 来调节,其中 off 既不生成抽查,也不生成定时器。
定时单元按设计不保存口令,因此需要口令的两项检查,即 rdc backup check 和 --restore-test,要在配置所在的 CLI 中运行。前者每月一次、后者每季度一次是比较合理的节奏。
验证口令
rdc backup check my-app
rdc backup check 用口令打开最近一个快照的已存储清单,把其中一个文件恢复到临时目录,与清单中记录的大小比对,并记录 proven 或 failed。只有临时目录会被删除。--path <file> 用于指定文件,默认选择最小的非空文件。没有已存储清单的快照会被如实报告,并且不会成为 proven。
修复与抢救
rdc backup repair my-app --dry-run
rdc backup repair my-app
rdc backup restore my-app --at <snapshot-id> --as my-app-salvage --salvage
分块的键就是其字节的哈希,所以哈希与键不符的已存储对象永远无法满足一次恢复。rdc backup repair 让服务器重新读取每个受损对象,仅当它仍然有误时才删除,并在重新计算哈希后,从这台机器的锚点重新上传对应的单元。如果有备份正占用该谱系,它会拒绝运行;它会列出用到受损分块的快照,并把它们标记为 failed。机器锚点中没有的分块无法修复,此时命令以非零状态退出。--dry-run 不会改动任何内容。
--salvage 用于无法修复的快照。它只会恢复到用 --as 指定的新名称下,绝不覆盖已有仓库,会把每个损坏的单元写成空洞,按字节范围列出这些空洞,并以非零状态和状态值 restored-damaged 退出。LUKS 头内部出现空洞会使镜像无法打开,报告会如实说明。远离损坏单元的单个文件,仍可用 --path 干净地恢复。
清单密钥
快照的浏览清单用一个公钥加密封存,这样机器无需持有口令也能写入它。CLI 从仓库凭据派生出该密钥,并在部署计划时安装其公钥部分。如果机器上已经持有一个不同的密钥,系统会按仓库名称发出警告,且不会覆盖它。
rdc backup toc-key sync my-app --dry-run
rdc backup toc-key sync my-app --replace
--replace 会用派生出的密钥覆盖不同的旧密钥,并发送口令作为证明。如果某个仓库持有密钥,却既没有密钥文件也没有挂载点,就不会生成清单,单元日志会说明这一点。这样的快照仍可整体恢复;只有浏览和 rdc backup check 需要清单。
失败告警
失败的快照或验证会通过失败报告传到账户,超过宽限期仍不再上报的流同样会被标记。账户按订阅每天发送一封摘要邮件,取决于门户“通知”页面上的备份健康偏好,该偏好默认开启。rdc machine health 会把失败的验证显示为警告,并以非零状态退出。声明了目标的流如果到下一次运行的预期时间仍未上报,或最近三次运行都未达目标,会发出自己的告警,每个流每 6 小时最多一封,内容包括目标、已达成的数值和原因。检测延迟等于维护扫描的间隔,即每小时一次,因此告警可能在未达目标后最多一小时才到达。没有目标的流仍留在每日摘要中。
关键级备份
只能容忍丢失几分钟、而不是一天数据的仓库,需要声明一个保护目标。此后快照按较短的周期运行,每次都会上传发生变化的单元格,账户则负责监控这个目标。
声明目标
# 测量两次运行之间的变化量,然后查看预测和单元格大小建议。
rdc backup churn mail --samples 12 --interval 5m
# 为策略下的某个仓库设定 15 分钟目标。
rdc backup strategy set nightly-hot --repo-rpo mail=15m
# 或为策略覆盖的所有仓库设定同一个目标(至少 5m;none 表示清除)。
rdc backup strategy set nightly-hot --rpo 15m
目标是一个丢失窗口:即恢复所能找回的最后一次变更与故障之间的时间,其中包含上传所花的时间。即使快照本身成功,运行结束得比目标晚也算一次未达标。rdc machine health 会把实际达到的数值显示在目标旁边。设置目标时会根据变更量测量结果打印月度成本估算;尚无测量结果的仓库会被拒绝,直到运行过 rdc backup churn <repo>,或传入 --no-estimate。--dry-run 只显示改动而不写入。
每次运行只向存储询问自上一个快照以来发生变化的单元格,外加一份由 16 个未变单元格组成的滚动抽样,存储必须仍然持有它们。如果抽样中的某个单元格缺失,这次运行就会询问全部单元格,并上传丢失的部分。没有变化的仓库会记录一次 unchanged 运行,而不是新的快照。每次运行都有截止时间,因此挂起的运行会被终止并算作未达标,而不是悄悄让计时器停摆。
同一台机器上的仓库共用一个运行槽位,因此两个目标不会同时执行两次上传。
备份前钩子
仓库可以在冻结前后自行让应用进入静默状态,做法是在其 Rediaccfile 中定义两个可选函数。
backup_prepare() { docker exec db psql -c "CHECKPOINT"; }
backup_finish() { :; }
热备份运行时,先执行 backup_prepare,然后同步文件系统并做 reflink,最后总会执行 backup_finish,即使 prepare 失败也一样。哈希计算和上传要等 backup_finish 返回后才开始,所以上传期间应用不会被占住。每个函数的默认超时为 30 秒,最长 300 秒,超时的函数会连同它的整个进程组一起被杀死。钩子所持有的写入会在 backup_finish 返回时结束。如果 renet 自身被杀,钩子运行之前设下的定时器会在两倍超时再加 30 秒之内执行 backup_finish。经过钩子的快照记为 app-quiesced,没有经过的记为 crash-consistent。冷备份从不使用钩子,因为它自己会停止服务。
安全说明:钩子属于仓库代码。它在新构建的环境中运行,而不是备份单元自己的环境,因此看不到备份凭据。Docker 只能通过仓库的策略代理访问,相应限制照常生效。失败或超时的钩子会连同其结果(failed、timeout)被记录并上报;finish 超时会立即告警,因为应用此时可能仍处于静默状态。
单元格大小
镜像默认被切分成 4 MiB 的单元格。像邮件存储这类小而分散写入的仓库,用 1 MiB 时上传的字节要少得多;而大块、集中的写入用更小的单元格没有任何好处,只会让请求数成倍增加。rdc backup churn 会根据测得的写入模式推荐一个大小,--repo-cell-size mail=1M 则把它应用上去。更改单元格大小会让仓库重新播种:所有单元格都要重新上传,并且在保留策略清理掉旧链之前一直按活跃存储计费,位于旧网格上的分支也不再去重。计划运行绝不会自行改变网格。会把镜像切成超过 262,144 个单元格的大小会被拒绝,因为超过这个数量后清理会被推迟(1 MiB 时对应 256 GiB)。
延迟销毁
rdc backup immutability show
rdc backup immutability set 7
rdc backup undelete <snapshot-id>
设定 D 天的窗口(0 到 30)后,删除快照、清除仓库,以及让保留量变少的保留策略变更,都要等待 D 天才会生效,在此之前都可以撤销(rdc backup undelete、purge --cancel)。被删除的快照在等待期间仍可恢复。让保留量变多的变更立即生效,而缩短或关闭窗口本身则要等旧窗口走完。这些操作都会立即通知所有者和管理员。字节数据在窗口加上 7 天等待期之后才会清除,也就是请求发出后的 D + 7 天。
局限在此直说。这一机制由账户服务器强制执行,而不是由对象存储执行:它不是 WORM 存储,也没有使用任何存储桶锁或对象锁。它无法防范等到窗口结束的所有者或管理员,也无法防范存储本身的丢失,因为并没有第二个目标位置。修复会立即删除损坏的对象,因为重新哈希已经证明该对象是坏的,每次修复都会被记录并告警。合并清单链会改写历史,但不会删除任何可恢复的状态。以 retain-on-cancel 方式取消的订阅遵循它自己的 60 天清理周期。
活跃存储与等待存储
rdc backup usage 报告两个数字。Live 是保留下来的快照能够恢复的部分,只有它计入套餐配额。Waiting 是不再被任何保留快照引用、正在等待 7 天宽限期后删除的存储;它不计费,用量摘要会将其显示为等待删除。
等待存储并非没有上限。变动上限是套餐配额的两倍。超过上限后,距上次提交不足 60 分钟的流会被拒绝新的上传,直到等待存储被清空,机器会把这次运行记为 throttled,并算作未达标,原因注明为触及上限。每小时或更慢运行的流永远不会被拒绝。
未达标告警
带目标的流在错过下一次预期运行,或连续三次运行未达标时,会发出自己的告警,每个流每 6 小时最多一次,而不必等待每日摘要。告警会写明目标、实际达到的数值和原因。检测延迟等于维护扫描的间隔,即一小时,所以告警可能在未达标之后最长一小时才到达。延迟销毁下的破坏性请求会立即通知。
定时备份
Rediacc 使用具名的备份策略。每个策略定义一个时间表、备份模式、可选的带宽限制、仓库过滤条件和快照保留。把策略名绑定到机器上,以控制哪些备份在哪里运行。
备份模式
| 模式 | 行为 | 停机时间 |
|---|---|---|
hot | 服务持续运行的同时冻结仓库镜像(崩溃一致) | 无 |
cold | 服务停止、拍摄快照、服务重启、快照上传(应用一致) | 每个仓库的停止+启动时间窗口,各仓库之间并行进行。参见下方”估算冷备份停机时间”。 |
对能容忍崩溃一致快照的服务,使用 hot。当你需要有保证的一致性,并且能接受短暂重启时,使用 cold。
冷备份的语义
一次冷备份对每个被纳入的仓库分三个阶段执行:停止 → 快照 → 启动。了解这些保证的边界在哪里,能帮你及早发现部分性的失败。
冷备份能保证的事:
- 在拍摄快照之前,每个被纳入的仓库中所有正在运行的容器,都会通过其 Rediaccfile 的
down()钩子被优雅地停止,该仓库专属的 Docker 守护进程也会被静止。因此这份快照不仅是崩溃一致的,更是应用一致的。 - 快照前正在运行的容器 ID 集合会被持久化到位于
/var/run/rediacc/cold-backup-<guid>.running.json的一个 sidecar 文件中。这就是”完成后应该重新运行哪些容器”的权威依据。 - 快照之后,会调用该仓库 Rediaccfile 的
up()钩子,以恢复完整的 compose 技术栈。 - 位于
/var/run/rediacc/cold-backup-<guid>.status.json的每次运行状态 sidecar,会记录每次尝试的阶段、结果以及任何错误。
冷备份不保证的事:
up()是尽力而为的。它可能因为超出冷备份控制范围的原因而失败(例如一个仍在等待的depends_on: service_healthy条件、一处 compose 文件语法错误、拉取镜像时一次瞬时的网络故障)。失败发生时,冷备份会以 error 级别记录该错误,写入状态 sidecar,然后继续处理下一个仓库。- 当
up()失败时,会启动一个兜底的直接重启:系统会读取运行状态 sidecar,并通过 Docker API 直接重启每个记录在案的容器 ID(不经过 compose)。这样即便 compose 流程出了问题,也能让服务重新运行起来,只是不会重新执行任何 Rediaccfile 钩子。 - 如果连兜底方案对某些容器 ID 也失败了(比如 Docker 守护进程本身已经宕机),该 sidecar 会保留原地,以便路由 watchdog 在每个 tick 都能继续重试。
Watchdog 恢复机制: 在每个 tick,watchdog 都会检查是否存在一个运行状态 sidecar。其中列出的任何容器 ID,如果当前处于停止状态,都会被重启,无论该容器保存的 restart_policy 是什么。这意味着即便是配置了 restart: on-failure(Docker 在一次干净停止后本不会重启)的服务,在冷备份之后也会被重新拉起。一旦列出的所有容器都恢复运行,该 sidecar 就会被删除。
运维人员发现故障的方式:
rdc machine status <machine> --containers会显示运行状态,可与预期的容器集合比对。- 机器上的
/var/run/rediacc/cold-backup-<guid>.status.json,可以通过rdc term connect <repo> -c "cat /var/run/rediacc/cold-backup-$GUID.status.json"查看。success: false加上一个过期的startedAt,意味着上一次备份没有干净地完成。 - renet 备份运行的日志(
journalctl -u renet-*,或者直接调用rdc backup schedule)会输出一行形如Cold backup: post-snapshot restart summary total=N compose_ok=N fallback_ok=N failed=N failed_repos=[...]的最终汇总。一个非空的failed_repos就是你要 grep 的目标。
估算冷备份停机时间
每个仓库只在其自身的 down() + up() 窗口内处于停机状态。在一台已预热的主机上,这通常是:
| 仓库规模 | 典型的停止+启动时间 |
|---|---|
| 小型(1-2 个容器,无数据库) | 5-15 秒 |
| 中型(Web 应用 + 缓存) | 20-45 秒 |
| 重型(数据库 + 队列 + 邮件) | 60-120 秒 |
冻结这一步是对仓库镜像做一次写时复制(copy-on-write)reflink。它只是元数据操作,因此无论仓库是 1 GB 还是 100 GB,所需时间都一样,而在一次实测运行中甚至没有达到毫秒级分辨率。一个仓库不会因为其他仓库正在冻结而被拖着一直处于停止状态。上传随后会针对已冻结的副本进行,而这期间所有仓库都已经重新恢复运行。
整次运行的总墙钟时间取决于有多少仓库在同时重启。renet 会根据主机情况推导出这个值:
concurrency = min(repoCount, max(2, NumCPU/2), 8)
示例:
| 主机 | 仓库数 | 并发数 | 墙钟重启时间 |
|---|---|---|---|
| 4 核虚拟机 | 5 个仓库,平均每个 30 秒 | 2 | 约 75 秒 |
| 16 核服务器 | 10 个仓库,平均每个 40 秒 | 8 | 约 80 秒 |
| 64 核集群节点 | 50 个仓库,平均每个 40 秒 | 8 | 约 4 分钟 |
通过环境变量覆盖: 在备份服务的环境中设置 REDIACC_COLD_BACKUP_CONCURRENCY=N(通常通过一个 systemd drop-in 配置)可以固定一个具体值。=1 会强制严格串行重启,在调试某个仓库 up() 钩子中的崩溃循环问题时很有用。
如果你运行的是一个对延迟敏感的仓库(公开的 Web 应用、邮件服务),它的停机时间只受限于它自身的停止+启动耗时(通常 30-90 秒),而不是整次运行的总时长。仓库会按被发现的顺序被分配到并发槽位,不存在优先级队列。如果需要更精细的调度,可以给重型仓库单独设置一个以 --include 限定范围的策略。
长时间运行的备份与重叠的调度
一次耗时超过其自身调度间隔的冷备份(例如,一个 500 GB 仓库的首次播种,在一条普通带宽的线路上合理地需要超过 24 小时,而在此期间夜间定时器又再次触发)不会把第二次运行排队或启动。systemd 的 Type=oneshot 单元是单实例的:当定时器触发、而服务已经处于 activating 状态时,systemd 会把这次启动合并到已有的任务中。不会启动新进程,也不会把这次运行排到之后。
具体来说,一次从周一 03:00 UTC 开始、到周四中午才结束的运行:
| 日期 | 03:00 UTC 触发 | 结果 |
|---|---|---|
| 周一 | 第一次触发 | 运行开始 |
| 周二 | 第二次触发 | 静默丢弃(前一次运行仍处于活动状态) |
| 周三 | 第三次触发 | 静默丢弃(前一次运行仍处于活动状态) |
| 周四 | 运行在中午结束 | 不会补跑;下一次运行是周五 03:00 UTC |
定时器的 Persistent=true 指令不会挽救这些被跳过的触发。Persistent=true 重放的是因为定时器本身处于非活动状态(系统关机、定时器被禁用)而错过的触发。因服务繁忙而被丢弃的触发则会彻底消失。
这个默认行为是刻意为之的。如果对同一个数据存储并行运行两次冷备份,会在冻结路径、上传过程,以及 /var/run/rediacc/cold-backup-<guid>.status.json 下每个仓库的 sidecar 上产生冲突。排在一个正在运行的实例后面等待,要好过从两个方向同时冲击同一份数据。数据存储锁强制执行了这一点:第二次冷运行发现锁被占用后,会立即被拒绝,不会停止任何东西。
对监控的影响。 一次挂起卡住的备份(例如,一次卡在网络黑洞中的上传)会静默丢弃之后所有的定时器触发。调度器不会发出任何警报。请关注 systemctl show <unit> -p ActiveEnterTimestamp:如果服务处于 activating 状态的时间超过了预期的运行时长(例如,对于一个夜间定时器超过了 48 小时),就应该去调查一下。
如果你需要每一次计划中的触发都被执行,请把定时器从 OnCalendar=<cron> 切换为 OnUnitInactiveSec=<间隔>。它会在上一次运行结束 N 小时之后触发,而不是按固定的墙钟时间表触发,因此长时间运行不会导致触发被丢弃,只会把下一次运行往后推。代价是调度会发生漂移:原本 03:00 的夜间任务会变成”上一次结束后 24 小时”。
快照、中断与存储池空间
每一次 push 都是基于一个瞬时的数据存储快照来工作的,因此即使仓库还在持续写入,上传的数据依然是一致的。在备份运行期间,该快照会持续引用它与在线仓库共享的每一个数据块:因此在这个周期结束、快照被删除之前,删除操作和 trim 释放出的存储池空间会变少。存储健康报告会显示备份快照当前占用了多少空间。
中断是安全的。停止服务(或重启机器)会让备份中止其传输,并在退出前删除自己的快照;下一次计划运行会从中断的地方继续,因为已经存储过的单元格不会被重复上传。如果进程被强制终止得过于粗暴,来不及清理(比如断电),孤立的快照会在几分钟内被存储维护进程自动检测并移除。
定义一个策略
默认配置是两种策略的组合:一个覆盖所有仓库的、快速的每小时热流,以及一个通过静止容器来获取应用一致快照的、较慢的每周冷流。两者都写入同一个分块存储,共享的数据块只会保存一份,而不是按流各存一份。
rdc backup strategy set hourly-hot \
--destination hosted \
--cron "0 * * * *" \
--mode hot \
--bwlimit 20M \
--enable
rdc backup strategy set weekly-cold \
--destination hosted \
--cron "15 3 * * 0" \
--mode cold \
--include shop,mail \
--enable
--destination <name> 用来给策略内部的目标命名;这是每个策略各自选择的标签,目标始终是由服务托管的分块存储。--include 接受以逗号分隔的待备份仓库列表(--include shop,mail)。省略它时,该策略会覆盖数据存储上的每一个仓库。只写名称会覆盖该仓库及其所有 fork;name:tag 只覆盖一个 fork。保存策略时会拒绝未知名称,因此拼写错误不会排出一个什么都不备份的计划。
--exclude 使用同样的逗号分隔形式,并跳过所列仓库。--include 与 --exclude 互斥:设置其中一个会清除另一个,值 none 会清除过滤条件。
| 选项 | 描述 |
|---|---|
<strategy>(位置参数) | 策略名(用于绑定机器) |
--destination <name> | 策略内部的目标名称。始终是由服务托管的分块存储 |
--cron <expression> | cron 表达式(例如 "0 2 * * *" 表示每天凌晨 2 点) |
--mode <hot|cold> | 备份模式 |
--bwlimit <limit> | 上传的带宽限制(例如 10M) |
--read-bwlimit <limit> | 快照从磁盘读取镜像的速度上限(例如 50M,0 = 不限速)。none 表示清除 |
--include <repos> | 此策略覆盖的仓库(逗号分隔) |
--exclude <repos> | 要跳过的仓库(逗号分隔) |
--retention <spec> | 快照保留,例如 last=7,daily=7,weekly=4,monthly=6。none 表示移除 |
--enable / --disable | 启用或禁用该策略 |
查看策略
rdc backup strategy list
rdc backup strategy show weekly-cold
移除一个策略
rdc backup strategy remove weekly-cold
将策略绑定到机器
一个没有绑定到任何机器的策略永远不会被部署。将一个或多个策略绑定到机器:
rdc backup strategy bind hourly-hot --machine hostinger
rdc backup strategy bind weekly-cold --machine hostinger
rdc backup strategy unbind weekly-cold --machine hostinger
绑定关系会作为机器上的一个列表被记录在你的配置中,rdc backup schedule 会读取它来决定要部署哪些单元:
{
"machines": {
"hostinger": {
"backupStrategies": ["hourly-hot", "weekly-cold"]
}
}
}
绑定只存在于本地配置中。 定义一个策略并把它绑定到某台机器,并不会对那台机器做任何操作。要部署 systemd 定时器,请运行
rdc backup schedule -m <machine>(参见将调度部署到机器),并在每次修改策略或绑定关系之后重新运行它。
选择热还是冷,以及按仓库过滤
热与冷一览
| 热 | 冷 | |
|---|---|---|
| 一致性 | 崩溃一致(运行中冻结镜像) | 应用一致(停止 → 冻结 → 启动) |
| 停机时间 | 无 | 每个仓库的停止+启动时间窗口(通常 5-120 秒) |
| 适用频率 | 高(例如每小时) | 低(例如每天或每周) |
| 典型用途 | 高频的安全网 | 计划中的、有一致性保证的备份 |
热是高频运行的正确默认选择。在拍摄快照期间服务持续运行,因此对你的应用来说完全没有停机时间。快照是崩溃一致的:相当于一次非正常关机之后你会得到的状态。对大多数现代数据库和消息队列来说,这已经足够了。
冷适用于你需要有保证的应用一致快照,并且能接受每个仓库短暂重启的场景。服务会在快照之前停止,并在上传开始之前重启,因此一次缓慢或失败的上传永远不会拖长停机窗口。完整的保证模型请参见冷备份的语义。
两种模式都写入同一个分块存储。模式决定的是镜像被冻结期间如何对待仓库,而不是数据落在哪里。一个同时被每小时热调度和每周冷调度覆盖的仓库,共享的单元格只会保存一份,而不是两份。
按策略确定仓库范围
不带 --include 的策略会覆盖数据存储上的每一个仓库。--include 会把它缩小到以逗号分隔列出的仓库,并与本地配置中的仓库名进行匹配。
# 热策略:每小时备份所有内容
rdc backup strategy set hourly-hot \
--destination hosted \
--cron "0 * * * *" \
--mode hot \
--bwlimit 6M \
--enable
# 冷策略:每周,只针对需要静止的仓库
rdc backup strategy set weekly-cold \
--destination hosted \
--cron "15 3 * * 0" \
--mode cold \
--include shop,mail \
--enable
什么时候应该把某个仓库排除在高频热策略之外
在以下情况下,应该指名你想纳入高频运行的仓库,而不是让它接纳一切:
- 一个仓库体积很大,并且能从卷上已有的源数据完全重新生成,以至于每次每小时的备份都在消耗带宽,却没有带来实质的恢复价值。
- 按可用的上传速度计算,该次备份运行会超出它自身的调度间隔。
示例。 一个 analytics-demo 仓库保存着约 114 GB 派生自 Postgres 的表,这些表可以从保存在同一个卷内的原始 CSV 转储重建出来。在 6 MB/s 的上传限速下,该仓库的第一次快照就需要超过 5 小时。如果每小时运行一次,就意味着下一次触发到来时上一次运行还没结束,因此之后每一次触发都会被静默丢弃(参见长时间运行的备份与重叠的调度)。把其他仓库列在 hourly-hot 中、把 analytics-demo 留给 weekly-cold,就意味着它每周会被备份一次,而不是完全没有备份。
如果数据是纯粹可再生的,不妨考虑一下是否真的需要备份它。一种替代方案是只备份原始的源输入(在这个例子中就是 CSV 转储),完全跳过派生出来的副本。对源输入做每周一次的冷备份体积要小得多,而且完全足以支撑恢复。
一个同时被两种策略覆盖的仓库,会同时获得每小时的崩溃一致快照和每周的应用一致快照。rdc backup manifests <repo> 会把它们一起显示出来,共享的单元格只会保存一份。
备份操作
将调度部署到机器
将已绑定的策略以 systemd 定时器的形式推送到某台机器:
rdc backup schedule -m server-1
rdc backup schedule -m server-1 --dry-run
部署是一个状态协调器。它会读取机器上当前的单元文件和 systemd 状态,与配置本应生成的内容进行比对(逐文件计算 SHA-256),然后只触碰内容确实发生了变化的单元。在配置没有变化的情况下重新运行是一次空操作:不写入任何内容,不执行 daemon-reload,不产生任何定时器扰动。
--dry-run 会打印每个策略的计划(created、updated (service, timer, env)、unchanged、removed),而不会触碰机器。结合 --debug 使用还会打印生成的单元内容(凭据部分会被隐去)。分块存储单元本来就不携带任何凭据:机器用自己已签名的仓库许可证进行身份验证,服务器再返回一个短期有效的许可,因此单元文件中不会写入任何敏感信息。
如果你即将更新或移除的某个策略当前正有备份在运行,部署会立即失败,并提示你取消该运行或传入 --force。使用 --force 时,正在运行的那次调用会保留其内存中的单元,新配置会在下一次定时器 tick 时生效,因此正在运行的备份永远不会被强制终止。
--reset-failed 是可选启用的。传入该参数时,它会在部署成功后清除被触碰服务的 systemd failed 状态。默认关闭,这样之前的失败信号会继续在告警中保持可见。
立即运行一次备份
无需等待定时器,立即触发一次备份。即使还没有部署任何定时器也能工作,它使用 systemd-run 进行临时执行:
rdc backup run -m server-1
rdc backup run weekly-cold -m server-1
查看备份状态
显示备份定时器的当前状态以及最近几次任务的结果:
rdc backup status -m server-1
rdc backup status hourly-hot -m server-1
取消一次正在运行的备份
rdc backup cancel -m server-1
rdc backup cancel weekly-cold -m server-1
仓库迁移
将一个仓库从一台机器移动到另一台机器:
rdc repo migrate my-app@server-1 --to server-2
| 选项 | 描述 |
|---|---|
<ref>(位置参数) | 要迁移的仓库引用;其中的 @machine 指明源机器 |
--to <place> | 目标机器或集群 |
--provision <provider> | 通过此云提供商自动配置目标机器(例如 hetzner、linode) |
--checkpoint | 迁移前创建 CRIU 检查点,以便进程内存也一并迁移 |
--delta-base <guid> | 用于切换阶段增量的不可变基础 GUID。默认使用第一阶段的基础 |
--strategy <strategy> | 切换阶段所用的块增量策略:auto、physical 或 shared |
--skip-dns | 迁移后跳过 DNS 记录更新 |
--keep-source | 迁移成功后保留源镜像 |
--bwlimit <limit> | 传输的带宽限制(例如 50M) |
迁移会分两个阶段通过 rsync 传输加密的仓库数据:先是在仓库继续运行时进行一次批量传输,然后再短暂停止以完成增量部分。迁移会移动仓库,因此一旦迁移成功,源镜像就会被删除。传入 --keep-source 可以保留它们。这就是 repo migrate 和 repo push 的区别:push 会让源仓库继续运行,不做任何改动。
最佳实践
- 为关键数据的应用一致副本安排每日冷快照
- 对需要零停机的高频运行使用热快照
- 定期测试恢复。
rdc backup restore --as <new-name>不会覆盖任何东西,因此在正在运行的机器上做演练是安全的 - 设置保留策略,而不是手动清理,这样你保留的时间窗口就是明文记录下来的
- 如果希望在你自己掌控的硬件上留一份副本,除了快照之外还应保留一份机器到机器的副本
- 妥善保管凭据;备份是加密的,但恢复时仍需要 LUKS 凭据