balenalib/jetson-xavier-ubuntu-python Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

balenalib/jetson-xavier-ubuntu-python 镜像文档

⚠️ 弃用声明

该基础镜像已被弃用，将不再接收更新。请阅读公告文章获取迁移指南和建议的替代方案。

镜像概述和主要用途

本镜像属于 balena.io IoT 设备基础镜像系列，专为 Jetson Xavier 架构优化，基于 Ubuntu 系统并集成 Python 运行环境。该镜像主要面向 balena.io 平台和 balenaOS 环境设计，但也可用于任何支持该架构的 Docker 环境中，适用于在 Jetson Xavier 设备上开发和运行 Python 应用程序。

核心功能和特性

1. install_packages 包管理脚本

提供便捷的包安装脚本 install_packages，抽象了底层包管理器的细节，具备以下特性：

• 安装指定包时自动选择最小依赖集（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试

2. 动态设备支持

默认 ENTRYPOINT 定义为 ENTRYPOINT ["/usr/bin/entry.sh"]，支持动态插入设备：

• 通过设置环境变量 ENV UDEV=1 启用 UDEV 功能
• 启用后将启动 udevd 守护进程，容器内 /dev 目录会自动生成相关设备节点

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体，设计为精简版本，仅包含运行时必需组件，适合直接部署应用。

:<version>-build

构建专用变体，包含大量源码构建所需工具，减少手动安装依赖的需求，从而降低系统中所有镜像的总体积。

使用场景和适用范围

• Jetson Xavier 设备上的 Python 应用开发：需利用设备硬件加速或专用接口的 IoT 应用
• balena 生态集成：与 balena.io 平台、balenaOS 配合使用，实现设备管理和应用部署
• 动态设备交互：需要访问 USB、传感器等热插拔设备的场景（通过 UDEV 功能）
• 源码构建优化：使用 -build 变体简化从源码构建 Python 应用的流程

详细使用方法和配置说明

环境变量配置

Dockerfile 示例

基础 Python 应用 Dockerfile

dockerfile
FROM balenalib/jetson-xavier-ubuntu-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" ]

构建并运行镜像：

bash
# 构建镜像
docker build -t my-python-app .

# 运行容器
docker run -it --rm --name my-running-app my-python-app

运行单个 Python 脚本

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

bash
docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/myapp \
  -w /usr/src/myapp \
  balenalib/jetson-xavier-ubuntu-python:latest \
  python your-daemon-or-script.py

支持的版本

更多镜像详情和历史版本，可查看 官方镜像清单文件。

与 Balena 平台配合使用

快速入门

参考 Balena 快速入门指南 了解如何在 Jetson Xavier 设备上使用该基础镜像。

示例项目

可参考 Balena 示例项目 获取实际应用案例。

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过 GitHub Issues 提交。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。建议在开发前通过 GitHub Issues 讨论计划，以便其他贡献者提供方向建议或避免重复工作。

文档参考

• Balena 基础镜像特性概述
• balenalib 镜像新特性说明