balenalib/beaglebone-green-golang

balenalib/beaglebone-green-debian-golang 镜像文档

镜像概述和主要用途

本镜像属于 https://balena.io/?ref=dockerhub IoT 设备基础镜像系列，专为物联网场景优化，适用于 https://www.balena.io/os/?ref=dockerhub 及其他 Docker 环境（需匹配相应架构）。该镜像基于 Debian 系统，集成 Go 编程语言环境，主要用于在 BeagleBone Green 设备上开发、构建和运行 Golang 应用程序。

核心功能和特性

1. install_packages 包管理脚本

提供便捷的包安装工具 install_packages，抽象底层包管理器细节，具备以下特性：

• 自动安装指定软件包，仅包含必要依赖（忽略可选依赖）
• 安装后自动清理包管理器元数据，减少镜像体积
• 支持安装失败时自动重试

2. 动态设备支持

默认 ENTRYPOINT 为 /usr/bin/entry.sh，通过环境变量 UDEV 控制设备节点检测：

• 设置 ENV UDEV=1 时，自动启动 udevd 守护进程
• 容器内 /dev 目录将动态生成接入设备的节点文件，支持热插拔设备

更多特性详见 https://www.balena.io/docs/reference/base-images/base-images/#features-overview。

使用场景和适用范围

适用场景

• IoT 设备上的 Golang 应用开发与部署
• 需分离构建环境与运行环境的场景（通过 -build 和 -run 变体）
• 需要动态检测硬件设备的嵌入式应用（如传感器、外设交互）

适用架构

专为 BeagleBone Green 设备优化，支持对应架构的 Docker 环境。

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体，专注于运行时环境，仅包含必要的运行时依赖，体积精简，适合直接部署应用。

:<version>-build

构建环境变体，包含大量源码构建工具（如编译器、链接器等），减少手动安装依赖的需求，降低整体镜像体积。

更多细节参见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub。

使用方法和配置说明

与 Balena 平台配合使用

参考 https://www.balena.io/docs/learn/getting-started/beaglebone-green/go/?ref=dockerhub 快速上手，或查看 https://www.balena.io/docs/learn/getting-started/beaglebone-green/go/#example-projects?ref=dockerhub 了解实际应用场景。

Dockerfile 示例：启动 Go 应用实例

基础用法

通过 Dockerfile 构建并运行 Golang 应用：

dockerfile
FROM docker.xuanyuan.run/balenalib/beaglebone-green-debian-golang:latest

WORKDIR /go/src/app
COPY . .

# 安装依赖并编译应用
RUN go get -d -v ./...
RUN go install -v ./...

# 运行应用
CMD ["app"]

构建并运行镜像：

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

编译应用（不运行）

如需仅在容器内编译应用（不运行），可通过以下命令挂载本地目录并执行构建：

bash
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp \
  balenalib/beaglebone-green-debian-golang:latest go build -v

上述命令将当前目录挂载至容器内 /usr/src/myapp，执行 go build 编译项目，输出可执行文件到本地目录。

环境变量配置

支持版本

当前支持的主要版本：

• 1.19（latest）
• 1.18.15
• 1.17.12

版本详情及 Dockerfile 源码参见 https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/beaglebone-green/debian/。

用户反馈

问题反馈

如遇问题或疑问，请通过 https://github.com/balena-io-library/base-images/issues 提交。

贡献方式

欢迎提交功能改进、错误修复或更新，建议先通过 https://github.com/balena-io-library/base-images/issues 讨论计划，再提交 Pull Request。