balenalib/spacely-tx2-ubuntu

⚠️ 已弃用

此基础镜像已弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/%E4%BA%86%E8%A7%A3%E8%BF%81%E7%A7%BB%E6%8C%87%E5%AF%BC%E5%92%8C%E5%BB%BA%E8%AE%AE%E7%9A%84%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

镜像概述和主要用途

本镜像属于https://balena.io/?ref=dockerhub IoT设备基础镜像系列，专为物联网（IoT）设备设计。该镜像针对https://balena.io/?ref=dockerhub平台和https://www.balena.io/os/?ref=dockerhub进行了深度优化，同时也可在其他支持相应架构的Docker环境中使用。

核心功能和特性

balenalib基础镜像具备以下关键特性：

• install_packages脚本：抽象底层包管理器差异的实用工具，可自动安装指定软件包并最小化依赖（忽略可选依赖），安装后清理包管理器元数据，并在安装失败时自动重试。

• 动态设备支持：默认ENTRYPOINT为["/usr/bin/entry.sh"]。通过设置UDEV=1环境变量，可触发udevd守护进程启动，使动态插入的设备节点（如USB设备、传感器）在容器/dev目录中自动生成并可用。

更多特性详情请参见https://www.balena.io/docs/reference/base-images/base-images/#features-overview%E3%80%82

镜像变体

balenalib镜像提供以下主要变体，适用于不同场景：

:<version> 或 :<version>-run

默认镜像变体，为精简的运行时环境，仅包含应用运行必需的组件，体积最小化。

:<version>-build

构建专用变体，包含完整的源代码构建工具链（如编译器、链接器等），减少手动安装构建依赖的需求，从而优化整体镜像体积。

使用场景和适用范围

• IoT设备应用的开发、测试与部署。
• 基于balena.io平台或balenaOS的嵌入式系统开发。
• 需要动态管理外部设备（如传感器、外设）的容器化应用。
• 对镜像体积敏感的生产环境（选用-run变体）或需要构建环节的开发环境（选用-build变体）。

使用方法和配置说明

基本使用（通用Docker环境）

创建Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/spacely-tx2-ubuntu:latest
# 在此添加应用代码和依赖安装逻辑

构建并运行容器

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

启用动态设备支持

如需容器识别动态插入的设备，需设置UDEV环境变量：

dockerfile
# 在Dockerfile中设置
ENV UDEV=1

或运行时指定：

console
$ docker run -it --rm --name my-running-app -e UDEV=1 my-iot-app

与Balena平台集成

• https://www.balena.io/docs/learn/getting-started/spacely-tx2/nodejs/?ref=dockerhub：了解如何结合Balena平台使用此基础镜像。
• https://www.balena.io/docs/learn/getting-started/spacely-tx2/nodejs/#example-projects?ref=dockerhub：提供基于Balena的应用开发参考实例。

支持的版本

镜像历史及元数据详情可查看https://github.com/balena-io-library/official-images/blob/master/library/spacely-tx2-ubuntu%E3%80%82

用户反馈

问题反馈

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

贡献指南

欢迎通过Pull Request贡献代码（功能、修复或更新）。建议重大变更前先通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%BE%E8%AE%A1%E6%96%B9%E6%A1%88%E3%80%82

文档资源

• https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub