balenalib/cl-som-imx8-debian 镜像文档

镜像概述和主要用途

本镜像为balena.io物联网平台基础镜像系列的一部分，专为物联网设备设计。该镜像针对balena.io平台和balenaOS操作系统进行了优化，但也可在任何运行适当架构的Docker环境中使用。

!balenalogo

核心功能和特性

balenalib基础镜像包含以下主要特性：

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

• 动态设备支持：每个balenalib基础镜像都默认设置了ENTRYPOINT ["/usr/bin/entry.sh"]。该入口点会检查UDEV环境变量是否设为true（通过添加ENV UDEV=1），若为true，则启动udevd守护进程，使相关设备节点出现在容器的/dev目录中。

更多详情，请查看文档中的功能概述。

镜像变体

balenalib镜像提供多种版本，适用于不同使用场景。

:<version> 或 :<version>-run

这是默认镜像。run变体设计为精简版本，仅包含运行时必需组件。

:<version>-build

构建变体是包含更多工具的较完整镜像，适用于从源代码构建应用，减少手动安装包的需求，从而减小系统中所有镜像的总体大小。

镜像变体详情

在Balena中使用本镜像

入门指南可帮助您开始使用此基础镜像，同时提供了一些示例项目，展示如何通过balena实现各种功能。

支持的版本及对应Dockerfile链接

bullseye (latest)、bookworm、buster、sid

有关此镜像及其历史的更多信息，请查看balena-io-library/official-images GitHub仓库中的相关清单文件 (cl-som-imx8-debian)。

如何使用本镜像

在应用项目中创建Dockerfile

dockerfile
FROM balenalib/cl-som-imx8-debian:latest
# 替换为您的应用代码

然后构建并运行Docker镜像：

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

用户反馈

问题反馈

如遇本镜像相关问题或疑问，请通过GitHub issue与我们联系。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们始终欢迎拉取请求，并会尽快处理。

在开始编码前，建议通过GitHub issue讨论您的计划，尤其是较复杂的贡献。这能让其他贡献者为您提供指导、反馈设计意见，并避免重复工作。

文档资源

本镜像文档存储在基础镜像文档中。您可在此查看所有基础镜像（包括针对Node.js、Python、Go等的专用镜像及更小体积的镜像）。

关于balenalib基础镜像新功能的更多详情，可查看此博客文章。