balenalib/beaglebone-green-alpine

balenalib/beaglebone-green-alpine 镜像文档

⚠️ 已弃用

该基础镜像已弃用，将不再接收更新。请阅读公告文章获取迁移指南和建议的替代方案。

镜像概述与主要用途

本镜像属于 balena.io IoT 设备基础镜像系列，专为物联网设备优化设计。其核心用途是作为基于 BeagleBone Green 硬件的容器化应用基础环境，默认针对 balena.io 平台和 balenaOS 进行了优化，但也可在支持相应架构的任何 Docker 环境中使用。

核心功能与特性

1. install_packages 包管理脚本

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

2. 动态设备支持

• 默认 ENTRYPOINT：ENTRYPOINT ["/usr/bin/entry.sh"]，负责设备动态挂载管理。
• UDEV 支持：通过设置环境变量 UDEV=1，可启动 udevd 守护进程，使容器内 /dev 目录自动识别并创建动态插入的设备节点。

使用场景与适用范围

• 适用场景：原用于基于 BeagleBone Green 硬件的 IoT 应用开发与部署，支持设备驱动动态加载、轻量级运行时环境构建。
• 注意：由于镜像已弃用，当前不建议用于新项目，存量项目应参考迁移指南切换至替代方案。

镜像变体

:<version> 或 :<version>-run

• 定位：默认镜像变体，精简的运行时版本。
• 特性：仅包含应用运行所需的核心依赖，体积最小化，适合生产环境部署。

:<version>-build

• 定位：构建专用变体。
• 特性：包含大量源码构建工具（如编译器、链接器等），减少 Dockerfile 中手动安装构建依赖的需求，从而降低整体镜像体积。

使用方法与配置说明

结合 Balena 平台使用

• 入门指南：参考 Balena 入门文档 了解如何结合本镜像开发应用。
• 示例项目：通过 Balena 示例项目 了解实际应用场景。

Dockerfile 示例

dockerfile
# 使用最新版本（已弃用，仅作示例）
FROM balenalib/beaglebone-green-alpine:latest

# 在此添加应用代码与依赖安装步骤
# 例如：使用 install_packages 安装依赖
# RUN install_packages python3

构建与运行命令

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

# 运行容器（如需启用 UDEV 支持，添加 -e UDEV=1）
$ docker run -it --rm --name my-running-app -e UDEV=1 my-app

配置参数

支持的版本及 Dockerfile 链接

• 3.21 (latest)、3.20、3.19、3.18、3.17、3.16、3.15、3.14、3.13、3.12、edge
  源码链接：https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/beaglebone-green/alpine/

用户反馈

问题反馈

如遇使用问题，请通过 https://github.com/balena-io-library/base-images/issues 提交。

贡献指南

欢迎贡献新功能、修复或更新。建议先通过 https://github.com/balena-io-library/base-images/issues 讨论计划，再提交 Pull Request。

相关文档

• Balena 基础镜像特性概述
• 镜像变体详细说明（运行时 vs 构建时）
• 迁移指南与新特性说明