balenalib/generic-aarch64-openjdk

balenalib物联网设备OpenJDK基础镜像

镜像概述和主要用途

该镜像为balena.io物联网设备基础镜像系列的一部分，专为物联网场景优化，适用于balena.io平台和balenaOS操作系统，同时也可在任何支持相应架构的Docker环境中运行。它集成OpenJDK运行环境，提供物联网设备开发和运行所需的核心功能。

核心功能和特性

简化包管理

提供install_packages专用脚本，抽象底层包管理器差异，实现：

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

动态设备支持

默认ENTRYPOINT为/usr/bin/entry.sh，实现：

• 检查UDEV环境变量（通过ENV UDEV=1设置）
• 当UDEV=1时，自动启动udevd守护进程
• 动态识别并加载容器内/dev目录中的设备节点

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

镜像变体

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

精简的运行时镜像，仅包含必要的运行时组件，体积小巧，适合部署阶段使用。

:<version>-build

包含完整构建工具链的重型镜像，预装多种源代码构建所需工具，减少Dockerfile中手动安装依赖的需求，从而减小整体镜像体积。

了解更多变体差异：https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

关于OpenJDK

OpenJDK（开放Java开发工具包）是Java平台标准版（Java SE）的免费开源实现，自版本7起成为Java SE的官方参考实现。

参考：***.org/wiki/OpenJDK
注：Java是Oracle及其关联公司的注册商标。

使用方法

在应用中启动Java实例

最直接的用法是将该镜像同时作为构建和运行环境。示例Dockerfile：

dockerfile
FROM balenalib/generic-aarch64-debian-openjdk:latest
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
RUN javac Main.java  # 编译Java代码
CMD ["java", "Main"]  # 运行应用

构建并运行镜像：

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

在容器内编译应用

如需仅在容器内编译代码（不运行），可使用以下命令：

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

该命令实现：

• 将当前目录挂载为容器内/usr/src/myapp卷
• 设置工作目录为该卷
• 执行javac Main.java编译代码，输出Main.class文件到当前目录

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过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%E8%8E%B7%E5%8F%96%E6%8C%87%E5%AF%BC%E5%92%8C%E9%81%BF%E5%85%8D%E9%87%8D%E5%A4%8D%E5%B7%A5%E4%BD%9C%E3%80%82

文档资源

• https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub%EF%BC%88%E5%8C%85%E5%90%AB%E6%89%80%E6%9C%89%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E5%88%97%E8%A1%A8%E5%8F%8A%E4%B8%93%E7%94%A8%E9%95%9C%E5%83%8F%E4%BF%A1%E6%81%AF%EF%BC%89
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%EF%BC%88%E4%BA%86%E8%A7%A3%E6%9C%80%E6%96%B0%E5%8A%9F%E8%83%BD%E6%9B%B4%E6%96%B0%EF%BC%89