balenalib/imx7-var-som-debian-node

balenalib/imx7-var-som-debian-node 镜像文档

镜像概述与主要用途

本镜像属于 balena.io IoT 设备基础镜像系列，专为物联网设备优化设计。其核心用途是为基于 imx7-var-som 架构的设备提供 Node.js 运行环境，尤其适用于 balena.io 平台和 balenaOS 系统。同时，该镜像也可在其他支持相应架构的 Docker 环境中使用。

核心功能与特性

1. install_packages 包管理脚本

• 功能：抽象底层包管理器（如 apt、apk 等）的差异，简化依赖安装流程。
• 特性：
  • 仅安装必要依赖，忽略可选依赖，最小化镜像体积。
  • 自动清理包管理器元数据，减少镜像冗余。
  • 安装失败时自动重试，提升稳定性。

2. 动态设备支持（udevd 集成）

• 默认 ENTRYPOINT：镜像默认入口点为 ENTRYPOINT ["/usr/bin/entry.sh"]，负责初始化设备支持。
• UDEV 环境变量控制：通过设置 ENV UDEV=1 启用 udevd 守护进程，使容器内 /dev 目录可动态识别宿主机插入的设备节点。

更多特性详情参见 https://www.balena.io/docs/reference/base-images/base-images/#features-overview%E3%80%82

使用场景与适用范围

• 物联网设备开发：适用于基于 imx7-var-som 架构的 IoT 设备应用开发与部署。
• balena 平台项目：与 balena.io 平台和 balenaOS 深度集成，简化设备管理与应用分发。
• 运行时环境：run 变体适合生产环境，提供轻量运行时；build 变体适合源码构建阶段，减少手动安装工具的需求。

镜像变体

:<version> 或 :<version>-run

• 定位：默认镜像，轻量且最小化，仅包含运行时必要组件。
• 适用场景：生产环境部署，需最小化镜像体积和资源占用。

:<version>-build

• 定位：包含源码构建所需的工具链（如编译器、链接器等），减少手动安装依赖的操作。
• 适用场景：源码编译阶段，降低 Dockerfile 复杂度，减小整体镜像体积。

更多变体细节参见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

使用方法与配置说明

与 Balena 平台配合使用

参考 https://www.balena.io/docs/learn/getting-started/imx7-var-som/nodejs/?ref=dockerhub 快速上手，或查看 https://www.balena.io/docs/learn/getting-started/imx7-var-som/nodejs/#example-projects?ref=dockerhub 了解实际应用场景。

Dockerfile 示例

dockerfile
# 指定 Node 基础镜像，使用所需版本 node:<version>
FROM docker.xuanyuan.run/balenalib/imx7-var-som-debian-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: "docker.xuanyuan.run/balenalib/imx7-var-som-debian-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production  # 设置 Node 环境为生产模式
    volumes:
      - ./:/home/node/app  # 挂载当前目录至容器工作目录
    expose:
      - "8081"  # 暴露端口（根据应用需求修改）
    command: "npm start"  # 启动命令（需确保 package.json 中定义 start 脚本）

启动服务：

console
$ docker-compose up -d

运行单个 Node.js 脚本

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

console
$ docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/app \  # 挂载当前目录至容器内 /usr/src/app
  -w /usr/src/app \  # 设置工作目录
  balenalib/imx7-var-som-debian-node:latest \
  node your-daemon-or-script.js  # 运行目标脚本

支持的版本

• 18.7.0 (latest)、16.17.0、14.20.0、12.22.12
  镜像源码及历史版本参见 https://github.com/balena-io-library/base-images/tree/master/balena-base-images/node/imx7-var-som/debian/%E3%80%82

用户反馈

问题反馈

如遇镜像相关问题或疑问，可通过 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/#balena-base-images?ref=dockerhub
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub

相关链接

• https://balena.io/?ref=dockerhub
• https://www.balena.io/os/?ref=dockerhub