balenalib/generic-amd64-openjdk

balenalib/generic-amd64-debian-openjdk 镜像文档

镜像概述和主要用途

该镜像属于balena.io的IoT设备基础镜像系列，专为物联网场景优化，可无缝对接balena.io平台、balenaOS及其他支持相应架构的Docker环境。作为OpenJDK镜像，它提供了Java SE的开源实现，便于在IoT设备上部署和运行Java应用。

!balena logo

核心功能和特性

balenalib基础镜像具备以下关键特性：

• 智能包管理工具：内置install_packages脚本，自动适配底层包管理器，安装指定包时最小化依赖（忽略可选依赖），自动清理元数据并支持安装失败重试，简化依赖管理流程。

• 动态设备识别：默认入口点为ENTRYPOINT ["/usr/bin/entry.sh"]，通过设置ENV UDEV=1可启用udevd守护进程，使容器能动态识别并加载外部插入的设备节点至/dev目录。

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

镜像变体

balenalib镜像提供多种变体以满足不同开发需求：

:<version> 或 :<version>-run

默认镜像变体，run变体为精简版，仅包含运行时必需组件，体积小巧，适合直接部署生产环境应用。

:<version>-build

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

https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

关于OpenJDK

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

***.org/wiki/OpenJDK

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

!https://raw.githubusercontent.com/docker-library/docs/a3439b66b7980d1811f6b3835a3c541747172970/openjdk/logo.png

使用方法

在应用中启动Java实例

将Java容器同时作为构建和运行环境，在Dockerfile中编写如下内容：

dockerfile
FROM docker.xuanyuan.run/balenalib/generic-amd64-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-amd64-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%E4%BE%BF%E8%8E%B7%E5%8F%96%E7%A4%BE%E5%8C%BA%E5%8F%8D%E9%A6%88%E3%80%82

扩展文档

• 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

https://balena.io/?ref=dockerhub | https://www.balena.io/os/?ref=dockerhub