balenalib OpenJDK 镜像文档

镜像概述和主要用途

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

核心功能和特性

install_packages 脚本

提供便捷的包安装工具，抽象底层包管理器差异，具备以下特性：

• 安装指定包时仅包含必要依赖（忽略可选依赖），最小化镜像体积；
• 自动清理包管理器元数据，减少冗余文件；
• 安装失败时自动重试，提升稳定性。

动态设备支持

默认 ENTRYPOINT 为 /usr/bin/entry.sh，通过环境变量控制设备节点管理：

• 当设置 ENV UDEV=1 时，自动启动 udevd 守护进程；
• 容器内 /dev 目录将动态生成并更新设备节点，支持热插拔设备识别。

更多特性详情参见 balena 基础镜像特性概述。

镜像变体

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

:<version> 或 :<version>-run

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

:<version>-build

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

变体差异详情参见 运行时 vs 构建时镜像。

关于 OpenJDK

OpenJDK（Open Java Development Kit）是 Java 平台标准版（Java SE）的免费开源实现，自 Java SE 7 起成为官方参考实现。

更多信息：OpenJDK ***
Java 是 Oracle 及其关联公司的注册商标。

使用方法和配置说明

基础使用：运行 Java 应用

Dockerfile 示例

通过以下 Dockerfile 可构建并运行 Java 项目：

# 使用指定架构的运行时镜像（以树莓派 3 为例）
FROM balenalib/raspberrypi3-debian-openjdk:latest  
# 复制应用代码到容器
COPY . /usr/src/myapp  
WORKDIR /usr/src/myapp  
# 编译 Java 代码
RUN javac Main.java  
# 运行应用
CMD ["java", "Main"]

构建和运行命令

# 构建镜像
docker build -t my-java-app .  

# 运行容器
docker run -it --rm --name my-running-app my-java-app  

进阶使用：容器内编译应用

若仅需编译源码（无需运行），可直接通过容器执行编译命令：

# 挂载当前目录到容器，编译 Main.java
docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/raspberrypi3-debian-openjdk:latest javac Main.java  

编译产物（如 Main.class）将生成在宿主机当前目录。

配置参数

UDEV 环境变量

• 作用：控制是否启动 udevd 守护进程，启用动态设备节点管理。
• 设置方式：在 Dockerfile 中添加 ENV UDEV=1。
• 效果：容器内 /dev 目录将自动生成热插拔设备节点。

用户反馈

问题反馈

如遇镜像相关问题，可通过 GitHub Issues 提交。

贡献指南

欢迎提交新功能、修复或更新。建议在开发前通过 GitHub Issues 讨论计划，以确保方向一致。

官方文档

更多详情参见 balena 基础镜像文档 及 balenalib 新特性博客。

参考链接

• balena.io
• balenaOS
• 镜像变体详情