balenalib/imx8m-var-dart-debian-golang 镜像文档

镜像概述和主要用途

本镜像属于 balena.io IoT 设备基础镜像系列，专为 imx8m-var-dart 架构优化，基于 Debian 系统，集成 Go 语言开发环境。其主要用途是为 IoT 设备上的 Go 应用提供构建和运行环境，尤其适用于与 balena.io 平台和 balenaOS 配合使用，同时也可在其他支持该架构的 Docker 环境中运行。

!balenalogo

核心功能和特性

balenalib 基础镜像具备以下关键特性：

• 便捷的包管理工具：提供 install_packages 脚本，抽象底层包管理器差异。该脚本会以最小依赖（忽略可选依赖）安装指定包，自动清理包管理器元数据，并在安装失败时重试。

• 动态设备支持：默认 ENTRYPOINT 为 ENTRYPOINT ["/usr/bin/entry.sh"]。通过设置环境变量 UDEV=1（即添加 ENV UDEV=1），可启用 udevd 守护进程，使动态接入的设备节点在容器 /dev 目录中自动可见。

更多特性详情请参见 ***文档中的特性概述。

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体。run 变体设计为精简版本，仅包含运行时必需组件，体积小巧。

:<version>-build

构建变体是较完整的镜像，包含大量源码构建所需工具，可减少 Dockerfile 中手动安装的包数量，从而减小系统中所有镜像的总体大小。

与 Balena 配合使用

如需了解如何将此基础镜像与 balena 配合使用，可参考 入门指南。此外，示例项目库 也提供了基于 balena 的应用案例，帮助理解实际应用场景。

什么是 Go？

Go（又称 Golang）是 Google 开发的编程语言，属于静态类型语言，语法部分借鉴 C 语言，同时具备垃圾回收、类型安全、部分动态类型特性、额外内置类型（如变长数组和键值映射）及丰富的标准库。

***.org/wiki/Go_(programming_language)

!logo

支持的版本及对应 Dockerfile 链接

1.19.1 (latest)、1.18.6、1.17.12

有关镜像及其历史的更多信息，请查看 balena-io-library/official-images GitHub 仓库 中的 相关清单文件（imx8m-var-dart-debian-golang）。

如何使用此镜像

在应用中启动 Go 实例

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

dockerfile
FROM balenalib/imx8m-var-dart-debian-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 容器内编译应用

若无需在容器中运行应用，仅需编译，可执行以下命令：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/imx8m-var-dart-debian-golang:latest go build -v

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

用户反馈

Issues

如遇镜像相关问题或疑问，请通过 GitHub Issue 联系我们。

贡献

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励提交 Pull Request，并会尽快处理。

在开始编码前，建议通过 GitHub Issue 讨论计划，尤其是大型贡献，以便其他贡献者提供方向、设计反馈，或确认是否有其他人正在处理相同内容。

文档

镜像文档存储在 基础镜像文档 中。该文档列出了所有基础镜像，包括 node、python、go 等专用镜像及精简版镜像。

有关 balenalib 基础镜像新功能的更多详情，可参考 此博客文章。