balenalib IoT基础镜像（含OpenJDK）

镜像概述和主要用途

该镜像属于balena.io IoT设备基础镜像系列，专为物联网设备优化，可无缝对接balena.io平台和balenaOS操作系统，同时兼容其他Docker环境（需对应架构支持）。镜像集成实用工具和特性，简化IoT应用开发与部署流程。

!balenalogo

核心功能和特性

1. 简化的包管理

内置install_packages脚本，抽象底层包管理器差异，自动以最小依赖安装指定包（忽略可选依赖），清理包管理器元数据，并在安装失败时自动重试。

2. 动态设备支持

默认ENTRYPOINT为/usr/bin/entry.sh，通过设置ENV UDEV=1可启用udevd守护进程，实现容器内/dev目录设备节点的动态识别，支持热插拔设备。

更多特性详情请查看特性概述。

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时环境，仅包含应用运行必需的核心组件。

:<version>-build

构建环境变体，包含大量源码构建工具，减少Dockerfile中手动安装的依赖包数量，从而降低系统镜像总大小。

运行时与构建时变体差异

关于OpenJDK

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

***.org/wiki/OpenJDK

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

!OpenJDK logo

使用方法

在应用中启动Java实例

最直接的使用方式是将Java容器同时作为构建和运行环境。在Dockerfile中编写如下内容：

dockerfile
FROM balenalib/raspberrypi4-64-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/raspberrypi4-64-debian-openjdk:latest javac Main.java

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

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励在编码前通过GitHub Issue讨论计划，以便其他贡献者提供方向指导和设计反馈。

文档资源

镜像文档存储在基础镜像文档中，包含所有基础镜像列表（如node、python、go等专用镜像及精简版镜像）。

查看balenalib基础镜像新特性了解更多更新详情。

balena.io | balenaOS