balenalib/jetson-xavier-nx-devkit-golang Docker 镜像 - 轩辕镜像

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
  Dockerfile源码
  镜像详情可查看官方镜像清单。

详细使用方法和配置说明

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

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

Dockerfile示例

dockerfile
FROM 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

如遇功能问题或使用疑问，可通过GitHub Issue提交反馈。

贡献指南

欢迎贡献代码或改进建议，建议先通过GitHub Issue讨论计划，确保贡献方向一致。

扩展文档

• 基础镜像特性概述
• 镜像变体详情（run vs build）
• 新特性博客

注：本镜像基于Debian系统，Go语言相关使用细节可参考Go官方文档。