balenalib/jetson-xavier-nx-devkit-emmc-fedora-node Docker 镜像 - 轩辕镜像

⚠️ 已弃用

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

镜像概述

本镜像属于 balena.io IoT 设备基础镜像系列，专为物联网设备优化，适用于 balena.io 平台和 balenaOS 系统，同时也可在任何支持相应架构的 Docker 环境中使用。

核心功能与特性

install_packages 脚本

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

• 安装指定软件包时仅包含最小依赖（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试，提高可靠性

UDEV 设备支持

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

• 检查环境变量 UDEV 是否设置为 1（通过 ENV UDEV=1 配置）
• 若 UDEV=1，自动启动 udevd 守护进程，使外部设备节点可在容器 /dev 目录中识别

镜像变体

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

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

精简的运行时变体，仅包含应用运行所需的核心依赖，体积最小。

:<version>-build

构建环境变体，包含源码构建所需的工具链和依赖库，减少手动安装包的需求，从而降低整体镜像体积。

使用场景与适用范围

• 硬件平台：Jetson Xavier NX 开发板（eMMC 存储版本）
• 系统环境：基于 Fedora 操作系统
• 应用类型：Node.js 编写的 IoT 应用，尤其适合需要：
  • 动态接入外部设备（如传感器、外设）
  • 简化依赖管理的场景
  • 在资源受限环境中运行轻量级服务

支持版本与 Dockerfile 链接

以下 Node.js 版本受支持，对应 Dockerfile 链接如下：

• 20.12.0、19.6.1 (latest)、18.14.1
  Dockerfile 源码

镜像历史及详情可参考 balena-io-library/official-images 仓库中的 清单文件。

使用方法

创建 Dockerfile

在 Node.js 项目中创建 Dockerfile：

dockerfile
# 指定 Node.js 基础镜像及版本
FROM balenalib/jetson-xavier-nx-devkit-emmc-fedora-node:latest
# 暴露应用默认端口（根据实际需求修改）
EXPOSE 8888

构建与运行

console
$ docker build -t my-nodejs-app .
$ docker run -it --rm --name my-running-app my-nodejs-app

Docker Compose 配置

yaml
version: "2"
services:
  node:
    image: "balenalib/jetson-xavier-nx-devkit-emmc-fedora-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production  # 设置生产环境变量
    volumes:
      - ./:/home/node/app    # 挂载本地项目目录到容器
    expose:
      - "8081"               # 暴露内部端口
    command: "npm start"     # 启动应用命令

启动命令：

console
$ docker-compose up -d

运行单个 Node.js 脚本

对于简单单文件项目，可直接运行脚本：

console
$ docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/app \
  -w /usr/src/app \
  balenalib/jetson-xavier-nx-devkit-emmc-fedora-node:latest \
  node your-daemon-or-script.js

用户反馈

问题报告

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

贡献指南

欢迎贡献新功能、修复或更新。建议先通过 GitHub Issues 讨论计划，再提交 Pull Request。

参考文档

• balena 基础镜像特性概述
• balenalib 镜像迁移指南