balenalib/asus-tinker-board-alpine-node 镜像文档

1. 镜像概述和主要用途

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

2. 核心功能和特性

2.1 简化的包管理工具 install_packages

提供 install_packages 脚本，抽象了底层包管理器的细节，具备以下特性：

• 安装指定软件包时自动选择最小依赖集（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时支持自动重试机制

2.2 动态设备检测支持

默认 ENTRYPOINT 为 /usr/bin/entry.sh，支持动态设备节点管理：

• 通过设置环境变量 ENV UDEV=1 启用 udev 支持
• 启用后自动启动 udevd 守护进程，容器内 /dev 目录将动态显示插入的设备节点

3. 镜像变体

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

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

• 精简的运行时变体，仅包含运行应用所需的核心依赖
• 设计目标：轻量、最小化镜像体积

3.2 :<version>-build

• 包含大量源码构建工具的重型镜像
• 减少 Dockerfile 中手动安装工具的需求，从而降低系统中所有镜像的总体积

4. 使用场景和适用范围

• IoT 设备应用开发：适用于基于 Asus Tinker Board 的嵌入式应用开发
• 运行时环境：需要精简运行时的生产环境部署（使用 run 变体）
• 构建环境：源码编译和构建流程（使用 build 变体）
• 动态设备交互：需检测 USB/串口等外设的 IoT 应用（配合 UDEV=1 使用）
• Node.js 应用开发：基于 Node.js 的 IoT 服务端/网络应用开发

5. 支持的版本及 Dockerfile 链接

6. 使用方法和配置说明

6.1 在 Balena 平台使用

参考 Balena 快速入门指南 和 示例项目 快速上手。

6.2 通用 Docker 环境使用

6.2.1 创建 Dockerfile

# 指定 Node.js 基础镜像版本
FROM balenalib/asus-tinker-board-alpine-node:latest
# 暴露应用默认端口（根据实际需求修改）
EXPOSE 8888

构建并运行镜像：

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

6.2.2 直接运行单文件 Node.js 脚本

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

$ docker run -it --rm \
  --name my-running-script \
  -v "$PWD":/usr/src/app \
  -w /usr/src/app \
  balenalib/asus-tinker-board-alpine-node:latest \
  node your-daemon-or-script.js

6.2.3 Docker Compose 配置示例

version: "2"
services:
  node:
    image: "balenalib/asus-tinker-board-alpine-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production  # Node.js 环境变量
      - UDEV=1               # 启用 udev 设备检测（如需）
    volumes:
      - ./:/home/node/app    # 挂载当前目录到容器工作目录
    expose:
      - "8081"               # 暴露应用端口
    command: "npm start"     # 启动命令

启动服务：

$ docker-compose up -d

7. 关键配置参数

7.1 环境变量

8. 用户反馈与支持

8.1 问题反馈

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

8.2 贡献指南

欢迎贡献新功能、修复或更新，建议先通过 GitHub Issues 讨论计划，以确保方向一致。

8.3 更多文档

• 基础镜像特性概述
• 运行时 vs 构建时变体说明
• Balena 基础镜像迁移指南