balenalib/i386-nlp-golang

镜像概述

这是balena.io IoT设备基础镜像系列的一员，针对balenaOS和balena.io平台优化，也可在适配架构的任意Docker环境中使用。balenalib基础镜像具备多种实用特性，助力IoT应用开发。

核心功能

• install_packages脚本：抽象底层包管理器细节，安装指定包时忽略可选依赖、清理包管理器元数据，并在安装失败时自动重试。
• 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，若设置ENV UDEV=1，则启动udevd守护进程，容器/dev目录将自动生成相关设备节点。

使用场景

1. 作为Go应用的构建与运行环境，适用于IoT设备部署。
2. 在容器内编译Go应用（无需运行），生成可执行文件。
3. 基于balenaOS的IoT项目开发，利用balenalib镜像的优化特性。

配置说明

• 启用udev支持：在Dockerfile中添加ENV UDEV=1，以启用动态设备节点检测。
• 选择镜像变体：
  • :<version>或:<version>-run：轻量运行时变体，仅包含必要的运行依赖。
  • :<version>-build：重型构建变体，包含源码构建所需的工具，减少手动安装步骤。

镜像变体

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

• run变体：默认镜像，slim且最小化，仅包含运行时 essentials。
• build变体：包含大量源码构建工具，减少Dockerfile中手动安装包的需求，降低整体镜像大小。

关于Go语言

Go（又称Golang）是谷歌开发的静态类型编程语言，语法松散源自C，具备垃圾回收、类型安全、动态类型能力、内置变长数组与键值映射等特性，且拥有庞大的标准库。

支持版本及Dockerfile链接

• 1.12.9（latest）、1.11.13、1.10.8：https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/i386-nlp/debian/

使用示例

构建并运行Go应用

在项目根目录创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/balenalib/i386-nlp-debian-golang:latest

WORKDIR /go/src/app
COPY . .

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

CMD ["app"]

执行构建与运行命令：

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

仅编译Go应用

在容器内编译应用（不运行）：

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

此命令会将当前目录挂载到容器，设置工作目录，并执行go build生成可执行文件。

用户反馈

问题反馈

若遇到问题或有疑问，请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC%E3%80%82

贡献指南

欢迎贡献新特性、修复或更新（无论大小）。建议先通过GitHub Issue讨论计划，再提交PR，以确保方向正确。

文档参考

镜像文档存储在https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub%E4%B8%AD%EF%BC%8C%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89balenalib%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%88%E5%A6%82node%E3%80%81python%E7%AD%89%EF%BC%89%E7%9A%84%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%E3%80%82