balenalib/i386-ubuntu-golang

balenalib i386-ubuntu-golang 镜像文档

镜像概述和主要用途

balenalib i386-ubuntu-golang 镜像属于 balena.io 物联网（IoT）设备基础镜像系列，专为 IoT 应用开发设计。该镜像针对 balena.io 平台和 balenaOS 系统深度优化，同时兼容其他 Docker 环境（需 i386 架构支持），集成 Go 语言环境，提供精简运行时和完整构建工具变体，覆盖从源码构建到部署运行的全流程 IoT 应用开发需求。

核心功能和特性

1. 简化包管理

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

2. 动态设备支持

• 默认 ENTRYPOINT：入口点为 /usr/bin/entry.sh，通过检测 UDEV 环境变量（设置 ENV UDEV=1）启动 udevd 守护进程，使容器内 /dev 目录能动态识别外部插入设备节点。

更多特性见 https://www.balena.io/docs/reference/base-images/base-images/#features-overview%E3%80%82

镜像变体

:<version> 或 :<version>-run

默认变体，run 为精简运行时镜像，仅含应用运行核心组件，体积小巧，适合生产环境部署。

:<version>-build

构建时变体，包含大量源码构建工具，减少 Dockerfile 手动安装依赖需求，降低系统镜像总体积，适合开发阶段源码构建。

变体详情见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

关于 Go 语言

Go（Golang）是 Google 开发的静态类型语言，语法借鉴 C，具备垃圾回收、类型安全、动态类型特性，内置变长数组和键值映射等数据结构，拥有丰富标准库。详情参考 *** Go 语言。

支持的版本及 Dockerfile 链接

• 1.19 (latest)、1.18.15、1.17.12
  Dockerfile 源码：https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/i386/ubuntu/

镜像历史信息见 https://github.com/balena-io-library/official-images/blob/master/library/i386-ubuntu-golang%E3%80%82

使用方法

在应用中启动 Go 实例

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

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

该命令挂载当前目录至容器 /usr/src/myapp，设置工作目录后执行 go build -v，编译输出可执行文件到本地目录。

用户反馈

问题反馈

通过 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%EF%BC%8C%E6%96%B0%E7%89%B9%E6%80%A7%E8%A7%81 https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%E3%80%82