balenalib/jetson-xavier-nx-devkit-golang

balenalib/jetson-xavier-nx-devkit-debian-golang 镜像文档

镜像概述和主要用途

本镜像属于balena.io IoT设备基础镜像系列，专为Jetson Xavier NX开发板设计，优化用于balenaOS和通用Docker环境。集成Go语言开发环境，提供精简的运行时和完整的构建工具变体，支持Go应用的全流程开发（编码、编译、运行），并针对IoT场景提供便捷的系统工具和设备管理能力。

核心功能和特性

• 便捷包管理工具：内置install_packages脚本，抽象底层包管理器差异，自动最小化依赖（忽略可选依赖），安装后清理包管理器元数据，并支持安装失败重试，简化依赖管理流程。

• 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，通过设置ENV UDEV=1可启动udevd守护进程，使容器内/dev目录动态识别并加载外部设备节点，适配IoT场景中动态插拔设备的需求。

镜像变体

:<version> 或 :<version>-run

默认镜像变体，为精简的运行时版本，仅包含Go应用运行所需的核心组件，体积小巧，适合生产环境部署。

:<version>-build

构建专用变体，包含从源码编译所需的全套工具链（如编译器、链接器等），减少手动安装构建依赖的操作，降低多阶段构建中的镜像体积冗余。

使用场景和适用范围

适用于Jetson Xavier NX开发板上的Go语言IoT应用开发，尤其适合需要在balenaOS或Docker环境中快速部署的场景，支持从代码开发、依赖编译到应用运行的全流程，可作为开发环境或生产环境镜像使用。

支持的版本及Dockerfile链接

• 1.19.1 (latest)、1.18.6、1.17.12
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/jetson-xavier-nx-devkit/debian/
  镜像详情可查看https://github.com/balena-io-library/official-images/blob/master/library/jetson-xavier-nx-devkit-debian-golang%E3%80%82

详细使用方法和配置说明

方法一：构建并运行Go应用

通过Dockerfile将镜像作为构建和运行环境，完整流程如下：

Dockerfile示例

dockerfile
FROM docker.xuanyuan.run/balenalib/jetson-xavier-nx-devkit-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
# 将当前目录挂载到容器，指定工作目录并执行go build
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/jetson-xavier-nx-devkit-debian-golang:latest go build -v

说明：-v "$PWD":/usr/src/myapp将本地当前目录挂载到容器内/usr/src/myapp，-w设置工作目录，go build -v执行编译。

用户反馈

Issues

如遇功能问题或使用疑问，可通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E5%8F%8D%E9%A6%88%E3%80%82

贡献指南

欢迎贡献代码或改进建议，建议先通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E7%A1%AE%E4%BF%9D%E8%B4%A1%E7%8C%AE%E6%96%B9%E5%90%91%E4%B8%80%E8%87%B4%E3%80%82

扩展文档

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

注：本镜像基于Debian系统，Go语言相关使用细节可参考https://go.dev/doc/%E3%80%82