⚠️ 已弃用

此基础镜像已被弃用，将不再接收更新。请阅读公告文章获取迁移指南和建议的替代方案。

镜像概述和主要用途

本镜像属于balena.io物联网（IoT）设备基础镜像系列，专为balena.io平台和balenaOS优化，同时也可在任何运行于相应架构的Docker环境中使用。

核心功能和特性

balenalib基础镜像包含以下主要特性：

1. install_packages 包安装脚本

• 抽象底层包管理器细节，统一包安装流程
• 最小化依赖安装（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 支持安装失败时自动重试

2. 动态设备接入支持

• 默认ENTRYPOINT为["/usr/bin/entry.sh"]，负责设备节点管理
• 通过设置环境变量ENV UDEV=1启用UDEV功能
• 当UDEV启用时，自动启动udevd守护进程，使动态接入的设备节点在容器/dev目录下可见

更多特性详情请参见特性概述。

镜像变体

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

:<version> 或 :<version>-run

• 默认镜像变体，设计为精简且最小化的运行时环境
• 仅包含运行应用所需的必要组件

:<version>-build

• 包含大量源码构建所需工具的重量级镜像
• 减少Dockerfile中手动安装的包数量，从而减小系统中所有镜像的总体积

了解更多变体详情

使用场景和适用范围

• 主要场景：物联网（IoT）设备应用开发与部署
• 优化环境：balena.io平台和balenaOS操作系统
• 兼容环境：任何支持相应架构的Docker环境

使用方法和配置说明

与Balena一起使用

• 参考快速入门指南了解如何结合balena使用此基础镜像
• 查看[示例项目][example-projects]获取实际应用案例

基本使用

1. 创建Dockerfile

在应用项目中创建Dockerfile：

dockerfile
FROM balenalib/imx8m-var-dart-debian:latest
# 此处添加应用代码和配置

2. 构建并运行镜像

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

配置参数说明

环境变量

• UDEV：控制是否启用UDEV设备管理
  • 取值：1（启用）或不设置（禁用）
  • 作用：启用时，容器ENTRYPOINT会启动udevd守护进程，使动态接入的设备节点在/dev目录下可见

支持的版本及Dockerfile链接

• bookworm (latest)、bullseye、buster、sid
  查看Dockerfile

关于镜像及其历史的更多信息，请参见***镜像清单文件 (imx8m-var-dart-debian)。

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过GitHub Issue联系我们。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励在编码前通过GitHub Issue讨论计划，以获取方向和反馈支持高效协作。

文档资源

• 镜像完整文档请参见[基础镜像文档][docs]
• balenalib基础镜像新特性详情请参见[博客文章][migration-docs]

[example-projects]: [][docs]: [] [migration-docs]: [***]