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

镜像概述

本镜像属于balena.io IoT设备基础镜像系列，专为嵌入式和IoT场景优化，适用于balena.io平台及balenaOS，同时兼容其他Docker环境。作为Go语言专用镜像，它集成了开发工具与运行时支持，助力高效构建嵌入式Go应用。

核心功能与特性

便捷包管理工具

内置install_packages脚本，自动适配底层包管理器，实现：

• 最小依赖安装（忽略可选依赖）
• 自动清理包管理器元数据
• 安装失败时自动重试机制

动态设备管理

默认ENTRYPOINT为/usr/bin/entry.sh，通过环境变量控制设备管理：

• 设置ENV UDEV=1启动udevd守护进程
• 支持容器内/dev目录设备节点动态识别，适配热插拔设备

镜像变体

:<version> 或 :<version>-run

精简运行时版本，仅包含应用运行必需组件，适合生产环境部署。

:<version>-build

集成完整构建工具链，优化源代码编译流程，减少手动依赖安装，提升开发效率。

适用场景

• IoT设备与嵌入式系统的Go应用开发/部署
• 需要动态管理外设（传感器、USB设备等）的嵌入式项目
• 基于balena.io平台或balenaOS的应用开发
• 跨架构嵌入式Go应用的容器化构建与测试

使用方法

构建并运行Go应用

通过Dockerfile将镜像作为构建与运行环境：

dockerfile
FROM balenalib/imx6ul-var-dart-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

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

挂载本地目录至容器，执行编译命令：

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

支持版本

当前支持的Go版本及Dockerfile链接：
1.19.1 (latest)、1.18.6、1.17.12

镜像详细信息及历史版本可查看***镜像清单。

关于Go语言

Go（Golang）是Google开发的静态类型语言，语法类似C，具备垃圾回收、类型安全、内置数组/映射类型及庞大标准库，适合构建高效、可靠的系统软件与分布式应用。

!Go语言logo

与Balena平台配合使用

• 入门指南：balena基础镜像使用教程
• 示例项目：balena IoT示例库

用户反馈

问题反馈

通过GitHub Issues提交问题或建议。

贡献指南

欢迎贡献代码或改进，建议先通过GitHub Issues讨论计划。

文档资源

• 基础镜像特性：***文档
• 新特性说明：balena***博客