balenalib/beaglebone-green-wifi-fedora

balenalib/beaglebone-green-wifi-fedora 基础镜像

镜像概述

balenalib/beaglebone-green-wifi-fedora 是 https://balena.io 针对物联网 (IoT) 设备推出的基础镜像系列之一，专为 BeagleBone Green WiFi 硬件平台设计并基于 Fedora 操作系统构建。该镜像针对 balena.io 平台和 https://www.balena.io/os/ 进行了深度优化，同时也完全兼容运行在相应硬件架构上的任何标准 Docker 环境。

核心功能与特性

balenalib 基础镜像内置了多项专为 IoT 和边缘计算场景设计的实用特性：

• 智能包管理脚本 (install_packages)： 提供便捷的包安装脚本，抽象了底层包管理器的具体差异。该脚本在安装指定软件包时会自动忽略可选依赖以最小化依赖数量，安装完成后自动清理包管理器元数据，并在安装失败时自动重试，从而有效减小镜像体积并提高构建稳定性。

• 动态热插拔设备支持 (UDEV)： 每个 balenalib 基础镜像均配置了默认入口点 ENTRYPOINT ["/usr/bin/entry.sh"]。该脚本会检查 UDEV 环境变量的值。如果将其设置为 1（通过 ENV UDEV=1），容器启动时将自动运行 udevd 守护进程，使得动态插入的物理设备节点能够正确映射并显示在容器的 /dev 目录中。

镜像变体

该镜像提供多种变体（Tag），以满足不同阶段的开发与部署需求：

• :<version> 或 :<version>-run（运行版）： 默认推荐的镜像变体。专为生产环境设计，仅包含运行应用程序所必需的最小化运行时组件，体积精简。

• :<version>-build（构建版）： 体积较大的镜像变体，预装了从源码编译和构建应用程序所需的各类工具链。使用此变体可以减少在 Dockerfile 中手动安装构建工具的步骤，从而优化整体开发体验。

使用场景与适用范围

• 物联网 (IoT) 设备开发：为 BeagleBone Green WiFi 等单板计算机提供标准化的应用运行环境。
• 边缘计算节点：在靠近数据源的网络边缘部署容器化应用，处理实时数据。
• balenaOS 生态集成：作为 balenaCloud 或开源 balenaOS 环境中的基础应用容器。

详细使用方法与配置说明

环境变量配置

Dockerfile 示例

在您的应用项目根目录创建一个 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/balenalib/beaglebone-green-wifi-fedora:latest

# 设置 UDEV 以支持动态设备（按需开启）
ENV UDEV=1

# 使用内置脚本安装依赖（示例）
RUN install_packages python3 python3-pip

# 复制应用代码
COPY . /app
WORKDIR /app

# 替换为您的应用启动命令
CMD ["python3", "main.py"]

构建与运行

使用以下命令构建并运行 Docker 镜像：

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

# 运行容器（如需访问硬件设备，请添加 --privileged 或映射具体设备）
docker run -it --rm --name my-running-app --privileged docker.xuanyuan.run/my-beaglebone-app

Docker Compose 部署示例

对于复杂的应用场景，可以使用 docker-compose.yml 进行编排：

yaml
version: '3.8'

services:
  app:
    build: .
    image: docker.xuanyuan.run/my-beaglebone-app
    container_name: beaglebone_app
    privileged: true
    environment:
      - UDEV=1
    volumes:
      - /dev:/dev
    restart: unless-stopped

支持的版本

当前支持的 Fedora 版本及对应的 Dockerfile 源码链接：

• 36
• 35 (latest)
• 34
• 33

更多版本历史与清单信息，请参阅 https://github.com/balena-io-library/official-images 仓库中的 beaglebone-green-wifi-fedora 清单文件。

问题反馈与贡献

• 问题反馈：如果您在使用该镜像时遇到任何问题或有疑问，请通过 https://github.com/balena-io-library/base-images/issues 提交反馈。
• 参与贡献：欢迎提交新功能、修复或更新。在开始编写代码前，建议先通过 GitHub Issue 讨论您的计划，以便获取设计反馈并避免重复工作。
• 官方文档：更多关于 balenalib 基础镜像（包括 Node.js、Python、Go 等特定语言镜像）的详细说明，请参阅 https://www.balena.io/docs/reference/base-images/base-images/%E3%80%82