balenalib/jetson-nano-debian-golang

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

镜像概述

本镜像属于balena.io IoT设备基础镜像系列，专为Jetson Nano设备设计，基于Debian系统并集成Golang环境。镜像优化适用于balenaOS和各类Docker环境，提供Golang应用开发、构建及运行的完整支持，同时具备简化包管理和动态设备接入的特性。

!balena logo

核心功能与特性

简化的包管理工具

• install_packages：抽象底层包管理器差异，自动选择最小依赖安装（忽略可选依赖），安装后清理包管理器元数据，并在安装失败时自动重试，提升包安装可靠性。

动态设备支持

• 默认ENTRYPOINT ["/usr/bin/entry.sh"]：检查UDEV环境变量（通过ENV UDEV=1设置），若为true则启动udevd守护进程，使容器内/dev目录自动识别并加载动态插入的设备节点。

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

镜像变体

<version> 或 <version>-run

默认镜像变体，设计为精简的运行时环境，仅包含应用运行必需的核心组件，体积最小化。

<version>-build

重型构建变体，集成大量源代码构建工具，减少手动安装依赖的需求，从而降低整体镜像体积。

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

使用场景

适用于Jetson Nano平台的IoT应用开发，尤其适合需要：

• 在嵌入式设备上开发和运行Golang应用
• 简化跨架构包管理
• 支持动态接入外部设备（如传感器、外设）的场景

与Balena一起使用

参考https://www.balena.io/docs/learn/getting-started/jetson-nano/go/?ref=dockerhub%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B%EF%BC%8C%E6%88%96%E6%9F%A5%E7%9C%8Bhttps://www.balena.io/docs/learn/getting-started/jetson-nano/go/#example-projects?ref=dockerhub%E4%BA%86%E8%A7%A3%E5%AE%9E%E9%99%85%E5%BA%94%E7%94%A8%E6%A1%88%E4%BE%8B%E3%80%82

什么是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/jetson-nano/debian/

镜像历史及详细信息参见https://github.com/balena-io-library/official-images/blob/master/library/jetson-nano-debian-golang%EF%BC%88%60jetson-nano-debian-golang%60%EF%BC%89%E3%80%82

如何使用此镜像

在容器中构建并运行Go应用

Dockerfile示例

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

• 将当前目录挂载为容器卷/usr/src/myapp
• 设置工作目录为挂载卷
• 执行go build -v编译项目

用户反馈

问题反馈

如有问题或建议，请通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%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%E4%BB%A5%E4%BE%BF%E8%8E%B7%E5%BE%97%E6%96%B9%E5%90%91%E6%8C%87%E5%AF%BC%E3%80%82

扩展文档

• 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