balenalib/jetson-xavier-nx-devkit-emmc-alpine-python

balenalib/jetson-xavier-nx-devkit-emmc-alpine-python 镜像文档

镜像概述与主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列，专为 Jetson Xavier NX DevKit eMMC 开发板设计，基于 Alpine Linux 系统并集成 Python 运行环境。镜像针对 balena.io 平台和 balenaOS 进行了优化，同时兼容其他符合架构要求的 Docker 环境。主要用于 IoT 设备上 Python 应用的开发、构建与部署，尤其适用于需要访问硬件设备的嵌入式场景。

核心功能与特性

1. install_packages 包管理脚本

• 功能：抽象底层包管理器（如 Alpine 的 apk），简化依赖安装流程。
• 特性：
  • 自动选择依赖最少的软件包版本（忽略可选依赖）；
  • 安装完成后清理包管理器元数据，减少镜像体积；
  • 支持安装失败时自动重试。

2. 动态设备接入支持

• 默认 ENTRYPOINT：/usr/bin/entry.sh，负责容器初始化；
• udevd 守护进程：通过设置环境变量 UDEV=1（ENV UDEV=1）启动 udevd，使外部设备节点（如传感器、USB 设备）自动出现在容器的 /dev 目录中，实现硬件设备的动态识别。

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

镜像变体

:<version> 或 :<version>-run（默认变体）

• 定位：精简的运行时镜像，仅包含 Python 应用运行必需的组件（如 Python 解释器、基础库）；
• 适用场景：生产环境部署，追求最小镜像体积。

:<version>-build

• 定位：包含源码构建工具的重型镜像（如编译器、Make、Git 等）；
• 适用场景：从源码构建应用（如编译 Python C 扩展），减少 Dockerfile 中手动安装构建工具的步骤，降低整体镜像体积。

变体区别详情参见 run vs build 变体说明。

使用场景与适用范围

使用方法与配置说明

环境变量配置

方法一：通过 Dockerfile 构建应用

1. 编写 Dockerfile

dockerfile
# 基于最新版运行时镜像
FROM balenalib/jetson-xavier-nx-devkit-emmc-alpine-python:latest

# 设置工作目录
WORKDIR /usr/src/app

# 安装 Python 依赖
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 启动命令（替换为实际脚本路径）
CMD ["python", "./your-daemon-or-script.py"]

2. 构建并运行镜像

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

# 运行容器（--rm 退出后自动清理容器）
docker run -it --rm --name my-running-app my-python-app

方法二：直接运行单个 Python 脚本

无需编写 Dockerfile，通过挂载本地目录直接运行脚本：

bash
# 挂载当前目录到容器，运行脚本（替换 your-script.py 为实际脚本名）
docker run -it --rm \
  --name my-running-script \
  -v "$PWD":/usr/src/myapp \  # 挂载本地目录到容器内 /usr/src/myapp
  -w /usr/src/myapp \          # 设置工作目录为挂载目录
  balenalib/jetson-xavier-nx-devkit-emmc-alpine-python:latest \
  python your-script.py        # 执行脚本

用户反馈与贡献

问题反馈

若遇到镜像使用问题，可通过 https://github.com/balena-io-library/base-images/issues 提交。

贡献指南

欢迎提交功能改进、Bug 修复或文档更新。建议先通过 https://github.com/balena-io-library/base-images/issues 讨论计划，再提交 Pull Request。

参考文档

• balena 基础镜像文档
• Jetson Xavier NX Python 入门指南
• 示例项目