balenalib/surface-go Docker 镜像 - 轩辕镜像

balenalib/surface-go-debian 镜像文档

镜像概述和主要用途

该镜像属于 balena.io IoT设备基础镜像系列，专为物联网设备优化。虽然针对 balena.io 和 balenaOS 进行了优化，但也可在适当架构的任何Docker环境中使用。

!balenalogo

核心功能和特性

balenalib 基础镜像的主要特性包括：

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

• 动态设备支持：每个 balenalib 基础镜像默认 ENTRYPOINT 为 ENTRYPOINT ["/usr/bin/entry.sh"]。通过设置 ENV UDEV=1 可启用 UDEV 功能，此时会启动 udevd 守护进程，使容器内 /dev 目录能识别动态插入的设备节点。

更多详情请查看 特性概述 文档。

镜像变体

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

:<version> 或 :<version>-run

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

:<version>-build

构建变体是包含更多源码构建工具的较完整镜像，减少Dockerfile中手动安装的包数量，从而减小系统中所有镜像的总体大小。

了解更多变体差异

使用场景和适用范围

适用于基于balena.io平台开发IoT应用，尤其适合需要便捷包管理、动态设备识别或源码构建的场景。可作为各类IoT应用的基础镜像，支持从简单运行时环境到复杂构建流程的需求。

详细使用方法和配置说明

与Balena一起使用

入门指南 可帮助您开始使用该基础镜像，同时提供了 示例项目 展示balena平台的应用可能性。

支持的版本及Dockerfile链接

• bullseye (latest)
• bookworm
• buster
• sid

有关镜像及其历史的更多信息，请查看 相关清单文件 (surface-go-debian)（位于 balena-io-library/official-images GitHub仓库）。

基本使用示例

1. 创建应用项目的Dockerfile

dockerfile
FROM balenalib/surface-go-debian:latest
# 在此处添加您的应用代码

2. 构建并运行Docker镜像

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

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们始终期待收到拉取请求，并会尽快处理。建议在编码前通过 GitHub issue 讨论您的计划，以便其他贡献者提供指导和反馈。

文档资源

镜像详细文档请参见 基础镜像文档，包含所有balenalib基础镜像（如node、python、go专项镜像及精简镜像）的信息。新特性详情可查看 博客文章。