balenalib/raspberrypi3-64-alpine-golang 镜像文档

镜像概述

该镜像属于 balena.io 的 IoT 设备基础镜像系列，专为 balena.io 平台和 balenaOS 系统优化，同时也可在任何适当架构的 Docker 环境中运行。它提供了 Go 编程语言的开发和运行环境，集成了 balenalib 基础镜像的核心特性，适用于 IoT 设备上的 Go 应用开发与部署。

核心功能与特性

balenalib 基础特性

• 便捷的包安装工具：提供 install_packages 脚本，抽象底层包管理器差异，以最小依赖安装指定包（忽略可选依赖），自动清理包管理器元数据，并在安装失败时重试。
• 动态设备支持：默认入口点为 ENTRYPOINT ["/usr/bin/entry.sh"]，可通过设置 ENV UDEV=1 启用 UDEV 支持。当 UDEV 标志为 true 时，将启动 udevd 守护进程，使容器内 /dev 目录中显示相关设备节点。

镜像变体

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

• :<version> 或 :<version>-run：默认镜像，run 变体为精简版本，仅包含运行时必要组件。
• :<version>-build：构建变体，包含从源代码构建所需的多种工具，减少 Dockerfile 中手动安装包的需求，从而减小系统中所有镜像的总体积。

Go 语言简介

Go（又称 Golang）是由 Google 开发的编程语言。它是一种静态类型语言，语法松散源自 C，同时具备垃圾回收、类型安全、部分动态类型能力、额外内置类型（如变长数组和键值映射）以及庞大的标准库等特性。

!Go 语言 logo

支持的版本

• 1.19 (latest)、1.18.15、1.17.12（Dockerfile 链接）

有关镜像及其历史的更多信息，请参阅 balena-io-library/official-images GitHub 仓库中的相关清单文件（raspberrypi3-64-alpine-golang）。

使用方法

在应用中启动 Go 实例

最直接的使用方式是将 Go 容器同时作为构建和运行环境。在 Dockerfile 中编写如下内容，可编译并运行项目：

dockerfile
FROM balenalib/raspberrypi3-64-alpine-golang:latest

WORKDIR /go/src/app
COPY . .

RUN go get -d -v ./...
RUN go install -v ./...

CMD ["app"]

构建并运行 Docker 镜像：

console
$ docker build -t my-golang-app .
$ docker run -it --rm --name my-running-app my-golang-app

在 Docker 容器内编译应用

有时可能不需要在容器内运行应用，仅需编译。可使用以下命令在 Docker 实例内编译（不运行）应用：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/raspberrypi3-64-alpine-golang:latest go build -v

该命令会将当前目录挂载为容器卷，设置工作目录为该卷，并执行 go build -v 命令编译项目。

参考链接

• balenalib 基础镜像特性概述
• balena 入门指南
• 示例项目