balenalib 基础镜像（含OpenJDK）

镜像概述和主要用途

本镜像属于balena.io IoT设备基础镜像系列，专为物联网设备设计。其针对balena.io平台和balenaOS进行了优化，同时也可在其他支持相应架构的Docker环境中使用。

!balenalogo

核心功能和特性

balenalib 基础镜像具有以下显著特性：

• 便捷的包安装脚本：提供 install_packages 脚本，抽象底层包管理器细节。该脚本会以最小依赖（忽略可选依赖）安装指定包，清理包管理器元数据，并在安装失败时重试。

• 动态设备支持：每个 balenalib 基础镜像默认ENTRYPOINT为 ENTRYPOINT ["/usr/bin/entry.sh"]。它会检查 UDEV 环境变量是否设为true（通过 ENV UDEV=1 设置），若为true则启动 udevd 守护进程，使容器内 /dev 目录中的相关设备节点可见。

更多详情，请查看文档中的特性概述。

镜像变体

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

:<version> 或 :<version>-run

这是默认镜像。run 变体设计为精简的最小化变体，仅包含运行时必需组件。

:<version>-build

构建变体是包含大量源码构建工具的镜像，减少Dockerfile中手动安装的包数量，从而减小系统中所有镜像的整体大小。

了解更多变体信息

什么是OpenJDK？

OpenJDK（Open Java Development Kit）是Java Platform, Standard Edition（Java SE）的免费开源实现。自版本7起，OpenJDK成为Java SE的***参考实现。

***.org/wiki/OpenJDK

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

!logo

如何使用此镜像

在应用中启动Java实例

使用此镜像最直接的方式是将Java容器同时作为构建和运行时环境。在Dockerfile中编写如下内容，可编译并运行项目：

dockerfile
FROM balenalib/orangepi-plus2-debian-openjdk:latest
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
RUN javac Main.java
CMD ["java", "Main"]

然后构建并运行Docker镜像：

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

在Docker容器内编译应用

有时可能不需要在容器内运行应用，仅需编译。可按如下方式运行容器：

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

此命令会将当前目录挂载为容器卷，设置工作目录为该卷，并执行 javac Main.java 命令，编译 Main.java 生成 Main.class 文件。

用户反馈

Issues

如遇镜像相关问题或疑问，请通过GitHub issue联系我们。

Contributing

欢迎贡献新功能、修复或更新（无论大小）。我们始终乐于接收pull请求，并会尽快处理。

在开始编码前，建议通过GitHub issue讨论你的计划，尤其是较复杂的贡献。这能让其他贡献者为你指明方向、提供设计反馈，或确认是否有其他人在做相同工作。

文档

本镜像文档存储在base images documentation中。查看该文档可了解所有基础镜像（包括node、python、go等专用镜像及更小体积镜像）的列表。

你也可在这篇博客文章中找到 balenalib 基础镜像新特性的更多详情。