balenalib/spacely-tx2-alpine-golang

balenalib/spacely-tx2-alpine-golang 镜像文档

镜像概述和主要用途

balenalib/spacely-tx2-alpine-golang 是 balena.io 基础镜像系列的重要成员，专为 IoT 设备设计并针对 spacely-tx2 架构优化。该镜像基于 Alpine Linux，提供完整的 Go 语言（Golang）开发与运行环境，既能与 balenaOS 无缝集成，也可在其他 Docker 环境中运行。集成了 balenalib 系列特有的工具链，旨在简化 IoT 应用的开发、构建和部署过程。

!balenalogo

核心功能和特性

• 智能包管理工具：内置 install_packages 脚本，抽象底层包管理器差异，自动选择最小依赖安装（忽略可选依赖），安装后清理包管理器元数据，并在安装失败时自动重试，提升依赖管理效率。

• 动态设备接入支持：默认 ENTRYPOINT 为 /usr/bin/entry.sh，通过设置环境变量 UDEV=1 可启动 udevd 守护进程，使容器内 /dev 目录能实时识别并加载新接入的设备节点，支持 USB 设备、传感器等动态插拔硬件。

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

镜像变体

balenalib 镜像提供多种变体以满足不同场景需求：

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时版本，仅包含应用运行必需的组件，最小化镜像体积，适合直接部署生产环境。

:<version>-build

构建专用变体，集成大量源码构建工具（如编译器、链接器等），减少手动安装构建依赖的操作，优化源码编译流程，适合开发阶段使用。

更多变体差异参见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

与 Balena 平台配合使用

如需在 balena 平台上使用此镜像，可参考 https://www.balena.io/docs/learn/getting-started/spacely-tx2/go/?ref=dockerhub%EF%BC%8C%E6%88%96%E9%80%9A%E8%BF%87 https://www.balena.io/docs/learn/getting-started/spacely-tx2/go/#example-projects?ref=dockerhub 了解实际应用场景。

什么是 Go？

Go（又称 Golang）是由 Google 开发的开源编程语言，属于静态类型语言，语法风格借鉴 C 语言，同时具备垃圾自动回收、内存安全、类型安全、变长数组和键值映射等内置类型，以及丰富的标准库，适用于构建高性能、可扩展的系统级应用。

***：Go (编程语言)

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

支持的版本及 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/spacely-tx2/alpine/

更多镜像信息及历史版本，可查看 https://github.com/balena-io-library/official-images 中的 https://github.com/balena-io-library/official-images/blob/master/library/spacely-tx2-alpine-golang%E3%80%82

使用方法和配置说明

构建并运行 Go 应用

将容器同时作为构建和运行环境，通过以下 Dockerfile 编译并启动应用：

dockerfile
FROM docker.xuanyuan.run/balenalib/spacely-tx2-alpine-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/spacely-tx2-alpine-golang:latest go build -v

该命令将当前目录挂载为容器卷，设置工作目录为挂载路径，执行 go build 完成编译。

用户反馈

问题反馈

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

贡献指南

欢迎提交新功能、错误修复或优化建议。建议在开发前通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以便获取社区反馈和避免重复工作。

相关文档

• https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub