balenalib/nanopc-t4-python

balenalib/nanopc-t4-debian-python 镜像文档

镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列，专为 IoT 设备开发设计。该镜像针对 https://balena.io/?ref=dockerhub 平台和 https://www.balena.io/os/?ref=dockerhub 进行了优化，同时也可在其他支持相应架构的 Docker 环境中使用。其核心用途是为 IoT 设备提供轻量、高效的 Python 运行时环境，支持应用的开发、构建与部署。

核心功能和特性

1. 简化的包管理工具 install_packages

• 抽象底层包管理器细节，自动处理依赖关系（忽略可选依赖以最小化安装体积）。
• 安装完成后自动清理包管理器元数据，减少镜像体积。
• 支持安装失败时自动重试，提升可靠性。

2. 动态设备接入支持

• 默认 ENTRYPOINT 为 ENTRYPOINT ["/usr/bin/entry.sh"]，可通过设置环境变量 UDEV=1（即 ENV UDEV=1）启用 udevd 守护进程。
• 启用后，容器内 /dev 目录会动态生成接入设备的节点文件，支持热插拔设备识别。

更多功能详情请参考 https://www.balena.io/docs/reference/base-images/base-images/#features-overview 文档。

镜像变体

balenalib 镜像提供多种变体，适用于不同场景：

:<version> 或 :<version>-run

• 默认镜像变体，专注于运行时环境。
• 特点：精简、轻量，仅包含运行应用所需的核心依赖，适合生产环境部署。

:<version>-build

• 构建时专用变体，包含大量源码构建工具（如编译器、链接器等）。
• 优势：减少 Dockerfile 中手动安装构建工具的需求，降低系统整体镜像体积。

详细差异参考 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub。

使用场景和适用范围

• IoT 设备 Python 应用开发：适用于基于 nanopc-t4 等 IoT 设备的 Python 应用开发，尤其是采用 balena.io 平台进行设备管理和部署的场景。
• 运行时环境：-run 变体适合部署生产环境应用，提供最小化运行时依赖。
• 构建时环境：-build 变体适合源码编译场景，如需要从源码构建 Python 依赖或应用本身的开发阶段。

详细使用方法和配置说明

与 Balena 平台配合使用

参考 https://www.balena.io/docs/learn/getting-started/nanopc-t4/python/?ref=dockerhub 可帮助您在 Balena 平台上快速上手本镜像，也可查看 https://www.balena.io/docs/learn/getting-started/nanopc-t4/python/#example-projects?ref=dockerhub 了解实际应用场景。

Dockerfile 示例

基础应用部署

创建 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/balenalib/nanopc-t4-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/nanopc-t4-debian-python:latest \
  python your-daemon-or-script.py

配置参数说明

环境变量 UDEV

• 作用：控制是否启动 udevd 守护进程以支持动态设备节点。
• 设置方式：在 Dockerfile 中添加 ENV UDEV=1。
• 效果：启用后，容器内 /dev 目录会自动生成接入设备的节点文件，支持热插拔设备识别。

支持版本及 Dockerfile 链接

镜像历史及更多信息可参考 https://github.com/balena-io-library/official-images/blob/master/library/nanopc-t4-debian-python。

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过 https://github.com/balena-io-library/base-images/issues 联系我们。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。建议在提交代码前，通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以确保方向一致并获取反馈。