obcommunity/open-balena-delta

Open Balena增量更新服务器

这是https://github.com/balena-io/open-balena%EF%BC%88%E7%94%A8%E4%BA%8E%E9%83%A8%E7%BD%B2%E5%92%8C%E7%AE%A1%E7%90%86%E8%81%94%E7%BD%91%E8%AE%BE%E5%A4%87%E7%9A%84%E5%B9%B3%E5%8F%B0%EF%BC%89%E7%9A%84%E5%BC%80%E6%BA%90%E5%A2%9E%E9%87%8F%E6%9B%B4%E6%96%B0%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E6%97%A8%E5%9C%A8%E4%BC%98%E5%8C%96%E8%AE%BE%E5%A4%87%E9%95%9C%E5%83%8F%E6%9B%B4%E6%96%B0%E6%B5%81%E7%A8%8B%E3%80%82

核心功能

• 增量镜像更新：通过balena-engine（v3）或rsync（v2）对镜像进行二进制比较，仅下载设备已安装镜像的变更数据，显著降低流量消耗。
• 兼容open-balena生态：依赖open-balena-registry组件，可无缝集成到现有open-balena环境中。

使用场景

适用于基于open-balena管理的物联网设备场景，尤其是网络带宽有限、设备存储资源紧张或需要频繁更新的场景，能有效降低更新成本和时间。

配置说明

环境变量

需配置以下环境变量：

• BALENA_TLD：open-balena基础主机名（如openbalena.yourdomain.com）
• REGISTRY_HOST：open-balena-registry主机名（如registry.openbalena.yourdomain.com）
• DOCKER_HOST：通常设为"unix:///var/run/docker.sock"
• DOCKER_BUILDKIT：通常设为"0"
• TOKEN_AUTH_BUILDER_TOKEN：open-balena安装时生成的主构建器令牌

卷挂载

需挂载以下卷：

• /var/lib/balena-engine：支持容器内overlay2文件系统
• /delta-rsync：存储rsync增量文件（v2模式需用）

主机名与证书

• 主机名：需设置delta.<yourdomain.com>指向open-balena-haproxy实例
• 认证证书：若启用设备认证，需将open-balena-api公钥证书放置在容器/certs/private/api.<BALENA_TLD>.pem路径

集成步骤

1. 修改open-balena-api：添加DELTA_HOST环境变量（如delta.openbalena.yourdomain.com）
2. 设备/舰队配置：设置BALENA_SUPERVISOR_DELTA=1和BALENA_SUPERVISOR_DELTA_VERSION（3为balena-engine模式，2为rsync模式）
3. 设备config.json：添加deltaEndpoint参数指向delta服务主机名

部署示例（Docker Run）

bash
docker run -d \
  --name open-balena-delta \
  -e BALENA_TLD="openbalena.yourdomain.com" \
  -e REGISTRY_HOST="registry.openbalena.yourdomain.com" \
  -e DOCKER_HOST="unix:///var/run/docker.sock" \
  -e DOCKER_BUILDKIT="0" \
  -e TOKEN_AUTH_BUILDER_TOKEN="your-builder-token" \
  -v /var/lib/balena-engine:/var/lib/balena-engine \
  -v ./delta-rsync:/delta-rsync \
  -v ./api-cert.pem:/certs/private/api.openbalena.yourdomain.com.pem \
  docker.xuanyuan.run/obcommunity/open-balena-delta

限制与已知问题

• 基础镜像标签变更时，增量更新可能失效，建议固定基础镜像哈希
• rsync下载端点暂未内置认证机制，需额外配置

Credits

感谢balena团队开发https://github.com/balena-os/balena-engine%EF%BC%8C%E4%B8%BA%E5%B5%8C%E5%85%A5%E5%BC%8F%E7%89%A9%E8%81%94%E7%BD%91%E5%9C%BA%E6%99%AF%E6%8F%90%E4%BE%9B%E4%BC%98%E5%8C%96%E7%9A%84%E5%AE%B9%E5%99%A8%E5%B7%A5%E5%85%B7%E3%80%82