balenalib/ts4900

balenalib/ts4900-debian 镜像文档

镜像概述和主要用途

该镜像属于balena.io的IoT设备基础镜像系列，专为物联网设备优化设计。它特别适用于balena.io平台和balenaOS系统，但也可在任何支持相应架构的Docker环境中使用。作为balenalib基础镜像的一部分，它提供了针对物联网应用的关键功能和工具，简化设备上的应用部署和管理。

核心功能和特性

balenalib基础镜像具有以下显著特性：

• 便捷的包安装脚本：提供install_packages脚本，抽象底层包管理器细节。以最少依赖（忽略可选依赖）安装指定包，自动清理包管理器元数据，并在安装失败时重试。

• 动态设备支持：默认入口点为ENTRYPOINT ["/usr/bin/entry.sh"]。通过设置ENV UDEV=1启用UDEV标志后，会启动udevd守护进程，使容器内/dev目录中动态出现相关设备节点，支持热插拔设备。

更多详细特性，请查看https://www.balena.io/docs/reference/base-images/base-images/#features-overview。

镜像变体

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

:<version> 或 :<version>-run

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

:<version>-build

构建变体，包含完整的构建工具链，适用于从源代码构建应用，减少手动安装依赖的需求，从而减小整体镜像大小。

https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

使用场景和适用范围

适用于物联网设备应用的开发与部署，尤其适合基于balena.io平台和balenaOS的项目。无论是生产环境的精简运行时部署，还是开发阶段的完整构建需求，均可通过选择相应变体满足。

使用方法和配置说明

与Balena平台配合使用

https://www.balena.io/docs/learn/getting-started/ts4900/nodejs/?ref=dockerhub可帮助快速上手，https://www.balena.io/docs/learn/getting-started/ts4900/nodejs/#example-projects?ref=dockerhub展示了基于balena的应用案例。

支持的版本及Dockerfile链接

• buster (latest)、jessie、stretch、sid：https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/ts4900/debian/

镜像历史及详细信息可查看https://github.com/balena-io-library/official-images/blob/master/library/ts4900-debian。

基础使用示例

创建Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/ts4900-debian:latest
# 在此添加应用代码和配置

构建并运行容器

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

用户反馈

问题反馈

如遇问题或疑问，请通过https://github.com/balena-io-library/base-images/issues提交。

贡献指南

欢迎贡献新功能、修复或更新。建议先通过https://github.com/balena-io-library/base-images/issues讨论计划，再提交Pull Request。

相关文档

完整文档请参见https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub，balenalib新特性详情可查看https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub。