balenalib/imx8m-var-dart-debian-python 镜像文档

1. 镜像概述和主要用途

本镜像属于 balena.io IoT 设备基础镜像系列，专为 balena.io 平台和 balenaOS 优化，同时兼容其他支持相应架构的 Docker 环境。其核心定位是为 IoT 设备提供轻量、高效的 Python 运行时和构建环境，简化设备应用的开发、部署与维护流程。

2. 核心功能和特性

2.1 install_packages 包管理工具

• 功能：抽象底层包管理器（如 apt、apk 等）的差异，自动选择依赖最少的包版本进行安装。
• 特性：
  • 忽略可选依赖，最小化安装体积；
  • 自动清理包管理器元数据（如 apt cache），减少镜像大小；
  • 安装失败时自动重试，提升稳定性。

2.2 动态设备节点支持

• 原理：通过默认 ENTRYPOINT /usr/bin/entry.sh 检测环境变量 UDEV，当设置 ENV UDEV=1 时，自动启动 udevd 守护进程。
• 效果：容器内 /dev 目录会动态生成外部设备节点（如 USB 设备、传感器等），实现对硬件设备的直接访问。

更多特性详情参见 balena 基础镜像特性概述。

3. 镜像变体与适用范围

3.1 镜像变体

:<version> 或 :<version>-run

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

:<version>-build

• 定位：构建环境变体。
• 特点：包含编译源码所需的工具链（如 gcc、make 等），减少手动安装依赖的需求，间接降低整体镜像体积。

变体差异详情参见 运行时 vs 构建镜像。

3.2 适用场景

• IoT 设备 Python 应用运行时环境；
• 基于 Python 的 IoT 应用构建环境（使用 -build 变体）；
• 需要动态访问硬件设备的场景（如传感器数据采集、外设控制）。

4. 使用方法和配置说明

4.1 与 Balena 平台结合使用

参考 balena 快速入门指南 和 示例项目，可快速搭建基于本镜像的 IoT 应用开发流程。

4.2 直接使用镜像（非 Balena 环境）

4.2.1 通过 Dockerfile 构建应用

示例 Dockerfile：

FROM balenalib/imx8m-var-dart-debian-python:latest

WORKDIR /usr/src/app

# 安装依赖
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 启动命令
CMD ["python", "./your-daemon-or-script.py"]

构建与运行：

# 构建镜像
docker build -t my-python-iot-app .

# 运行容器（启用设备节点支持）
docker run -it --rm --name iot-app -e UDEV=1 my-python-iot-app

4.2.2 直接运行单文件 Python 脚本

无需编写 Dockerfile，通过挂载主机目录直接运行脚本：

docker run -it --rm \
  --name single-script-runner \
  -v "$PWD":/usr/src/myapp \  # 挂载当前目录到容器内
  -w /usr/src/myapp \          # 设置工作目录
  -e UDEV=1 \                  # 启用设备节点支持（如需）
  balenalib/imx8m-var-dart-debian-python:latest \
  python your-script.py

5. 配置参数

5.1 环境变量

6. 支持的 Python 版本

7. 用户反馈

7.1 问题反馈

如遇镜像使用问题，可通过 GitHub Issues 提交。

7.2 贡献指南

欢迎通过 Pull Request 贡献代码或改进（建议先通过 GitHub Issues 讨论方案）。

7.3 文档参考

• balena 基础镜像文档
• balena 基础镜像迁移指南

相关链接

• balena.io 平台
• balenaOS