balenalib/imx6ul-var-dart-golang

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 docker.xuanyuan.run/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链接：
https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/imx6ul-var-dart/debian/

镜像详细信息及历史版本可查看https://github.com/balena-io-library/official-images/blob/master/library/imx6ul-var-dart-debian-golang%E3%80%82

关于Go语言

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

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/golang/logo.png

与Balena平台配合使用

• 入门指南：https://www.balena.io/docs/learn/getting-started/imx6ul-var-dart/go/?ref=dockerhub
• 示例项目：https://www.balena.io/docs/learn/getting-started/imx6ul-var-dart/go/#example-projects?ref=dockerhub

用户反馈

问题反馈

通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%E3%80%82

贡献指南

欢迎贡献代码或改进，建议先通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%E3%80%82

文档资源

• 基础镜像特性：https://www.balena.io/docs/reference/base-images/base-images/#features-overview
• 新特性说明：https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub