balenalib/raspberry-pi2-debian-node

balenalib/raspberry-pi2-debian-node 镜像文档

镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列，专为树莓派 Pi 2 设备设计。基于 Debian 系统和 Node.js 运行时，优化用于 balena.io 平台和 balenaOS 操作系统，同时也可在其他支持相应架构的 Docker 环境中使用。其核心目标是为树莓派 Pi 2 上的 Node.js 应用提供精简、高效的基础运行环境。

核心功能和特性

1. install_packages 包管理脚本

• 功能：抽象底层包管理器（如 apt）的差异，简化依赖安装流程。
• 特性：
  • 自动选择最小依赖集（忽略可选依赖），减少镜像体积。
  • 安装后自动清理包管理器元数据，进一步精简镜像。
  • 支持安装失败时自动重试，提升稳定性。

2. 动态设备节点支持

• 功能：通过 udevd 守护进程实现容器内动态设备节点管理。
• 启用方式：在 Dockerfile 中添加 ENV UDEV=1 环境变量。
• 效果：启动 udevd 服务，使容器内 /dev 目录能动态识别并创建外部设备节点（如传感器、USB 设备等）。

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

使用场景和适用范围

适用场景

• 物联网设备开发：树莓派 Pi 2 平台的 Node.js 应用开发与部署。
• 运行时环境：需精简镜像体积的生产环境部署（选用 run 变体）。
• 构建环境：需从源码构建应用的开发场景（选用 build 变体，减少手动安装构建工具的需求）。

适用范围

• 硬件：树莓派 Pi 2 设备。
• 软件：Node.js 应用，支持通过 balena.io 平台或独立 Docker 环境运行。

镜像变体

balenalib/raspberry-pi2-debian-node 提供以下变体，满足不同使用需求：

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

• 定位：运行时精简版。
• 特性：仅包含应用运行必需的依赖，体积最小化，适合生产环境部署。
• 示例：balenalib/raspberry-pi2-debian-node:18.7.0 或 balenalib/raspberry-pi2-debian-node:18.7.0-run。

:<version>-build

• 定位：构建工具版。
• 特性：包含编译器、Make、Git 等源码构建工具，减少 Dockerfile 中手动安装依赖的步骤，间接降低整体镜像体积。
• 示例：balenalib/raspberry-pi2-debian-node:18.7.0-build。

更多变体详情可参考 balena 基础镜像：运行时与构建时对比。

详细使用方法和配置说明

与 Balena 平台配合使用

如需在 balena.io 平台上使用本镜像，可参考 树莓派 Pi 2 Node.js 入门指南，或查看 示例项目 获取实践参考。

基础使用示例

1. Dockerfile 构建应用

创建 Dockerfile 定义应用环境：

dockerfile
# 指定基础镜像，可替换为所需 Node.js 版本（如 16.17.0、14.20.0 等）
FROM balenalib/raspberry-pi2-debian-node:latest
# 暴露应用端口（替换为实际端口）
EXPOSE 8888
# 复制应用代码（示例）
COPY . /app
WORKDIR /app
# 安装依赖并启动
RUN npm install
CMD ["npm", "start"]

构建并运行镜像：

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

2. Docker Compose 部署

创建 docker-compose.yml 配置文件：

yaml
version: "2"
services:
  node:
    image: "balenalib/raspberry-pi2-debian-node:latest"
    user: "node"  # 使用 node 用户运行
    working_dir: /home/node/app  # 工作目录
    environment:
      - NODE_ENV=production  # 环境变量
    volumes:
      - ./:/home/node/app  # 挂载本地代码到容器
    expose:
      - "8081"  # 暴露端口
    command: "npm start"  # 启动命令

启动服务：

console
$ docker-compose up -d

注：上述配置假设应用根目录包含 package.json，且定义了 start 脚本（参考 npm 脚本文档）。

3. 运行单文件 Node.js 脚本

无需编写 Dockerfile，直接运行本地脚本：

console
$ docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/app \  # 挂载本地目录到容器
  -w /usr/src/app \  # 设置工作目录
  balenalib/raspberry-pi2-debian-node:latest \
  node your-daemon-or-script.js  # 运行脚本

关键配置参数

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新。建议先通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以确保方向一致。

参考链接

• balena 基础镜像文档
• balenaOS 官网
• Node.js 官网