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 链接

版本标签	说明	Dockerfile 链接
`18.7.0 (latest)`	最新稳定版	GitHub 仓库
`16.17.0`	长期支持版	同上
`14.20.0`	长期支持版	同上
`12.22.12`	长期支持版	同上

6. 使用方法和配置说明

6.1 在 Balena 平台使用

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

6.2 通用 Docker 环境使用

6.2.1 创建 Dockerfile

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

构建并运行镜像：

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

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

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

bash
$ 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 配置示例

yaml
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"     # 启动命令

启动服务：