镜像概述和主要用途

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

!balenalogo

核心功能和特性

balenalib基础镜像的显著特性包括：

• 实用的包安装脚本：install_packages脚本抽象了底层包管理器的细节，将以最少依赖项（忽略可选依赖）安装指定包，清理包管理器元数据，并在安装失败时重试。

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

更多详情请查看特性概述。

镜像变体

balenalib镜像提供多种版本，适用于不同用例：

:<version> 或 :<version>-run

默认镜像。run变体为精简版本，仅包含运行时必要组件。

:<version>-build

较重型镜像，包含从源代码构建所需的多种工具，减少手动安装包数量，从而减小系统镜像总体积。

如何与Balena一起使用

入门指南可帮助你开始使用此基础镜像，示例项目展示了balena的应用场景。

What is 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示例：

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 build -t my-golang-app .
$ docker run -it --rm --name my-running-app my-golang-app

在Docker容器内编译应用

如需仅编译不运行，可执行：

$ 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。

用户反馈

Issues

如有问题或疑问，请通过GitHub issue联系。

Contributing

欢迎贡献新功能、修复或更新。建议通过GitHub issue讨论计划，尤其是大型贡献。

Documentation

镜像文档见基础镜像文档，含所有基础镜像列表。博客文章提供balenalib新功能详情。