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

镜像概述与主要用途

本镜像属于 balena.io 物联网设备基础镜像系列，专为 IoT 设备优化设计。镜像针对 balena.io 平台和 balenaOS 进行了深度适配，同时也可在支持对应架构的任何 Docker 环境中运行。其核心用途是为 imx6ul-var-dart 架构设备提供 Python 应用的开发与运行环境。

核心功能与特性

1. install_packages 包管理脚本

• 功能：抽象底层包管理器差异，提供统一的包安装接口
• 特性：
  • 自动选择最小依赖集（忽略可选依赖）
  • 安装完成后自动清理包管理器元数据
  • 支持安装失败时自动重试
• 使用方式：直接在 Dockerfile 中调用 install_packages <package-name>

2. 动态设备支持

• 功能：通过默认入口点 /usr/bin/entry.sh 实现设备节点自动管理
• 工作机制：
  • 当设置环境变量 UDEV=1 时，自动启动 udevd 守护进程
  • 动态探测并创建容器内 /dev 目录下的设备节点
• 启用方式：在 Dockerfile 中添加 ENV UDEV=1

镜像变体

:<version> 或 :<version>-run

• 定位：默认基础镜像，精简版
• 特性：仅包含运行时必需组件，体积最小化
• 适用场景：生产环境部署、资源受限设备、仅需运行已编译应用的场景

:<version>-build

• 定位：构建环境镜像，功能增强版
• 特性：包含完整的源码构建工具链（编译器、链接器等）
• 优势：减少手动安装构建依赖的需求，降低整体镜像体积
• 适用场景：从源码编译应用、需要构建工具链的开发场景

更多变体细节参见 ***文档

使用场景与适用范围

• IoT 设备上的 Python 应用开发与部署
• 基于 balena.io 平台的物联网项目
• 需要动态设备节点管理的嵌入式应用
• Python 应用的构建-运行分离场景（使用 build 变体构建，run 变体运行）

使用方法与配置说明

与 Balena 平台配合使用

• 入门指南：参见 balena ***快速入门文档
• 示例项目：参考 balena 示例项目库

Dockerfile 示例

dockerfile
FROM balenalib/imx6ul-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" ]

构建与运行镜像

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

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

运行单个 Python 脚本

对于简单的单文件项目，可直接挂载脚本运行：

console
$ docker run -it --rm \
    --name my-running-script \
    -v "$PWD":/usr/src/myapp \
    -w /usr/src/myapp \
    -e UDEV=1 \
    balenalib/imx6ul-var-dart-debian-python:latest \
    python your-daemon-or-script.py

环境变量配置

支持的版本与 Dockerfile 链接

• 支持的 Python 版本：2.7.16 (latest)、3.7.4、3.6.9、3.5.7、3.4.10
• Dockerfile 源码：balena-base-images 仓库
• 镜像清单：official-images 仓库

用户反馈与贡献

问题反馈

如遇使用问题，请通过 GitHub Issues 提交

贡献指南

欢迎提交新功能、修复或更新。建议先通过 GitHub Issues 讨论重大变更，再提交 Pull Request

更多文档

• 基础镜像特性概述
• balena 基础镜像文档