该镜像属于balena.io物联网设备基础镜像系列,专为balena.io平台和balenaOS系统优化,同时也可在其他支持相应架构的Docker环境中使用。作为基础镜像,它为物联网应用开发提供了精简且功能完善的运行环境。
!balenalogo
balenalib基础镜像具有以下显著特性:
便捷的包安装脚本:提供install_packages工具,抽象了底层包管理器的细节,可安装指定软件包并最小化依赖(忽略可选依赖),自动清理包管理器元数据,并在安装失败时重试。
动态设备支持:默认ENTRYPOINT为/usr/bin/entry.sh,通过设置ENV UDEV=1可启用udevd守护进程,使容器内/dev目录能动态识别和显示外接设备节点。
更多特性详情,请查看功能概述文档。
balenalib镜像提供多种变体,适用于不同使用场景:
:<version> 或 :<version>-run这是默认镜像变体。run变体设计为精简版本,仅包含运行时必需组件,体积小巧。
:<version>-build构建变体是包含更多工具的重量级镜像,预安装了从源代码构建所需的多种工具,减少Dockerfile中手动安装包的需求,从而减小系统中所有镜像的总体积。
了解更多关于运行时与构建变体的区别,请参见运行时与构建变体。
适用于物联网设备应用开发,特别是基于balena.io平台和balenaOS系统的项目。可作为各类物联网应用的基础镜像,支持从简单运行时环境到复杂构建环境的多种需求。
参考快速入门指南了解如何将此基础镜像与balena平台配合使用。同时,可查看示例项目获取实际应用案例。
bionic (latest)、cosmic、artful、xenial、trusty关于镜像及其历史的更多信息,请查看https://github.com/balena-io-library/official-images/blob/master/library/stem-x86-32-ubuntu%E3%80%82
在应用项目中创建Dockerfile
dockerfileFROM balenalib/stem-x86-32-ubuntu:latest # 替换为你的应用代码
构建并运行镜像
console$ docker build -t my-app . $ docker run -it --rm --name my-running-app my-app
如遇到与镜像相关的问题或疑问,请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC%E3%80%82
欢迎贡献新功能、修复或更新(无论大小)。我们鼓励在开始编码前,通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E4%BD%A0%E7%9A%84%E8%AE%A1%E5%88%92%EF%BC%8C%E7%89%B9%E5%88%AB%E6%98%AF%E5%AF%B9%E4%BA%8E%E8%BE%83%E5%A4%8D%E6%9D%82%E7%9A%84%E8%B4%A1%E7%8C%AE%EF%BC%8C%E8%BF%99%E6%9C%89%E5%8A%A9%E4%BA%8E%E5%85%B6%E4%BB%96%E8%B4%A1%E7%8C%AE%E8%80%85%E6%8F%90%E4%BE%9B%E6%8C%87%E5%AF%BC%E5%92%8C%E5%8F%8D%E9%A6%88%E3%80%82
镜像文档存储在基础镜像文档中,包含所有balenalib基础镜像(如node、python、go专用镜像及更小体积镜像等)的详细信息。
关于balenalib基础镜像新特性的更多详情,可查看博客文章。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务