balenalib/imx8m-var-dart-alpine 镜像文档

⚠️ 已弃用（DEPRECATED）

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

1. 镜像概述和主要用途

该镜像原属 balena.io 物联网（IoT）设备基础镜像系列，旨在为嵌入式设备提供轻量、优化的运行环境。其设计初衷是与 balena.io 平台 和 balenaOS 操作系统 配合使用，同时也可在任何支持相应架构的 Docker 环境中运行。

2. 核心功能和特性

2.1 install_packages 包管理脚本

• 功能：抽象底层包管理器细节，简化依赖安装流程。
• 特性：
  • 仅安装必要依赖（忽略可选依赖），最小化镜像体积；
  • 自动清理包管理器元数据，减少冗余文件；
  • 安装失败时自动重试，提升稳定性。

2.2 动态设备支持（UDEV）

• 默认入口点：镜像默认 ENTRYPOINT 为 ["/usr/bin/entry.sh"]；
• UDEV 配置：通过设置环境变量 ENV UDEV=1 启用 UDEV 支持，此时入口脚本会启动 udevd 守护进程，动态插入的设备节点将自动出现在容器 /dev 目录中。

更多特性详情请参见 ***文档 - 特性概述。

3. 使用场景和适用范围

• 原适用场景：适用于基于 imx8m-var-dart 架构的 IoT 设备应用开发，尤其优化用于 balena.io 平台的容器化部署。
• 兼容性：可在任何支持该架构的 Docker 环境中运行，但因已弃用，建议迁移至替代方案。

4. 镜像变体

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

4.1 :<version> 或 :<version>-run

• 定位：默认镜像，精简运行时变体。
• 特性：仅包含运行时必需组件，体积轻量，适用于生产环境部署。

4.2 :<version>-build

• 定位：构建环境变体。
• 特性：包含大量源码构建工具，减少 Dockerfile 中手动安装依赖的需求，从而降低系统中所有镜像的总体积。

更多变体详情请参见 ***文档 - Run vs Build。

5. 使用方法和配置说明

5.1 与 Balena 平台配合使用

• 入门指南：参考 ***入门指南 了解如何将该镜像与 balena 平台结合使用。
• 示例项目：查看 balena 示例项目 获取实际应用场景参考。

5.2 Dockerfile 示例

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

5.3 构建和运行容器

bash
# 构建镜像
$ docker build -t my-app .

# 运行容器（示例）
$ docker run -it --rm --name my-running-app my-app

5.4 UDEV 配置示例

如需启用动态设备支持，在 Dockerfile 中设置 UDEV 环境变量：

dockerfile
FROM balenalib/imx8m-var-dart-alpine:3.21
ENV UDEV=1
# 应用配置...

6. 支持的版本及 Dockerfile 链接

以下版本曾受支持，对应 Dockerfile 可在 GitHub 仓库中查看：
3.21 (latest)、3.20、3.19、3.18、3.17、3.16、3.15、3.14、3.13、3.12、edge

镜像历史及更多信息请参见 ***镜像清单（imx8m-var-dart-alpine）。

7. 用户反馈

7.1 问题反馈

如遇镜像相关问题，请通过 GitHub Issues 联系维护团队。

7.2 贡献指南

欢迎提交新功能、修复或更新（尽管镜像已弃用）。建议先通过 GitHub Issues 讨论计划，确保贡献方向一致。

7.3 相关文档

• 基础镜像文档：balena 基础镜像概述
• 迁移指南：新 balena 基础镜像特性说明