balenalib/intel-nuc-fedora-golang

balenalib/intel-nuc-fedora-golang 镜像文档

⚠️ 警告：已弃用

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

镜像概述和主要用途

该镜像属于 balena.io IoT 设备基础镜像系列，专为物联网场景优化设计。其核心用途是为基于 Intel NUC 硬件、运行 Fedora 系统的设备提供 Golang 开发和运行环境。该镜像已针对 balena.io 平台 和 balenaOS 操作系统 进行深度优化，但亦可在任何支持相应架构的 Docker 环境中使用。

核心功能与特性

1. install_packages 软件包安装脚本

提供实用的 install_packages 脚本，抽象了底层包管理器的细节，具备以下特性：

• 自动安装指定软件包，并最小化依赖（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试，提升可靠性

2. 动态设备支持

默认入口点定义为 ENTRYPOINT ["/usr/bin/entry.sh"]，支持动态插入设备：

• 通过设置环境变量 UDEV=1（即 ENV UDEV=1）启用 udev 支持
• 启用后将自动启动 udevd 守护进程，容器内 /dev 目录将动态生成设备节点

更多特性详情请参见 balena 基础镜像特性概述。

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体。run 变体专注于运行时环境，仅包含必要的运行时组件，镜像体积精简，适合生产环境部署。

:<version>-build

构建环境变体，包含大量源代码构建所需工具，减少 Dockerfile 中手动安装依赖的需求，从而降低系统中所有镜像的总体积。

关于变体的更多差异请参见 运行时与构建时镜像对比。

关于 Go 语言

Go（又称 Golang）是 Google 开发的编程语言，具有以下特点：

• 静态类型，语法借鉴 C 语言，同时提供垃圾回收、类型安全
• 支持动态类型能力、变长数组和键值映射等内置类型
• 拥有庞大的标准库，适合构建高效、可靠的软件系统

更多信息请参见 ***：Go (编程语言)。

支持版本及 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/intel-nuc/fedora/

镜像历史及更多信息可参见 https://github.com/balena-io-library/official-images/blob/master/library/intel-nuc-fedora-golang（位于 balena-io-library/official-images GitHub 仓库）。

使用方法

通过 Dockerfile 构建并运行 Go 应用

最直接的使用方式是将该镜像同时作为构建和运行环境。以下是典型的 Dockerfile 示例：

dockerfile
FROM balenalib/intel-nuc-fedora-golang:latest

WORKDIR /go/src/app
COPY . .

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

# 运行应用
CMD ["app"]

构建并运行镜像：

bash
# 构建镜像
$ docker build -t my-golang-app .
# 运行容器
$ docker run -it --rm --name my-running-app my-golang-app

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

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

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

• -v "$PWD":/usr/src/myapp：将当前目录挂载为容器内的 /usr/src/myapp 卷
• -w /usr/src/myapp：设置工作目录为挂载卷
• go build -v：执行编译命令，生成可执行文件 myapp（位于当前目录）

用户反馈与支持

问题报告

如遇镜像相关问题，请通过 https://github.com/balena-io-library/base-images/issues 提交反馈。

贡献指南

欢迎贡献新功能、修复或更新。建议在编码前通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以便其他贡献者提供指导或避免重复工作。

文档资源

• balena 基础镜像完整文档
• balenalib 新特性公告