balenalib/generic-aarch64-alpine-golang Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

⚠️ 已弃用 (DEPRECATED)

此基础镜像已弃用，将不再接收更新。请阅读公告文章获取迁移指南和建议的替代方案。

镜像概述与主要用途

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

核心功能与特性

install_packages 包管理工具

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

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

动态设备支持

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

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

更多特性详情参见 官方文档 - 特性概述。

镜像变体

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

:<version> 或 :<version>-run

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

:<version>-build

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

详细差异参见 运行时 vs 构建时变体。

使用场景与适用范围

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

使用方法与配置说明

前提条件

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

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

dockerfile
FROM 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 my-golang-app

在容器内编译 Go 应用

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

bash
docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp \
  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
  Dockerfile 源码

镜像详情与历史版本信息，可查看 manifest 文件（generic-aarch64-alpine-golang）。

用户反馈与支持

问题报告

如遇使用问题，请通过 GitHub Issues 提交反馈。

贡献指南

欢迎贡献新功能、修复或更新。建议在编码前通过 GitHub Issues 讨论计划，以确保方向一致。

相关文档

• balena 基础镜像特性概述
• balena 基础镜像迁移指南