balenalib物联网设备Go语言基础镜像

镜像概述和主要用途

该镜像属于balena.io物联网设备基础镜像系列，专为balena.io平台和balenaOS系统优化，同时也可在任何适配架构的Docker环境中使用。作为基础镜像，它为物联网设备上的Go语言应用开发和运行提供了精简高效的环境支持。

核心功能和特性

1. 简化的包管理工具

内置install_packages脚本，抽象底层包管理器差异，具备以下特点：

• 自动安装依赖项最少的软件包（忽略可选依赖）
• 安装完成后清理包管理器元数据，减少镜像体积
• 支持安装失败时自动重试，提高稳定性

2. 动态设备支持

默认入口点为ENTRYPOINT ["/usr/bin/entry.sh"]，通过环境变量UDEV控制设备管理：

• 当设置ENV UDEV=1时，自动启动udevd守护进程
• 动态识别并加载容器内/dev目录中的设备节点，支持热插拔设备

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

镜像变体

:<version> 或 :<version>-run

默认镜像变体，采用精简设计，仅包含运行时必要组件，适用于生产环境部署。

:<version>-build

重型构建变体，集成大量源码构建工具，减少手动安装依赖的需求，有助于减小整体镜像体积。

了解更多变体差异请参考运行时与构建时镜像对比

与Balena平台配合使用

如需在balena平台上使用该基础镜像，可参考balena的入门指南和示例项目，快速了解实际应用场景。

关于Go语言

Go（又称Golang）是由Google开发的编程语言，属于静态类型语言，语法借鉴C语言，同时具备垃圾回收、类型安全、动态类型能力、内置变长数组和键值映射等特性，并拥有庞大的标准库。

来源：***.org/wiki/Go_(programming_language)

!Go语言logo

支持的版本及Dockerfile链接

• 1.12.9 (latest)、1.11.13、1.10.8
  Dockerfile地址

镜像历史及详细信息可查看***镜像清单文件（orange-pi-one-alpine-golang），位于balena-io-library/official-images GitHub仓库。

使用方法

在应用中启动Go实例

最直接的使用方式是将Go容器同时作为构建和运行环境。以下是Dockerfile示例：

dockerfile
FROM balenalib/orange-pi-one-alpine-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

在Docker容器内编译应用

如需仅编译而非运行应用，可使用以下命令：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/orange-pi-one-alpine-golang:latest go build -v

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

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。建议在编码前通过GitHub Issue讨论计划，以便其他贡献者提供指导和反馈。

文档资源

• 基础镜像完整列表及专业变体（如node、python等）请参考balena基础镜像文档
• 了解balenalib基础镜像新特性请查看博客文章