balenalib/qemux86-64-python Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

balenalib/qemux86-64-debian-python 镜像文档

镜像概述和主要用途

该镜像属于balena.io的IoT设备基础镜像系列，提供Python运行环境，专为balenaOS和balena.io平台优化，同时兼容其他Docker环境。适用于在IoT设备上开发和运行Python应用，支持动态设备接入和高效包管理。

核心功能和特性

便捷包管理工具

• install_packages脚本：抽象底层包管理器差异，安装指定包时最小化依赖（忽略可选依赖），自动清理包管理器元数据，并在安装失败时重试。

动态设备支持

• 默认ENTRYPOINT为/usr/bin/entry.sh，当设置ENV UDEV=1时，自动启动udevd守护进程，使容器内/dev目录能识别动态接入的设备节点。

镜像变体

• :<version> 或 :<version>-run：默认精简版，仅包含运行时必需组件，体积小巧。
• :<version>-build：重型构建版，包含源码构建所需的各类工具，减少手动安装依赖，降低整体镜像体积。

使用场景和适用范围

• IoT设备上的Python应用开发与部署，尤其是需要动态接入外部设备（如传感器、外设）的场景。
• 基于balena平台的项目开发，或其他需要在Docker环境中运行Python应用的场景。

支持的Python版本

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

详细版本信息可查看GitHub仓库。

详细使用方法

创建Dockerfile部署Python应用

在Python项目中创建Dockerfile：

dockerfile
FROM balenalib/qemux86-64-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

直接运行单个Python脚本

对于简单单文件项目，可直接使用镜像运行脚本：

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

用户反馈

问题反馈

如遇问题或有疑问，请通过GitHub Issues联系。

贡献指南

欢迎贡献新功能、修复或更新。建议先通过GitHub Issues讨论计划，特别是大型贡献，以便获取方向和反馈。

文档参考

更多详细文档请查看balena基础镜像特性概述及迁移指南。