balenalib/odroid-xu4-golang

balenalib/odroid-xu4-debian-golang 镜像文档

镜像概述和主要用途

本镜像属于 balena.io IoT 设备基础镜像系列，专为物联网设备优化。该镜像针对 balena.io 和 balenaOS 环境进行了深度适配，同时也可在支持相应架构的任何 Docker 环境中使用。主要用途是作为基于 Go 语言开发的 IoT 应用的基础镜像，提供精简的运行时环境或包含构建工具的开发环境，简化物联网应用的容器化部署流程。

!balenalogo

核心功能和特性

install_packages 包管理脚本

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

• 自动选择最小依赖集安装指定包（忽略可选依赖）
• 安装完成后自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试，提升可靠性

UDEV 动态设备支持

默认 ENTRYPOINT 为 ["/usr/bin/entry.sh"]，支持动态设备节点管理：

• 通过设置环境变量 ENV UDEV=1 启用 UDEV 功能
• 启用后自动启动 udevd 守护进程，容器内 /dev 目录将动态显示宿主机插入的设备节点

更多特性详情，请参见 特性概述 文档。

使用场景和适用范围

本镜像适用于以下场景：

• 基于 Go 语言开发的 IoT 设备应用的开发与部署
• 需要动态识别和访问硬件设备的物联网场景（如传感器、USB 外设等）
• 追求精简运行时镜像体积的生产环境部署
• 需要包含完整编译工具链的开发/构建阶段环境

镜像变体

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

<version> 或 <version>-run

默认镜像变体，run 变体为精简版本，仅包含运行时必需组件，体积小巧，适用于生产环境部署。

<version>-build

包含源代码构建所需工具的完整镜像，减少 Dockerfile 中手动安装的依赖包数量，从而减小系统中所有镜像的总体积，适用于开发和构建阶段。

更多变体详情，请参见 运行时与构建变体 文档。

使用方法和配置说明

与 Balena 平台一起使用

参考 快速入门指南 可帮助您快速上手，同时提供 示例项目 展示实际应用场景。

通用 Docker 环境使用

在容器中运行 Go 应用

通过以下 Dockerfile 可构建并运行 Go 应用：

dockerfile
FROM balenalib/odroid-xu4-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/odroid-xu4-debian-golang:latest go build -v

该命令将当前目录挂载为容器卷，设置工作目录为该卷，执行 go build 后，编译产物将输出到宿主机当前目录。

配置参数

UDEV 动态设备配置

启用容器内动态设备识别：

dockerfile
ENV UDEV=1  # 在 Dockerfile 中添加此行启用 udevd

支持版本及 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/odroid-xu4/debian/

更多镜像历史信息，请参见 https://github.com/balena-io-library/official-images/blob/master/library/odroid-xu4-debian-golang 及 https://github.com/balena-io-library/official-images GitHub 仓库。

用户反馈

问题反馈

如遇问题或有疑问，请通过 https://github.com/balena-io-library/base-images/issues 联系我们。

贡献

欢迎贡献新功能、修复或更新。建议在编码前通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以便其他贡献者提供指导和反馈。

文档

本镜像文档存储在 基础镜像文档 中，包含所有 balenalib 基础镜像的详细信息。新功能详情可参见 博客文章。