obcommunity/open-balena-builder

open-balena 构建服务器

这是一个开源构建服务器，用于https://github.com/balena-io/open-balena%E2%80%94%E2%80%94%E4%B8%80%E4%B8%AA%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%E3%80%82

核心功能

• 支持远程Docker服务器构建，提升性能
• 兼容AMD/ARM架构原生构建，进一步优化效率
• 集成open-balena-delta，构建时生成增量镜像，加快设备更新速度

兼容性

• 依赖open-balena的open-balena-api和open-balena-registry组件
• 兼容open-balena-delta以实现增量更新

使用场景

适用于物联网设备批量部署、多架构设备管理、需要快速更新的场景，帮助用户通过远程构建简化openbalena平台的设备运维流程。

配置说明

环境变量

需设置以下关键环境变量：

• BALENA_TLD: open-balena基础域名（如openbalena.yourdomain.com）
• API_HOST: open-balena-api域名（如api.openbalena.yourdomain.com）
• DELTA_HOST: open-balena-delta域名（可选，省略则不生成增量更新）
• DOCKER_HOST_AMD64/ARM64: 对应架构Docker服务器地址（格式：tcp://<主机名/IP>:2375，至少需提供一个）
• DOCKER_BUILDKIT: 建议设置为"0"
• TOKEN_AUTH_BUILDER_TOKEN: open-balena安装时生成的主构建器令牌

主机名配置

需映射构建服务器主机名到open-balena的haproxy实例：builder.<yourdomain.com>

增量更新启用

参考https://github.com/dcaputo-harmoni/open-balena-delta%E7%9A%84%E9%85%8D%E7%BD%AE%E6%8C%87%E5%8D%97%E5%90%AF%E7%94%A8%E5%A2%9E%E9%87%8F%E6%9B%B4%E6%96%B0%E3%80%82

部署示例（Docker Compose片段）

yaml
services:
  open-balena-builder:
    image: obcommunity/open-balena-builder
    environment:
      BALENA_TLD: "openbalena.yourdomain.com"
      API_HOST: "api.openbalena.yourdomain.com"
      DELTA_HOST: "delta.openbalena.yourdomain.com"
      DOCKER_HOST_AMD64: "tcp://amd64-docker:2375"
      DOCKER_HOST_ARM64: "tcp://arm64-docker:2375"
      DOCKER_BUILDKIT: "0"
      TOKEN_AUTH_BUILDER_TOKEN: "your-builder-token"
    ports:
      - "8080:8080"
    restart: always

使用方法

安装完成后，通过balena-cli执行balena push <舰队名称>即可触发远程构建与部署。

限制与已知问题

• 存在未覆盖的边缘案例，需进一步测试验证。

致谢

感谢Balena团队开发的https://github.com/balena-io/balena-cli%E4%B8%BA%E6%9C%AC%E9%A1%B9%E7%9B%AE%E6%8F%90%E4%BE%9B%E5%9F%BA%E7%A1%80%E6%94%AF%E6%8C%81%E3%80%82