balenalib/surface-go-fedora-golang

balenalib/surface-go-fedora-golang 镜像文档（已弃用）

弃用通知

⚠️ 此基础镜像已被弃用，将不再接收更新。 请阅读https://blog.balena.io/deprecate-balenalib-images/%E8%8E%B7%E5%8F%96%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97%E5%92%8C%E5%BB%BA%E8%AE%AE%E7%9A%84%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

镜像概述和主要用途

该镜像属于 https://balena.io/?ref=dockerhub IoT 设备基础镜像系列，专为物联网场景优化。其设计初衷是配合 https://balena.io/?ref=dockerhub 和 https://www.balena.io/os/?ref=dockerhub 使用，但也可在任何对应架构的 Docker 环境中运行。

核心功能和特性

install_packages 脚本

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

动态设备支持

• 每个 balenalib 基础镜像默认定义 ENTRYPOINT ["/usr/bin/entry.sh"]。
• 该入口脚本会检查 UDEV 环境变量是否设置为 true（通过添加 ENV UDEV=1）：
  • 若设置为 true，则启动 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 中手动安装的包数量，从而降低系统中所有镜像的总体积。

https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

使用场景和适用范围

• 原适用场景：适用于在 IoT 设备（如 Surface Go）上开发和运行基于 Go 语言的应用，尤其适合需要动态设备接入（如 USB 设备、传感器）的场景。
• 现状说明：由于该镜像已弃用，建议根据 https://blog.balena.io/deprecate-balenalib-images/ 切换至替代方案。

使用方法和配置说明

Dockerfile 示例（构建并运行应用）

以下 Dockerfile 示例演示如何使用该镜像作为构建和运行环境：

dockerfile
FROM docker.xuanyuan.run/balenalib/surface-go-fedora-golang:latest

WORKDIR /go/src/app
COPY . .

RUN go get -d -v ./...
RUN go install -v ./...

CMD ["app"]

构建并运行镜像：

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

在容器内编译应用

若仅需编译而非运行应用，可通过以下命令在容器内完成编译：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/surface-go-fedora-golang:latest go build -v

• 该命令将当前目录挂载为容器卷，设置工作目录为该卷，并执行 go build 编译项目，输出可执行文件至当前目录。

配置说明：UDEV 环境变量

• 作用：控制容器内是否启动 udevd 守护进程以支持动态设备节点。
• 设置方式：在 Dockerfile 中添加 ENV UDEV=1，或运行容器时通过 -e UDEV=1 指定。
• 示例：

  dockerfile
  FROM docker.xuanyuan.run/balenalib/surface-go-fedora-golang:latest
  ENV UDEV=1  # 启用 udevd 守护进程
  

支持的版本及 Dockerfile 链接

• 1.20.1 (latest)、1.19.6、1.18.10
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/surface-go/fedora/

镜像历史及更多信息可查看 https://github.com/balena-io-library/official-images/blob/master/library/surface-go-fedora-golang%E3%80%82

用户反馈

问题报告

如遇镜像相关问题，请通过 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
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub