balenalib OpenJDK 基础镜像文档

镜像概述和主要用途

本镜像属于 balena.io 为 IoT 设备提供的基础镜像系列，专为 IoT 场景优化，适用于 balena.io 平台和 balenaOS 系统，同时也可在任何支持相应架构的 Docker 环境中运行。

核心功能和特性

1. 简化的包管理工具

提供 install_packages 脚本，抽象底层包管理器差异，具备以下特性：

• 安装指定包时仅包含最小依赖（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 安装失败时自动重试，提升构建稳定性

2. 动态设备支持

默认入口点（ENTRYPOINT）为 /usr/bin/entry.sh，支持动态识别外部设备：

• 通过设置环境变量 ENV UDEV=1 启用 udev 功能
• 启用后自动启动 udevd 守护进程，容器内 /dev 目录将动态生成外部设备节点

更多特性详情可参考 官方文档 - 特性概述。

镜像变体

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

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

基础运行时变体，精简设计，仅包含运行时必需组件，适用于直接部署应用的场景。

:<version>-build

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

查看官方文档了解更多变体差异

关于 OpenJDK

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

更多信息：*** - OpenJDK

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

!OpenJDK Logo

使用方法和配置说明

环境变量配置

部署示例

示例 1：构建并运行 Java 应用

通过 Dockerfile 将本镜像同时作为构建和运行环境，编译并启动 Java 应用：

# 以 odroid-xu4 架构为例，其他架构替换镜像名前缀即可
FROM balenalib/odroid-xu4-debian-openjdk:latest  
COPY . /usr/src/myapp  
WORKDIR /usr/src/myapp  
RUN javac Main.java  # 编译应用  
CMD ["java", "Main"]  # 启动应用  

构建并运行镜像：

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

# 运行容器（交互式，退出时自动清理）  
docker run -it --rm --name my-running-app my-java-app  

示例 2：仅在容器内编译应用

如需仅编译代码（不运行），可通过挂载本地目录执行编译命令：

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

编译产物（Main.class）将生成在本地当前目录。

使用场景和适用范围

• IoT 设备开发：适配 balenaOS 的嵌入式设备，需运行 Java 应用的场景
• 轻量化部署：使用 :<version>-run 变体部署生产环境应用，减少资源占用
• 源码构建：使用 :<version>-build 变体简化 Java 应用的编译流程，减少手动依赖安装

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新。建议在开发前通过 GitHub Issues 讨论计划，以确保方向一致并避免重复工作。

文档资源

• 完整特性说明：balena 基础镜像文档
• 镜像变体详情：Run vs Build 变体
• 新特性介绍：balena 基础镜像更新日志