balenalib/jetson-nano-golang

balenalib/jetson-nano-debian-golang 镜像文档

镜像概述和主要用途

本镜像属于 https://balena.io/?ref=dockerhub IoT 设备基础镜像系列，专为Jetson Nano平台优化，基于Debian系统并集成Go语言环境。镜像主要用于balena.io平台和https://www.balena.io/os/?ref=dockerhub环境，但也可在支持相应架构的任何Docker环境中使用。

核心功能和特性

1. 简化的包管理工具 install_packages

• 功能：抽象底层包管理器差异，提供统一的包安装接口
• 特性：
  • 仅安装必要依赖（忽略可选依赖），最小化镜像体积
  • 自动清理包管理器元数据，减少冗余文件
  • 安装失败时自动重试，提高可靠性

2. 动态设备支持

• UDEV集成：默认ENTRYPOINT为/usr/bin/entry.sh，通过环境变量控制udevd服务
  • 设置ENV UDEV=1时，自动启动udevd守护进程
  • 容器内/dev目录将动态生成设备节点，支持热插拔设备

更多功能详情请参见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

使用场景和适用范围

• Jetson Nano平台IoT应用开发：针对NVIDIA Jetson Nano硬件优化，适合边缘计算、AI推理等场景
• Go语言应用开发：集成Go环境，支持Go项目的构建与运行
• balenaOS生态系统：无缝对接balena.io平台和balenaOS，支持设备管理和远程部署
• 多阶段构建：结合-build变体构建应用，-run变体运行，实现最小化部署镜像

详细使用方法和配置说明

在Balena中使用

参考https://www.balena.io/docs/learn/getting-started/jetson-nano/go/?ref=dockerhub了解基础使用流程，或查看https://www.balena.io/docs/learn/getting-started/jetson-nano/go/#example-projects?ref=dockerhub获取实际应用案例。

一般Docker环境使用

Dockerfile示例（构建并运行Go应用）

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

• -v "$PWD":/usr/src/myapp：挂载当前目录到容器内编译路径
• -w /usr/src/myapp：设置工作目录为挂载路径
• go build -v：编译当前目录项目，输出可执行文件

配置参数说明

环境变量

支持的版本

镜像历史和详细信息可查看https://github.com/balena-io-library/official-images/blob/master/library/jetson-nano-debian-golang。

用户反馈

Issues

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

贡献指南

欢迎贡献代码、修复或功能改进。建议先通过https://github.com/balena-io-library/base-images/issues讨论计划，确保方向一致。

什么是Go？

Go（又称Golang）是Google开发的静态类型编程语言，语法类似C，具备垃圾回收、类型安全、动态类型能力、内置变长数组和键值映射等特性，以及丰富的标准库。

***：Go (编程语言)

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