balenalib 基础镜像文档

镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列的一部分，专为 IoT 设备开发优化。它与 balena.io 平台和 balenaOS 系统深度兼容，同时也可在其他支持相应架构的 Docker 环境中使用。

核心功能和特性

1. install_packages 包管理脚本

• 功能：抽象底层包管理器差异，简化软件包安装流程。
• 特性：
  • 最小化依赖：仅安装必要依赖，忽略可选依赖。
  • 自动清理：安装后清理包管理器元数据，减少镜像体积。
  • 重试机制：安装失败时自动重试，提升稳定性。

2. 动态设备支持（UDEV）

• 默认入口点：镜像默认入口点为 ENTRYPOINT ["/usr/bin/entry.sh"]。
• UDEV 激活：通过设置环境变量 ENV UDEV=1 启用 udev 服务：
  • 自动启动 udevd 守护进程。
  • 容器内 /dev 目录会动态生成对应设备节点，支持外接设备（如传感器、USB 设备等）在容器中被识别。

更多功能详情参见 官方文档功能概述。

镜像变体

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

:<version> 或 :<version>-run

• 定位：默认基础镜像，精简的运行时变体。
• 特性：仅包含运行时必需组件，体积小巧，适合生产环境部署。

:<version>-build

• 定位：构建环境变体，包含源码编译所需工具链。
• 特性：减少手动安装构建依赖的需求，降低整体镜像构建链的体积。

变体差异详情参见 官方文档：运行时 vs 构建时。

使用场景和适用范围

适用场景

• IoT 设备运行时：使用 :<version>-run 变体作为 IoT 应用的生产环境，提供精简高效的运行时。
• 源码构建环境：使用 :<version>-build 变体进行应用编译，避免手动安装大量构建工具。
• balena 平台开发：与 balena.io 平台和 balenaOS 配合，加速 IoT 项目开发、部署和管理。

使用方法和配置说明

与 Balena 平台配合使用

• 入门指南：参考 balena 入门指南 快速上手。
• 示例项目：查看 官方示例项目 了解实际应用场景。

基础使用示例

1. 通过 Dockerfile 构建并运行应用

以下示例使用默认运行时变体构建一个 Go 应用：

FROM balenalib/raspberrypi3-debian-golang:latest

WORKDIR /go/src/app
COPY . .

# 安装依赖并编译应用
RUN go get -d -v ./...
RUN go install -v ./...

# 运行应用
CMD ["app"]

构建并运行镜像：

# 构建镜像
docker build -t my-golang-app .

# 启动容器
docker run -it --rm --name my-running-app my-golang-app

2. 在容器内编译应用（仅编译不运行）

如需仅在容器内编译应用（不运行），可通过以下命令挂载本地目录并执行编译：

docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/raspberrypi3-debian-golang:latest go build -v

• 说明：
  • -v "$PWD":/usr/src/myapp：将当前目录挂载到容器内 /usr/src/myapp。
  • -w /usr/src/myapp：设置工作目录为挂载目录。
  • go build -v：执行编译，输出可执行文件到当前目录。

支持的版本及 Dockerfile 链接

镜像历史及更多详情可参考 官方镜像清单。

用户反馈

问题反馈

如遇使用问题或疑问，可通过 GitHub Issues 提交。

贡献指南

欢迎提交新功能、修复或更新（无论大小）。建议在开发前通过 GitHub Issues 讨论计划，以确保方向一致。

参考链接

• balena.io 官方网站
• balenaOS 系统文档
• 基础镜像文档
• 镜像变体详情