balenalib/qemux86-64-python

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

详细版本信息可查看https://github.com/balena-io-library/base-images/tree/master/balena-base-images/python/qemux86-64/debian/%E3%80%82

详细使用方法

创建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

用户反馈

问题反馈

如遇问题或有疑问，请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E3%80%82

贡献指南

欢迎贡献新功能、修复或更新。建议先通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E7%89%B9%E5%88%AB%E6%98%AF%E5%A4%A7%E5%9E%8B%E8%B4%A1%E7%8C%AE%EF%BC%8C%E4%BB%A5%E4%BE%BF%E8%8E%B7%E5%8F%96%E6%96%B9%E5%90%91%E5%92%8C%E5%8F%8D%E9%A6%88%E3%80%82

文档参考

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