balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-alpine-golang

balenalib Go IoT基础镜像

镜像概述和主要用途

balenalib Go镜像是balena.io IoT设备基础镜像系列的一部分，专为在IoT设备上开发和运行Go语言应用而设计。该镜像经过优化，可无缝集成balena.io平台和balenaOS操作系统，同时兼容任何支持相应架构的Docker环境。主要用途是为Go应用提供轻量级、高效的运行时环境和功能丰富的构建环境，满足IoT场景下对资源优化和设备兼容性的需求。

核心功能和特性

1. 简化的包管理工具 install_packages

• 功能：抽象底层包管理器（如apk、apt等）的差异，统一包安装流程。
• 特性：
  • 安装指定包时自动忽略可选依赖，减少依赖数量和镜像体积。
  • 安装完成后自动清理包管理器元数据，进一步减小镜像体积。
  • 支持安装失败时自动重试，提高可靠性。

2. 动态设备支持（UDEV）

• 默认ENTRYPOINT：/usr/bin/entry.sh，负责初始化容器环境。
• UDEV守护进程：通过设置环境变量 ENV UDEV=1 启用udevd守护进程，使容器内 /dev 目录能动态识别并创建外部插入设备的节点，适用于需要访问IoT设备硬件的场景（如传感器、外设等）。

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

使用场景和适用范围

适用设备和架构

• 支持特定IoT硬件架构，如Jetson Xavier NX开发板（含Seeed 2麦克风扩展板）等。
• 兼容balenaOS及其他Linux-based Docker环境。

典型使用场景

• Go应用开发与构建：使用 -build 变体进行源码编译，减少手动安装构建工具的需求，降低镜像总大小。
• 轻量级运行环境：使用 -run 变体部署已编译的Go应用，仅包含运行时必需组件，优化资源占用。
• 硬件交互应用：通过设置 UDEV=1 启用设备动态识别，适用于需要访问GPIO、传感器等外设的IoT应用。

镜像变体

balenalib Go镜像提供多种变体，满足不同开发和部署需求：

:<version> 或 :<version>-run（默认变体）

• 定位：轻量级运行时镜像，仅包含Go应用运行所需的核心组件。
• 特点：体积小巧，资源占用低，适合生产环境部署。

:<version>-build

• 定位：构建环境镜像，包含Go源码编译所需的全套工具链（如编译器、链接器、依赖管理工具等）。
• 特点：减少Dockerfile中手动安装构建工具的步骤，降低整体镜像维护复杂度。

更多关于变体的说明可参考 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

使用方法和配置说明

与Balena平台配合使用

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

本地Docker环境使用

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

创建 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-alpine-golang:latest  # 使用默认run变体

WORKDIR /go/src/app
COPY . .

RUN go get -d -v ./...  # 获取依赖
RUN go install -v ./...  # 编译并安装应用

CMD ["app"]  # 运行编译后的可执行文件

构建并运行镜像：

console
$ docker build -t my-golang-iot-app .
$ docker run -it --rm --name my-running-app my-golang-iot-app

2. 仅编译Go应用（不运行）

如需在容器内编译应用但不在容器内运行，可使用以下命令：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp \
  balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-alpine-golang:latest \
  go build -v  # 编译当前目录下的Go项目，输出可执行文件到当前目录

• -v "$PWD":/usr/src/myapp：将本地当前目录挂载到容器内 /usr/src/myapp。
• -w /usr/src/myapp：设置工作目录为挂载目录。
• go build -v：编译项目，生成与目录名同名的可执行文件。

3. 启用UDEV支持（动态设备）

如需容器识别动态插入的设备，需在Dockerfile中设置 UDEV=1 环境变量：

dockerfile
FROM docker.xuanyuan.run/balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-alpine-golang:latest
ENV UDEV=1  # 启用udevd守护进程
# ... 其他配置 ...

运行容器时需挂载 /dev 目录并添加特权（可选，视设备权限需求）：

console
$ docker run -it --rm --name my-udev-app -v /dev:/dev --privileged my-golang-iot-app

4. 多阶段构建（使用-build和-run变体）

采用多阶段构建优化镜像体积，使用 -build 变体编译， -run 变体运行：

dockerfile
# 第一阶段：使用build变体编译应用
FROM docker.xuanyuan.run/balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-alpine-golang:1.19-build AS builder

WORKDIR /go/src/app
COPY . .
RUN go get -d -v ./...
RUN go build -o app .  # 编译输出到app

# 第二阶段：使用run变体运行应用
FROM docker.xuanyuan.run/balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-alpine-golang:1.19-run

WORKDIR /app
COPY --from=builder /go/src/app/app .  # 仅复制编译产物

CMD ["./app"]

环境变量配置

支持的版本

当前支持的Go版本及对应的Dockerfile链接：

• 1.19（latest）、1.18.15、1.17.12：https://github.com/balena-io-library/base-images/tree/master/balena-base-images/golang/jetson-xavier-nx-devkit-seeed-2mic-hat/alpine/

更多镜像信息可参考 https://github.com/balena-io-library/official-images/blob/master/library/jetson-xavier-nx-devkit-seeed-2mic-hat-alpine-golang%E3%80%82

用户反馈和支持

问题反馈

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

贡献指南

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

文档资源

• 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