balenalib/colibri-imx6dl-ubuntu

balenalib/colibri-imx6dl-ubuntu 镜像文档

!balenalogo

镜像概述和主要用途

该镜像属于 https://balena.io/?ref=dockerhub IoT设备基础镜像系列，专为balena.io平台和https://www.balena.io/os/?ref=dockerhub优化，同时也可在任何支持相应架构的Docker环境中使用。作为基础镜像，它为IoT设备应用开发提供了精简且功能完善的运行环境。

核心功能和特性

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

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

• 动态设备插拔支持：每个 balenalib 基础镜像都默认设置 ENTRYPOINT ["/usr/bin/entry.sh"]。通过设置 ENV UDEV=1 环境变量，该入口脚本会启动 udevd 守护进程，使容器内 /dev 目录能自动识别并显示动态插入的设备节点。

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

镜像变体

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

:<version> 或 :<version>-run

这是默认镜像变体。run 变体设计为精简版本，仅包含运行时必需组件，适合部署生产环境应用。

:<version>-build

构建变体是包含更多工具的重量级镜像，预装了从源代码构建所需的多种工具。这减少了Dockerfile中手动安装包的需求，从而减小系统中所有镜像的总体大小。

使用场景和适用范围

• IoT设备应用开发和部署
• 需要与硬件设备交互的容器化应用
• 基于balena.io平台的项目开发
• 跨架构Docker环境中的基础镜像

使用方法和配置说明

与Balena平台配合使用

https://www.balena.io/docs/learn/getting-started/colibri-imx6dl/nodejs/?ref=dockerhub 可帮助您开始使用此基础镜像与balena平台，同时还有一些 https://www.balena.io/docs/learn/getting-started/colibri-imx6dl/nodejs/#example-projects?ref=dockerhub 展示了balena平台的应用可能性。

支持的版本及Dockerfile链接

https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/colibri-imx6dl/ubuntu/

有关此镜像及其历史的更多信息，请参阅 https://github.com/balena-io-library/official-images 中的 https://github.com/balena-io-library/official-images/blob/master/library/colibri-imx6dl-ubuntu%E3%80%82

基本使用方法

在应用项目中创建Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/colibri-imx6dl-ubuntu:latest
# 在此处添加您的应用代码

构建并运行Docker镜像

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

启用设备动态插拔支持

要启用udevd守护进程以支持动态设备识别，需在Dockerfile中设置UDEV环境变量：

dockerfile
FROM docker.xuanyuan.run/balenalib/colibri-imx6dl-ubuntu:latest
ENV UDEV=1
# 应用代码...

用户反馈

问题反馈

如对本镜像有任何问题或疑问，请通过 https://github.com/balena-io-library/base-images/issues 与我们联系。

贡献指南

我们欢迎您贡献新功能、修复或更新（无论大小）。我们始终乐于接收拉取请求，并会尽最大努力快速处理。

在开始编码之前，建议通过 https://github.com/balena-io-library/base-images/issues 讨论您的计划，尤其是对于更复杂的贡献。这使其他贡献者有机会为您指明方向，提供设计反馈，并帮助您了解是否有其他人正在处理相同的问题。

文档资源

本镜像的文档存储在 https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub 中。其中包含所有基础镜像的列表，包括许多专用镜像（如node、python、go以及更小的镜像等）。

您还可以在 https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub 中找到 balenalib 基础镜像新功能的更多详细信息。