balenalib/jetson-nano-openjdk

balenalib IoT 基础镜像（OpenJDK 版本）

镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列，专为 IoT 设备优化设计。其核心用途是为 IoT 设备应用提供稳定、精简的基础运行环境，默认适配 balena.io 平台及 balenaOS 操作系统，同时也可在其他支持相应架构的 Docker 环境中使用。

核心功能和特性

1. install_packages 包管理脚本

提供便捷的包安装工具 install_packages，抽象了底层包管理器的差异（如 Debian 的 apt、Alpine 的 apk 等）。主要特性包括：

• 自动以最小依赖模式安装指定包（忽略可选依赖）；
• 安装完成后自动清理包管理器元数据，减少镜像体积；
• 支持安装失败时自动重试，提升稳定性。

2. 动态设备接入支持

默认入口点定义为 ENTRYPOINT ["/usr/bin/entry.sh"]，通过环境变量 UDEV 控制设备节点管理：

• 当设置 ENV UDEV=1 时，容器将启动 udevd 守护进程，动态检测并创建 /dev 目录下的设备节点，支持 USB、串口等外设的热插拔。

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

镜像变体

balenalib 镜像提供多种变体，适配不同使用场景：

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

精简的运行时变体，仅包含应用运行所需的核心组件，镜像体积最小，适合直接部署生产环境。

:<version>-build

构建专用变体，包含大量源码构建工具（如编译器、链接器等），减少 Dockerfile 中手动安装依赖的需求，从而降低整体镜像体积。

变体差异详情见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

OpenJDK 简介

OpenJDK（Open Java Development Kit）是 Java Platform, Standard Edition（Java SE）的免费开源实现，自 Java SE 7 起成为官方参考实现。它提供了 Java 开发和运行所需的核心组件，包括编译器（javac）、运行时（java）等，支持跨平台应用开发。

Java 是 Oracle 及其关联公司的注册商标。

使用方法和配置说明

场景 1：作为构建与运行环境

将本镜像同时用作应用的构建和运行环境，直接在 Dockerfile 中完成编译和运行配置：

dockerfile
# 使用最新版 balenalib Jetson Nano Debian OpenJDK 镜像
FROM docker.xuanyuan.run/balenalib/jetson-nano-debian-openjdk:latest
# 复制应用代码到容器内
COPY . /usr/src/myapp
# 设置工作目录
WORKDIR /usr/src/myapp
# 编译 Java 代码（假设入口类为 Main.java）
RUN javac Main.java
# 运行应用
CMD ["java", "Main"]

构建并运行镜像：

console
$ docker build -t my-java-app .  # 构建镜像
$ docker run -it --rm --name my-running-app my-java-app  # 运行容器

场景 2：仅用于编译应用

若无需在容器内运行应用，仅需编译源码，可通过以下命令挂载本地目录并执行编译：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/jetson-nano-debian-openjdk:latest javac Main.java

• -v "$PWD":/usr/src/myapp：将当前目录挂载到容器内 /usr/src/myapp；
• -w /usr/src/myapp：设置容器工作目录为 /usr/src/myapp；
• javac Main.java：执行 Java 编译命令，生成 Main.class 文件。

用户反馈

问题反馈

如遇镜像使用问题或疑问，请通过 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%E3%80%82%E6%96%B0%E7%89%B9%E6%80%A7%E8%AF%B4%E6%98%8E%E5%8F%AF%E6%9F%A5%E7%9C%8B https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%E3%80%82