balenalib/imx8m-var-dart-alpine

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

⚠️ 已弃用（DEPRECATED）

此基础镜像已弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/%E8%8E%B7%E5%8F%96%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97%E5%92%8C%E5%BB%BA%E8%AE%AE%E7%9A%84%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

1. 镜像概述和主要用途

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

2. 核心功能和特性

2.1 install_packages 包管理脚本

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

2.2 动态设备支持（UDEV）

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

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

3. 使用场景和适用范围

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

4. 镜像变体

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

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

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

4.2 :<version>-build

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

更多变体详情请参见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub。

5. 使用方法和配置说明

5.1 与 Balena 平台配合使用

• 入门指南：参考 https://www.balena.io/docs/learn/getting-started/imx8m-var-dart/nodejs/?ref=dockerhub 了解如何将该镜像与 balena 平台结合使用。
• 示例项目：查看 https://www.balena.io/docs/learn/getting-started/imx8m-var-dart/nodejs/#example-projects?ref=dockerhub 获取实际应用场景参考。

5.2 Dockerfile 示例

dockerfile
FROM docker.xuanyuan.run/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 docker.xuanyuan.run/balenalib/imx8m-var-dart-alpine:3.21
ENV UDEV=1
# 应用配置...

6. 支持的版本及 Dockerfile 链接

以下版本曾受支持，对应 Dockerfile 可在 GitHub 仓库中查看：
https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/imx8m-var-dart/alpine/%E3%80%81%603.20%60%E3%80%81%603.19%60%E3%80%81%603.18%60%E3%80%81%603.17%60%E3%80%81%603.16%60%E3%80%81%603.15%60%E3%80%81%603.14%60%E3%80%81%603.13%60%E3%80%81%603.12%60%E3%80%81%60edge%60

镜像历史及更多信息请参见 https://github.com/balena-io-library/official-images/blob/master/library/imx8m-var-dart-alpine%E3%80%82

7. 用户反馈

7.1 问题反馈

如遇镜像相关问题，请通过 https://github.com/balena-io-library/base-images/issues 联系维护团队。

7.2 贡献指南

欢迎提交新功能、修复或更新（尽管镜像已弃用）。建议先通过 https://github.com/balena-io-library/base-images/issues 讨论计划，确保贡献方向一致。

7.3 相关文档

• 基础镜像文档：https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub
• 迁移指南：https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub