balenalib/imx7-var-som

balenalib/imx7-var-som-debian 镜像文档

镜像概述

本镜像属于balena.io IoT设备基础镜像系列，专为物联网设备优化设计。该镜像针对balena.io平台和balenaOS进行了深度优化，同时也可在任何运行于合适架构的Docker环境中使用。

!balenalogo

核心功能与特性

1. 便捷的包安装工具

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

• 以最小依赖方式安装指定包（忽略可选依赖）
• 自动清理包管理器元数据
• 安装失败时支持重试机制

2. 动态设备支持

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

• 检查UDEV环境变量是否设置为true（通过ENV UDEV=1配置）
• 当UDEV=1时，自动启动udevd守护进程，使动态插入的设备节点在容器/dev目录下可见

更多特性详情请参见https://www.balena.io/docs/reference/base-images/base-images/#features-overview%E3%80%82

镜像变体

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

:<version> 或 :<version>-run

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

:<version>-build

构建专用变体，包含大量源码构建所需工具，减少Dockerfile中手动安装包的需求，从而降低系统中所有镜像的总体积。

更多关于运行时与构建变体的区别，请参见https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

使用场景与适用范围

• IoT设备应用开发与部署
• 基于balena平台的项目开发
• 需要精简运行时环境的嵌入式系统
• 需从源码构建应用的开发场景

如何与Balena平台配合使用

• https://www.balena.io/docs/learn/getting-started/imx7-var-som/nodejs/?ref=dockerhub%E5%8F%AF%E5%B8%AE%E5%8A%A9%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B%E4%BD%BF%E7%94%A8%E6%AD%A4%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F
• https://www.balena.io/docs/learn/getting-started/imx7-var-som/nodejs/#example-projects?ref=dockerhub%E5%B1%95%E7%A4%BA%E4%BA%86%E5%9F%BA%E4%BA%8Ebalena%E5%B9%B3%E5%8F%B0%E7%9A%84%E5%AE%9E%E9%99%85%E5%BA%94%E7%94%A8%E6%A1%88%E4%BE%8B

详细使用方法

创建应用项目的Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/imx7-var-som-debian:latest
# 在此处添加你的应用代码

构建并运行Docker镜像

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

支持版本及Dockerfile链接

• bullseye (latest)、bookworm、buster、sid
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/imx7-var-som/debian/

镜像历史及更多信息可查看https://github.com/balena-io-library/official-images/blob/master/library/imx7-var-som-debian%EF%BC%88%60imx7-var-som-debian%60%EF%BC%89%E3%80%82

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC%E3%80%82

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励在编码前通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E4%BB%A5%E4%BE%BF%E5%85%B6%E4%BB%96%E8%B4%A1%E7%8C%AE%E8%80%85%E6%8F%90%E4%BE%9B%E6%96%B9%E5%90%91%E6%8C%87%E5%AF%BC%E5%92%8C%E8%AE%BE%E8%AE%A1%E5%8F%8D%E9%A6%88%E3%80%82

文档资源

• 镜像完整文档存储在https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub
• balenalib基础镜像新特性详情可参见https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub

支持平台

• balena.io
• balenaOS
• 其他兼容架构的Docker环境