balenalib/jetson-tx2-alpine-golang

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

镜像概述和主要用途

balenalib/jetson-tx2-alpine-golang 是 balena.io 基础镜像系列的重要组成，专为 IoT 设备设计，针对 NVIDIA Jetson TX2 硬件平台优化，基于 Alpine Linux 系统并集成 Go 编程语言环境。该镜像既可以与 balenaOS 深度配合，也适用于任何支持 Jetson TX2 架构的 Docker 环境，主要用于开发和运行 Go 语言编写的 IoT 应用程序。

!balenalogo

核心功能和特性

通用基础特性

• install_packages 工具：抽象底层包管理器的便捷安装脚本，具备以下优势：

  • 自动选择最小依赖组合安装指定包（忽略可选依赖）
  • 安装完成后自动清理包管理器元数据，有效减小镜像体积
  • 安装失败时支持自动重试机制

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

  • 当设置 ENV UDEV=1 时，自动启动 udevd 守护进程
  • 支持动态插拔设备，设备节点将自动在容器 /dev 目录中创建

更多特性详情可参考 https://www.balena.io/docs/reference/base-images/base-images/#features-overview%E3%80%82

镜像变体

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

• :<version> 或 :<version>-run（默认变体）：精简的运行时镜像，仅包含应用运行所需的核心依赖，体积小巧高效。

• :<version>-build：包含完整构建工具链的镜像，集成源代码编译所需的各类开发工具，减少手动安装依赖的操作，有助于降低整体镜像体积。

https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

支持的版本及 Dockerfile 链接

• 1.19.1 (latest)、1.18.6、1.17.12
  Dockerfile 源码：https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/jetson-tx2/alpine/

镜像历史及元数据信息可查看 https://github.com/balena-io-library/official-images/blob/master/library/jetson-tx2-alpine-golang%EF%BC%88balena-io-library/official-images 仓库）。

使用场景和适用范围

• Jetson TX2 平台上 Go 语言 IoT 应用的开发与部署
• 需要最小化镜像体积的嵌入式设备应用
• 依赖动态设备管理的 IoT 项目（如传感器、外设交互场景）
• 与 balenaCloud/balenaOS 配合的 IoT 设备管理方案

使用方法和配置说明

在容器中运行 Go 应用

最直接的使用方式是将该镜像同时作为构建和运行环境。典型 Dockerfile 示例：

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

该命令将当前目录挂载为容器卷，设置工作目录为该卷，并执行 go build 命令编译项目，编译结果将保存在本地目录。

与 balena 平台配合使用

如需在 balena 平台使用该镜像，可参考 https://www.balena.io/docs/learn/getting-started/jetson-tx2/go/?ref=dockerhub%EF%BC%8C%E6%88%96%E6%9F%A5%E7%9C%8B https://www.balena.io/docs/learn/getting-started/jetson-tx2/go/#example-projects?ref=dockerhub 获取实践参考。

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新。建议在开发前通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以便获取社区反馈和指导。

文档资源

• balenalib 基础镜像完整文档：https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub
• balenalib 新特性介绍：https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub