obcommunity/open-balena-helper

Open Balena辅助工具

本镜像为https://github.com/balena-io/open-balena%E7%9A%84%E5%BC%80%E6%BA%90%E8%BE%85%E5%8A%A9%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E8%A1%A5%E5%85%85open-balena-api%E6%9C%AA%E5%8C%85%E5%90%AB%E7%9A%84%E5%8A%9F%E8%83%BD%E7%AB%AF%E7%82%B9%EF%BC%8C%E5%B8%AE%E5%8A%A9%E6%9E%84%E5%BB%BA%E5%AE%8C%E6%95%B4%E7%9A%84open-balena%E8%AE%BE%E5%A4%87%E7%AE%A1%E7%90%86%E8%83%BD%E5%8A%9B%E3%80%82

核心功能

• 提供/v6/supervisor_release端点：根据设备架构返回正确的supervisor版本，支持设备通过update-balena-supervisor服务自动更新supervisor。
• 提供/download端点：允许下载通过balena-yocto-scripts构建的OS镜像。

使用场景

• 设备自动更新supervisor，保障设备管理功能的兼容性。
• 通过balena-cli下载自定义OS镜像（如执行balena os download <设备类型> -o ./os-image.img）。

配置说明

环境变量

需配置以下环境变量：

• API_HOST：open-balena-api的主机名（例：api.openbalena.yourdomain.com）
• IMAGE_STORAGE_ENDPOINT：open-balena-s3的主机名（例：s3.openbalena.yourdomain.com）
• IMAGE_STORAGE_BUCKET：存储OS镜像的S3桶名（例：image-data）
• IMAGE_STORAGE_PREFIX：桶内OS镜像的存储前缀（例：images）
• IMAGE_STORAGE_ACCESS_KEY：open-balena-s3的访问密钥
• IMAGE_STORAGE_SECRET_KEY：open-balena-s3的秘密密钥
• IMAGE_STORAGE_FORCE_PATH_STYLE：建议设为true

代理配置

需更新HAProxy实例，将以下URL重定向到本镜像容器：

• api.openbalena.yourdomain.com/v6/supervisor_release
• api.openbalena.yourdomain.com/download

Docker部署示例

bash
docker run -d \
  --name open-balena-helper \
  -e API_HOST=api.openbalena.yourdomain.com \
  -e IMAGE_STORAGE_ENDPOINT=s3.openbalena.yourdomain.com \
  -e IMAGE_STORAGE_BUCKET=image-data \
  -e IMAGE_STORAGE_PREFIX=images \
  -e IMAGE_STORAGE_ACCESS_KEY=your-access-key \
  -e IMAGE_STORAGE_SECRET_KEY=your-secret-key \
  -e IMAGE_STORAGE_FORCE_PATH_STYLE=true \
  obcommunity/open-balena-helper

兼容性

兼容open-balena，依赖open-balena-api和open-balena-s3组件。

限制与已知问题

• 需更多测试覆盖边缘场景，可能存在未发现的问题。

致谢

感谢Balena团队开发open-balena-api和balena-cli，为设备管理提供基础框架。 ===FULL_DESC===