balenalib/beaglebone-green-wifi-node

balenalib/beaglebone-green-wifi-debian-node 镜像文档

镜像概述和主要用途

该镜像属于 balena.io 基础镜像系列，专为物联网（IoT）设备设计。它针对 balena.io 平台和 balenaOS 进行了优化，同时也可在支持相应架构的任何 Docker 环境中使用。

核心功能和特性

balenalib 基础镜像具有以下主要特性：

• 简化的包管理工具：提供 install_packages 脚本，抽象了底层包管理器的细节。该脚本具有以下特点：

  • 安装指定软件包时忽略可选依赖，仅保留必要依赖
  • 自动清理包管理器元数据，减少镜像体积
  • 安装失败时自动重试

• 动态设备支持：默认入口点（ENTRYPOINT）为 /usr/bin/entry.sh，通过以下机制支持动态插入设备：

  • 设置环境变量 UDEV=1（通过 ENV UDEV=1）
  • 当 UDEV=1 时，自动启动 udevd 守护进程，使容器内 /dev 目录中出现相关设备节点

更多详情请参阅 特性概述 文档。

使用场景和适用范围

适用场景

• IoT 设备上的 Node.js 应用开发与部署
• 需要精简运行时环境的场景（使用 -run 变体）
• 需要从源代码构建应用的开发场景（使用 -build 变体）
• 与 balena.io 平台及 balenaOS 配合使用，实现 IoT 设备的远程管理和部署

硬件支持

专为 beaglebone-green-wifi 开发板设计，也可在其他兼容架构的设备上使用。

镜像变体

balenalib 镜像提供多种变体，满足不同使用需求：

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时环境，仅包含运行应用所需的核心组件，体积小巧。

:<version>-build

包含构建工具的重型变体，预装了从源代码构建应用所需的多种工具，减少 Dockerfile 中手动安装的包数量，从而降低系统中所有镜像的总体积。

更多变体详情请参阅 运行时与构建变体。

使用方法和配置说明

与 Balena 平台配合使用

参考 入门指南 开始使用该基础镜像，同时可查看 示例项目 了解实际应用场景。

Dockerfile 示例

在 Node.js 项目中创建以下 Dockerfile：

dockerfile
# 指定所需版本的 Node.js 基础镜像
FROM balenalib/beaglebone-green-wifi-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 配置

创建 docker-compose.yml 文件：

yaml
version: "2"
services:
  node:
    image: "balenalib/beaglebone-green-wifi-debian-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production  # 设置 Node.js 环境为生产环境
    volumes:
      - ./:/home/node/app  # 挂载当前目录到容器内工作目录
    expose:
      - "8081"  # 暴露应用端口
    command: "npm start"  # 启动命令

使用 Docker Compose 启动：

console
$ docker-compose up -d

说明：上述配置会将当前目录（包括 node_modules）复制到容器中，假设应用的 package.json 文件中定义了 start 脚本。

运行单个 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/beaglebone-green-wifi-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.io
• balenaOS