balenalib/qemux86-ubuntu

balenalib/qemux86-ubuntu 镜像文档

镜像概述

该镜像属于balena.io的IoT设备基础镜像系列，专为物联网设备优化。主要用于balena.io平台和balenaOS系统，但也可在任何适配架构的Docker环境中使用。

!balenalogo

核心功能与特性

1. 简化的包管理工具

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

2. 动态设备支持

• 默认ENTRYPOINT为["/usr/bin/entry.sh"]，通过UDEV环境变量控制设备管理：
  • 设置ENV UDEV=1时，自动启动udevd守护进程，使容器内/dev目录能动态显示外部接入的设备节点。

更多特性详见官方文档。

镜像变体

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时环境，仅包含必要的运行时依赖，适合直接部署应用。

:<version>-build

包含大量源码构建工具的重型镜像，减少Dockerfile中手动安装的依赖包数量，从而降低系统中所有镜像的总体积。

了解更多变体差异

在Balena中使用

• 快速入门指南：帮助首次使用该基础镜像的用户上手。
• 示例项目：提供实际应用案例，展示基于balena的项目实现方式。

使用方法

创建应用的Dockerfile

dockerfile
FROM balenalib/qemux86-ubuntu:latest
# 在此处添加应用代码

构建并运行镜像

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

支持的版本及Dockerfile链接

• jammy (latest)、focal、impish、xenial、bionic、kinetic
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/qemux86/ubuntu/

镜像历史及更多信息，参见https://github.com/balena-io-library/official-images/blob/master/library/qemux86-ubuntu%E3%80%82

用户反馈

问题反馈

如遇问题或疑问，请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E3%80%82

贡献代码

欢迎贡献新功能、修复或更新。建议先通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E7%A1%AE%E4%BF%9D%E6%96%B9%E5%90%91%E4%B8%80%E8%87%B4%E3%80%82

文档

基础镜像完整文档见官方文档，新特性说明见博客文章。