balenalib/cl-som-imx8-debian-python 镜像文档

镜像概述

该镜像属于balena.io物联网(IoT)设备基础镜像系列，专为IoT场景优化，主要适配balena.io平台与balenaOS系统，同时兼容其他支持相应架构的Docker环境。集成Python运行时环境，提供简化的依赖管理与设备动态识别能力，是IoT设备上Python应用开发与部署的理想选择。

核心功能与特性

简化的包管理机制

• 内置install_packages脚本，抽象底层包管理器差异（如apt、apk等）
• 自动安装最小依赖集（忽略可选依赖），减少镜像体积
• 安装后自动清理包管理器元数据，优化存储空间
• 支持安装失败自动重试，提升部署可靠性

动态设备支持

• 默认ENTRYPOINT为/usr/bin/entry.sh，负责设备管理
• 通过UDEV环境变量控制（设置ENV UDEV=1启用）
• 启用时自动启动udevd守护进程，动态识别并加载外部设备节点至容器/dev目录

镜像变体

:<version> 或 :<version>-run

• 基础镜像版本，"run"变体为轻量级运行时版本
• 仅包含应用运行必需组件，体积小巧，适合生产环境部署

:<version>-build

• 包含完整构建工具链的重型版本
• 集成源代码编译所需工具，减少手动安装依赖步骤，优化多阶段构建流程

支持的Python版本

当前支持以下Python版本，对应Dockerfile可在GitHub仓库查看：

• 3.10.5 (latest)
• 3.9.13
• 3.8.13
• 3.7.13
• 3.6.15

使用方法

构建Python应用镜像

在项目根目录创建Dockerfile：

dockerfile
FROM balenalib/cl-som-imx8-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 my-python-app

直接运行单文件脚本

对于简单项目，可直接挂载脚本运行，无需编写Dockerfile：

console
$ docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/myapp \
  -w /usr/src/myapp \
  balenalib/cl-som-imx8-debian-python:latest \
  python your-daemon-or-script.py

使用场景与适用范围

• IoT设备上的Python应用开发与部署
• 基于balena.io平台的物联网项目
• 需要动态管理外部硬件设备的嵌入式应用
• 对镜像体积和依赖管理有严格要求的边缘计算场景

配置参数

环境变量

• UDEV: 设为1时启用udevd守护进程，支持动态设备节点（默认未启用）

用户反馈

问题反馈

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

贡献指南

欢迎提交PR贡献代码改进，建议先通过GitHub Issues讨论重大变更。

参考文档

• balena基础镜像特性概述
• 镜像变体详情
• balena入门指南
• 示例项目