balenalib/generic-aarch64-alpine-golang

⚠️ 已弃用 (DEPRECATED)

此基础镜像已弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/%E8%8E%B7%E5%8F%96%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97%E5%92%8C%E5%BB%BA%E8%AE%AE%E7%9A%84%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

镜像概述与主要用途

本镜像属于 https://balena.io/?ref=dockerhub IoT 设备基础镜像系列，专为物联网场景设计优化。其核心目标是为 balena.io 平台和 https://www.balena.io/os/?ref=dockerhub 提供轻量、高效的运行环境，同时兼容任何基于相同架构的 Docker 环境。

核心功能与特性

install_packages 包管理工具

提供专用的 install_packages 脚本，抽象底层包管理器差异，具备以下特性：

• 自动选择最小依赖安装（忽略可选依赖）
• 安装后自动清理包管理器元数据
• 安装失败时自动重试

动态设备支持

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

• 当设置 ENV UDEV=1 时，自动启动 udevd 守护进程
• 动态识别并创建容器内 /dev 目录下的设备节点

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

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时环境，仅包含应用运行必需的依赖，最小化镜像体积。

:<version>-build

构建专用变体，包含完整的源码构建工具链，减少手动安装依赖的需求，从而降低系统中所有镜像的总体积。

详细差异参见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

使用场景与适用范围

• IoT 设备应用开发：适用于基于 ARM64 架构的物联网设备上的 Go 语言应用开发
• balena 平台集成：优化用于 balena.io 平台和 balenaOS 操作系统环境
• 跨平台构建：通过 build 变体可在容器内完成 Go 应用的交叉编译
• 动态设备交互：需要访问 USB、串口等热插拔设备的场景（需启用 UDEV）

使用方法与配置说明

前提条件

• Docker 环境需支持 aarch64 架构
• 如需使用 balena 平台，需配置 balena CLI 工具

Dockerfile 示例：构建并运行 Go 应用

dockerfile
FROM docker.xuanyuan.run/balenalib/generic-aarch64-alpine-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 docker.xuanyuan.run/my-golang-app

在容器内编译 Go 应用

如需仅编译应用而不在容器内运行，可使用以下命令：

bash
docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp \
  docker.xuanyuan.run/balenalib/generic-aarch64-alpine-golang:latest \
  go build -v

该命令会：

• 将当前目录挂载为容器内 /usr/src/myapp 卷
• 设置工作目录为挂载卷
• 执行 go build 编译项目，输出可执行文件到当前目录

配置参数

环境变量

支持的版本与 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/generic-aarch64/alpine/

镜像详情与历史版本信息，可查看 https://github.com/balena-io-library/official-images/blob/master/library/generic-aarch64-alpine-golang%EF%BC%88%60generic-aarch64-alpine-golang%60%EF%BC%89%E3%80%82

用户反馈与支持

问题报告

如遇使用问题，请通过 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
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub