balenalib/spacely-tx2-alpine-node

balenalib/spacely-tx2-alpine-node 镜像文档

镜像概述

该镜像属于balena.io物联网设备基础镜像系列的一部分，专为物联网设备优化，可与balena.io平台和balenaOS无缝集成，同时也适用于任何支持相应架构的Docker环境。

!balenalogo

核心功能与特性

1. 简化的包管理

• 提供install_packages工具脚本，抽象底层包管理器差异，自动处理：
  • 最小化依赖安装（忽略可选依赖）
  • 自动清理包管理器元数据
  • 安装失败时自动重试

2. 动态设备支持

• 默认入口点ENTRYPOINT ["/usr/bin/entry.sh"]，通过环境变量UDEV=1控制：
  • 启用时自动启动udevd守护进程
  • 动态识别并创建容器/dev目录中的设备节点

更多特性详情请参见官方特性概述

镜像变体

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

• 精简版镜像，仅包含运行时必需组件
• 优化镜像体积，适合生产环境部署

:<version>-build

• 包含完整构建工具链的开发版镜像
• 预安装源码编译所需工具，减少手动依赖配置
• 降低构建阶段的镜像体积膨胀

变体详细说明

在Balena平台使用

入门指南

参考Balena基础镜像使用指南快速上手，或通过示例项目了解实际应用场景。

Node.js简介

Node.js是一个基于Chrome V8引擎的JavaScript运行时，用于构建可扩展的服务器端和网络应用程序：

• 采用非阻塞I/O模型，支持异步事件驱动编程
• 单线程执行模型，通过事件循环高效处理并发请求
• 内置HTTP模块，可直接作为Web服务器运行
• 跨平台兼容，支持Windows、macOS和Linux系统

更多信息：***Node.js条目

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/node/logo.png

支持版本与Dockerfile

支持的Node.js版本

• 12.10.0 (latest)
• 12.9.1
• 11.15.0
• 10.16.3
• 9.11.2
• 8.16.1
• 6.17.1

https://github.com/balena-io-library/base-images/tree/master/balena-base-images/node/spacely-tx2/alpine/

镜像元数据

• https://github.com/balena-io-library/official-images/blob/master/library/spacely-tx2-alpine-node
• https://github.com/balena-io-library/official-images

使用方法

基础Dockerfile配置

dockerfile
# 指定基础镜像版本
FROM balenalib/spacely-tx2-alpine-node:latest
# 暴露应用端口
EXPOSE 8888

构建并运行：

bash
# 构建镜像
docker build -t my-node-app .

# 运行容器
docker run -it --rm --name my-running-app my-node-app

Docker Compose配置

yaml
version: "2"
services:
  node:
    image: "balenalib/spacely-tx2-alpine-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production
    volumes:
      - ./:/home/node/app
    expose:
      - "8081"
    command: "npm start"

启动服务：

bash
docker-compose up -d

注：该配置假设项目根目录包含package.json文件，并定义了start脚本。

直接运行单文件脚本

bash
docker run -it --rm \
  --name my-running-script \
  -v "$PWD":/usr/src/app \
  -w /usr/src/app \
  balenalib/spacely-tx2-alpine-node:latest \
  node your-script.js

用户反馈

问题报告

通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4bug%E6%8A%A5%E5%91%8A%E6%88%96%E5%8A%9F%E8%83%BD%E5%BB%BA%E8%AE%AE%E3%80%82

贡献指南

欢迎提交PR贡献代码，建议先通过Issue讨论重大变更，以确保与项目方向一致。

文档资源

• Balena基础镜像文档
• balenalib新特性介绍