该镜像属于 balena.io 的物联网设备基础镜像系列。此镜像针对 balena.io 和 balenaOS 进行了优化，但也可在任何运行于适当架构的 Docker 环境中使用。

!balenalogo

balenalib 基础镜像特性

balenalib 基础镜像包含以下显著特性：

• 实用的包安装脚本 install_packages，可抽象底层包管理器的具体实现。它会以最小依赖量安装指定包（忽略可选依赖），清理包管理器元数据，并在安装失败时重试。

• 动态设备支持：每个 balenalib 基础镜像均设有默认入口点 ENTRYPOINT ["/usr/bin/entry.sh"]。该脚本会检查 UDEV 环境变量是否设为 true（通过 ENV UDEV=1 设置），若为 true，则启动 udevd 守护进程，使容器内 /dev 目录中出现相关设备节点。

更多详情，请查看文档中的 特性概述。

镜像变体

balenalib 镜像提供多种版本，分别针对特定使用场景设计。

:<version> 或 :<version>-run

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

:<version>-build

build 变体为较完整镜像，包含大量从源代码构建所需的工具。这减少了在 Dockerfile 中手动安装的包数量，从而降低系统中所有镜像的总体大小。

如何在 Balena 中使用此镜像

入门指南 可帮助您开始将此基础镜像与 balena 结合使用，同时还有一些 示例项目 能让您了解 balena 的应用场景。

什么是 Go？

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

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

!logo

支持的版本及对应 Dockerfile 链接

1.19 (latest)、1.18.15、1.17.12

有关此镜像及其历史的更多信息，请查看 balena-io-library/official-images GitHub 仓库 中的 相关清单文件 (cl-som-imx8-debian-golang)。

如何使用此镜像

在应用中启动 Go 实例

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

dockerfile
FROM balenalib/cl-som-imx8-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 容器内编译应用

有时可能不需要在容器内运行应用。如需在 Docker 实例内编译而非运行应用，可执行如下命令：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/cl-som-imx8-debian-golang:latest go build -v

此命令会将当前目录作为卷挂载到容器，设置工作目录为该卷，并运行 go build 命令，从而编译工作目录中的项目并输出可执行文件到 myapp。

用户反馈

问题反馈

如对此镜像有任何问题或疑问，请通过 GitHub issue 联系我们。

贡献

欢迎贡献新功能、修复或更新（无论大小）；我们始终乐于接收拉取请求，并会尽快处理。

在开始编码前，建议通过 GitHub issue 讨论您的计划，尤其是对于较复杂的贡献。这能让其他贡献者为您指明方向、提供设计反馈，并帮助确认是否有其他人正在从事相同工作。

文档

此镜像的文档存储在 基础镜像文档 中。您可在此查看所有基础镜像列表，包括许多专用镜像（如 node、python、go 及更小体积的镜像等）。

您还可在这篇 博客文章 中了解 balenalib 基础镜像的新功能详情。