balenalib/jetson-xavier-ubuntu-python

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

⚠️ 弃用声明

该基础镜像已被弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/%E8%8E%B7%E5%8F%96%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97%E5%92%8C%E5%BB%BA%E8%AE%AE%E7%9A%84%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

镜像概述和主要用途

本镜像属于 https://balena.io/?ref=dockerhub IoT 设备基础镜像系列，专为 Jetson Xavier 架构优化，基于 Ubuntu 系统并集成 Python 运行环境。该镜像主要面向 balena.io 平台和 https://www.balena.io/os/?ref=dockerhub 环境设计，但也可用于任何支持该架构的 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 docker.xuanyuan.run/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 docker.xuanyuan.run/my-python-app

运行单个 Python 脚本

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

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

支持的版本

更多镜像详情和历史版本，可查看 https://github.com/balena-io-library/official-images/blob/master/library/jetson-xavier-ubuntu-python%E3%80%82

与 Balena 平台配合使用

快速入门

参考 https://www.balena.io/docs/learn/getting-started/jetson-xavier/python/?ref=dockerhub 了解如何在 Jetson Xavier 设备上使用该基础镜像。

示例项目

可参考 https://www.balena.io/docs/learn/getting-started/jetson-xavier/python/#example-projects?ref=dockerhub 获取实际应用案例。

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。建议在开发前通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以便其他贡献者提供方向建议或避免重复工作。

文档参考

• https://www.balena.io/docs/reference/base-images/base-images/#features-overview
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub