嵌入式 Linux 与 RTOS / 系统课时
用 RAUC 实现 A/B 升级
用 RAUC 实现 A/B 升级
A/B 升级的目标不是“把新镜像写进去”,而是让设备在升级中断、镜像损坏或新版本启动失败时仍能回到可用系统。本篇用 RAUC 串起双槽 rootfs、bundle、U-Boot bootchooser 与启动确认,完成可恢复的远程升级闭环。
学习目标
- 配置 RAUC 的 A/B 根文件系统槽位与 bundle 兼容标识。
- 完成“写入备用槽 → 激活 → 重启 → 标记成功”的升级流程。
- 设计掉电和新版本启动失败时由 bootchooser 自动回退的路径。
先把 A/B 槽位关系固定下来
典型设备保留两个可启动根文件系统:当前运行槽不参与本次写入,升级始终写入另一个槽。RAUC 负责验证 bundle、选择目标槽、写入镜像并更新槽位状态;bootloader 则负责决定下次究竟从哪个槽启动。

RAUC 的槽位配置通常放在 /etc/rauc/system.conf。下面示例使用两个 ext4 根文件系统,并配置用于验证升级包签名的 keyring;设备节点和证书路径必须按实际产品调整。
[system]
compatible=my-product-v1
bootloader=uboot
keyring=/etc/rauc/keyring.pem
statusfile=/data/rauc.status
[slot.rootfs.0]
device=/dev/mmcblk0p2
type=ext4
bootname=A
[slot.rootfs.1]
device=/dev/mmcblk0p3
type=ext4
bootname=B这是配置文件,不会直接产生控制台输出。生效后可执行 rauc status,确认两个槽位都被识别,并且其中一个是当前启动槽。
rauc status预期输出
<RAUC 状态中可看到 compatible 为 my-product-v1、rootfs.0、rootfs.1,以及当前 booted 槽>实际状态文本会随 RAUC 版本和当前槽位不同。若槽位缺失,应先检查设备节点、bootname 和 U-Boot 环境映射,不能继续写入升级镜像。
配置 bundle 与 bootchooser
bundle 的 compatible 必须与设备配置完全一致,否则 RAUC 会拒绝安装。下面的 manifest.raucm 假设构建系统已经生成 rootfs.ext4,发布流水线再使用受保护的签名私钥生成 RAUC bundle。
[update]
compatible=my-product-v1
version=2.0.0
[image.rootfs]
filename=rootfs.ext4这是 bundle 描述文件,不会自行执行。生成 bundle 后应检查其签名、兼容标识以及 rootfs 镜像条目;生产私钥只保留在受控的发布环境中,目标设备只保存用于验证的证书或公钥材料。
RAUC 的 U-Boot 后端通常配合 BOOT_ORDER 和每个槽位的剩余尝试次数工作。下面是初始化环境变量的片段示例,前提是 U-Boot 启动脚本已经实现对应 bootchooser 逻辑,并且 Linux 侧 fw_env.config 能正确访问 U-Boot 环境区。
fw_setenv BOOT_ORDER "A B"
fw_setenv BOOT_A_LEFT 3
fw_setenv BOOT_B_LEFT 3
fw_printenv BOOT_ORDER BOOT_A_LEFT BOOT_B_LEFT预期输出
BOOT_ORDER=A B
BOOT_A_LEFT=3
BOOT_B_LEFT=3新槽被激活后,只获得有限的试启动次数。启动脚本必须实际读取并递减这些计数;如果只是保存变量却从不参与启动选择,就不存在真正的自动回退。
安装、激活并确认新版本
设备收到 bundle 后直接交给 RAUC 安装,RAUC 会避开当前正在运行的槽。<PATH> 替换为设备上升级包的实际目录。
rauc install <PATH>/update-bundle.raucb预期输出
<签名验证通过,inactive rootfs 槽写入完成,安装命令成功结束>安装成功后重启设备。新系统不要一进入用户空间就立即确认成功,应先检查根文件系统、关键服务、网络和核心业务是否达到最低可用条件,再标记当前槽为 good。
rauc status mark-good
rauc status预期输出
<当前 booted 槽被标记为 good,并保持为后续优先启动槽>如果系统在 mark-good 前持续复位,bootchooser 应消耗该槽的剩余尝试次数;计数耗尽后,下次启动改选仍然有效的旧槽。
验证升级中断与启动失败
量产测试至少要覆盖两个故障点。第一类是在写备用槽期间断电:当前槽不能受损,重新上电后仍应进入旧系统,并允许再次下载安装。第二类是备用槽写完但 Kernel、rootfs 或关键服务无法正常启动:bootloader 应在有限次数失败后自动回旧槽。
真正可量产的验收标准不是“成功升级一次”,而是在写入、切槽、首次启动等关键阶段发生掉电或软件故障后,设备仍能进入至少一个已知可用槽,并继续具备接收下一次升级的能力。