balenalib/qemux86-golang

balenalib Golang 基础镜像

镜像概述和主要用途

本镜像属于balena.io IoT设备基础镜像系列，专为物联网场景优化，兼容balena.io平台和balenaOS操作系统，同时可在其他Docker环境中运行。基于Golang开发环境，提供精简高效的运行时和构建工具，支持IoT设备上Golang应用的开发、编译与部署。

核心功能和特性

便捷的包管理工具

• install_packages脚本：抽象底层包管理器差异，自动以最小依赖安装指定包（忽略可选依赖），清理包管理器元数据，并在安装失败时自动重试，简化系统依赖配置。

动态设备接入支持

• 默认ENTRYPOINT为/usr/bin/entry.sh，通过设置环境变量UDEV=1可启用udevd守护进程，实现容器内/dev目录设备节点的动态创建，支持外部设备热插拔。

更多特性详情参见https://www.balena.io/docs/reference/base-images/base-images/#features-overview

镜像变体

:<version> 或 :<version>-run

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

:<version>-build

包含完整构建工具链的重型变体，预置源码编译所需工具，减少手动安装依赖步骤，有助于减小整体镜像体积。

了解更多变体差异：https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

使用场景和适用范围

• IoT设备上Golang应用的开发、测试与生产部署
• 需要跨balenaOS及其他Docker环境运行的Golang项目
• 需简化系统包管理或处理动态接入硬件设备的场景

如何使用本镜像

在应用中启动Go实例

通过Dockerfile将本镜像同时用作构建和运行环境，示例如下：

dockerfile
FROM docker.xuanyuan.run/balenalib/qemux86-debian-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/qemux86-debian-golang:latest go build -v

支持版本及Dockerfile链接

• 1.19 (latest)、1.18.15、1.17.12
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/qemux86/debian/

镜像历史及详细信息参见https://github.com/balena-io-library/official-images/blob/master/library/qemux86-debian-golang

关于Go语言

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

更多信息：***Go语言条目

用户反馈

Issues

如遇问题或疑问，请通过https://github.com/balena-io-library/base-images/issues反馈。

贡献

欢迎贡献新功能、修复或更新。建议重大贡献前先通过GitHub 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