balenalib/artik533s-fedora-node

balenalib/artik533s-fedora-node镜像说明

镜像概述

本镜像属于balena.io IoT设备基础镜像系列，专为Artik533s平台设计，基于Fedora系统和Node.js环境。它优化适配balenaOS，同时也支持在其他兼容架构的Docker环境中运行，旨在简化IoT应用的开发与部署流程。

核心功能

1. 便捷包安装工具：内置install_packages脚本，抽象底层包管理器差异，最小化依赖安装，自动清理元数据并支持安装重试。
2. 动态设备支持：默认ENTRYPOINT脚本会检查UDEV环境变量，若设置为1则启动udevd守护进程，使容器/dev目录自动识别并加载动态插入的设备节点。
3. 多变体选择：提供两种镜像变体：
   • :<version>/:<version>-run：轻量运行时版本，仅包含必要依赖。
   • :<version>-build：包含构建工具的版本，减少手动安装依赖的需求。

使用场景

1. 基于Artik533s设备的Node.js IoT应用开发与部署。
2. 需要动态管理外设的IoT服务构建（如传感器、外设接入）。
3. 在balenaOS环境下快速部署Node.js应用，利用balena.io平台的设备管理能力。

配置说明

• 启用UDEV支持：在Dockerfile中添加ENV UDEV=1，可启用容器内的动态设备识别。
• 选择版本变体：根据需求选择run（运行时）或build（构建）变体，例如balenalib/artik533s-fedora-node:18.7.0-build。

部署示例

Dockerfile示例

dockerfile
# 指定Node.js版本
FROM docker.xuanyuan.run/balenalib/artik533s-fedora-node:latest
# 暴露应用端口
EXPOSE 8888

构建与运行

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

Docker Compose示例

yaml
version: "2"
services:
  node:
    image: "docker.xuanyuan.run/balenalib/artik533s-fedora-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production
      - UDEV=1
    volumes:
      - ./:/home/node/app
    expose:
      - "8081"
    command: "npm start"

运行命令：

console
$ docker-compose up -d

单脚本运行

console
$ docker run -it --rm --name running-script -v "$PWD":/usr/src/app -w /usr/src/app balenalib/artik533s-fedora-node:latest node your-script.js

用户反馈

问题反馈

若遇到镜像相关问题，可通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E3%80%82

贡献指南

欢迎通过GitHub Pull Request贡献功能或修复，建议先通过Issues讨论需求方向。

文档参考

更多详情请查看https://www.balena.io/docs/reference/base-images/base-images/%E3%80%82