balenalib/armv7hf Docker 镜像 - 轩辕镜像

balenalib物联网设备基础镜像

镜像概述和主要用途

该镜像属于balena.io物联网设备基础镜像系列，专为物联网场景设计。它针对balena.io平台和balenaOS进行了优化，同时也可在任何适当架构的Docker环境中运行。作为基础镜像，它提供了精简高效的运行时环境和实用工具，适用于构建物联网设备应用。

!balenalogo

核心功能和特性

1. 便捷的包管理工具

提供名为install_packages的包安装脚本，抽象了底层包管理器的细节。该脚本具有以下特点：

• 安装指定包时仅包含最小依赖（忽略可选依赖）
• 自动清理包管理器元数据
• 安装失败时自动重试

2. 动态设备支持

每个balenalib基础镜像默认ENTRYPOINT为ENTRYPOINT ["/usr/bin/entry.sh"]，实现动态设备支持：

• 检查UDEV环境变量是否设置为true（通过ENV UDEV=1配置）
• 若UDEV为true，启动udevd守护进程，使容器内/dev目录中显示相关设备节点

更多特性详情，请查看特性概述文档。

镜像变体

balenalib镜像提供多种变体，适用于不同使用场景：

:<version> 或 :<version>-run

这是默认镜像。run变体设计为精简的最小变体，仅包含运行时必需组件。

:<version>-build

构建变体是包含多种源码构建工具的较完整镜像，减少了Dockerfile中需手动安装的包数量，从而减小系统中所有镜像的总体积。

了解更多变体信息

支持的版本及对应Dockerfile链接

bullseye (latest)、bookworm、buster、sid

有关该镜像及其历史的更多信息，请查看balena-io-library/official-images GitHub仓库中的相关清单文件（armv7hf-debian）。

使用方法和配置说明

在应用项目中创建Dockerfile

dockerfile
FROM balenalib/armv7hf-debian:latest
# 在此处添加你的应用代码

构建并运行Docker镜像：

console
$ docker build -t my-app .
$ docker run -it --rm --name my-running-app my-app

用户反馈

问题反馈

如在使用该镜像时遇到问题或有疑问，请通过GitHub issue与我们联系。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们始终乐于接收拉取请求，并会尽快处理。在开始编码前，建议通过GitHub issue讨论你的计划，尤其是较复杂的贡献，这能让其他贡献者为你提供指导、反馈设计，并避免重复工作。

文档资源

该镜像的文档存储在基础镜像文档中。你还可以在这篇博客文章中找到balenalib基础镜像新功能的更多详情。