balenalib/orange-pi-one-debian-python 镜像文档

镜像概述和主要用途

本镜像属于 balena.io IoT 设备基础镜像系列，专为 Orange Pi One 开发板优化，基于 Debian 系统并集成 Python 环境。该镜像主要用于构建和运行 IoT 应用，已针对 balena.io 平台和 balenaOS 进行优化，同时也兼容其他支持相应架构的 Docker 环境。

!balenalogo

核心功能和特性

优化的包管理工具

• install_packages 脚本：抽象底层包管理器差异，自动安装指定软件包，仅包含必要依赖（忽略可选依赖），安装后清理包管理器元数据，并在安装失败时自动重试，简化依赖管理流程。

动态设备支持

• 默认 ENTRYPOINT：镜像默认入口点为 ENTRYPOINT ["/usr/bin/entry.sh"]，通过 UDEV 环境变量控制设备节点管理：
  • 设置 ENV UDEV=1 时，将启动 udevd 守护进程，使容器内 /dev 目录动态识别并加载外部设备节点。

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

镜像变体

balenalib 镜像提供多种变体，满足不同使用场景需求：

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时环境，仅包含应用运行所需的核心依赖，体积小巧。

:<version>-build

构建环境变体，包含大量源代码构建工具（如编译器、链接器等），减少手动安装构建依赖的需求，有助于减小整体镜像体积。

了解更多变体差异

使用场景和适用范围

• IoT 应用开发：适用于在 Orange Pi One 设备上开发基于 Python 的物联网应用，如传感器数据采集、设备控制等。
• balena 平台项目：与 balena.io 平台和 balenaOS 无缝集成，支持设备远程管理、OTA 更新等功能。
• 跨阶段构建：结合 -build 变体进行应用构建，再使用 -run 变体运行，实现高效的镜像优化。

什么是 Python？

Python 是一种解释型、交互式、面向对象的开源编程语言。它包含模块、异常处理、动态类型、高级动态数据类型和类等特性。Python 兼具强大功能与清晰语法，可与众多系统调用、库及窗口系统交互，并支持通过 C 或 C++ 扩展。此外，Python 具有良好的可移植性，可运行于多种 Unix 变体、Mac 和 Windows 2000 及更高版本系统。

***.org/wiki/Python_(programming_language)

!Python logo

支持的版本及 Dockerfile 链接

• 2.7.16 (latest)、3.7.4、3.6.9、3.5.7、3.4.10
  Dockerfile 源码

更多镜像信息及历史版本，可参考 ***镜像清单文件 (orange-pi-one-debian-python)（位于 balena-io-library/official-images GitHub 仓库）。

使用方法和配置说明

创建 Python 应用的 Dockerfile

在 Python 项目中创建 Dockerfile：

dockerfile
FROM balenalib/orange-pi-one-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 脚本

对于简单的单文件项目，可直接使用镜像运行脚本，无需编写完整 Dockerfile：

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

动态设备支持配置

如需启用动态设备识别，在 Dockerfile 中设置 UDEV 环境变量：

dockerfile
ENV UDEV=1

此时容器启动时将自动启动 udevd 守护进程，外部设备节点将在 /dev 目录中动态生成。

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过 GitHub Issue 联系我们。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励在编码前通过 GitHub Issue 讨论计划，以便其他贡献者提供方向建议、设计反馈或避免重复工作。

相关文档

镜像详细文档请参考 balena 基础镜像文档。更多 balenalib 镜像新特性说明，可查看 ***博客。