balenalib/aarch64-golang

镜像概述和主要用途

该镜像属于balena.io的IoT设备基础镜像系列，专为balena.io平台和balenaOS操作系统优化，同时兼容其他支持相应架构的Docker环境。作为物联网应用开发的底层支撑，其设计兼顾轻量级与功能性，简化设备端应用的构建与部署流程。

核心功能和特性

balenalib基础镜像提供以下关键能力：

install_packages包管理脚本

内置实用包安装脚本install_packages，抽象底层包管理器差异，核心特性包括：

• 自动选择最小依赖组合安装指定包（忽略可选依赖）
• 安装后清理包管理器元数据，减少镜像体积
• 支持安装失败自动重试，提升可靠性

UDEV动态设备支持

默认入口点配置为ENTRYPOINT ["/usr/bin/entry.sh"]，实现动态设备接入：

• 检测UDEV环境变量（通过ENV UDEV=1启用）
• 启用时自动启动udevd守护进程，使容器/dev目录动态生成设备节点

更多特性详情见官方特性概述。

镜像变体

提供多类变体适配不同场景需求：

:<version> 或 :<version>-run

默认精简变体，仅包含运行时必需组件，体积小巧，适合直接部署生产应用。

:<version>-build

构建专用变体，集成完整源码构建工具链，减少手动安装依赖步骤，有助于优化整体镜像体积。

变体差异详情

Go语言简介

Go（Golang）是Google开发的静态类型编程语言，语法接近C语言，核心特性包括：

• 内置垃圾回收机制与类型安全保障
• 支持变长数组、键值映射等原生数据结构
• 庞大的标准库与动态类型能力扩展

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

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/golang/logo.png

支持版本及Dockerfile链接

当前支持版本包括：

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

镜像历史与版本详情可查看https://github.com/balena-io-library/official-images/blob/master/library/aarch64-debian-golang%E3%80%82

使用方法

Dockerfile构建应用

通过以下Dockerfile可实现应用的构建与运行一体化：

dockerfile
FROM balenalib/aarch64-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/aarch64-debian-golang:latest go build -v

该命令将当前目录挂载至容器，执行go build生成可执行文件myapp。

用户反馈

问题报告

如遇功能异常或使用疑问，可通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E5%8F%8D%E9%A6%88%E3%80%82

代码贡献

欢迎提交功能改进、错误修复或文档更新（大小贡献均可）。建议重大变更前通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E6%96%B9%E6%A1%88%EF%BC%8C%E4%BB%A5%E7%A1%AE%E4%BF%9D%E6%96%B9%E5%90%91%E4%B8%80%E8%87%B4%E3%80%82

扩展文档

• 基础镜像完整文档
• 新特性迁移指南