balenalib IoT设备基础镜像（OpenJDK）

镜像概述与主要用途

该镜像属于balena.io的物联网（IoT）设备基础镜像系列，专为物联网设备优化。它针对balena.io平台和balenaOS进行了深度优化，同时也可在其他支持相应架构的Docker环境中使用，提供OpenJDK运行环境，适用于物联网场景下的Java应用开发与部署。

核心功能与特性

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

• 便捷的软件包管理：提供install_packages脚本，可抽象底层包管理器差异，自动安装依赖最少的软件包（忽略可选依赖），清理包管理器元数据，并在安装失败时重试，简化依赖管理流程。

• 动态设备支持：默认ENTRYPOINT为/usr/bin/entry.sh，通过检查UDEV环境变量（可通过ENV UDEV=1配置）决定是否启动udevd守护进程，使容器内/dev目录能动态识别并显示外部接入设备节点。

更多特性详情参见***特性概述。

镜像变体

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

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

精简的运行时变体，仅包含应用运行必需的组件，体积小巧，适合生产环境部署。

:<version>-build

包含大量源码构建工具的重型变体，减少Dockerfile中手动安装依赖的需求，从而减小整体镜像体积，适合开发构建阶段使用。

变体详细说明参见运行时与构建时变体差异。

关于OpenJDK

OpenJDK（开放Java开发工具包）是Java平台标准版（Java SE）的免费开源实现，自Java SE 7起成为***参考实现，支持Java应用的编译与运行。

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

!OpenJDK logo

使用方法

1. 启动Java应用实例

可直接将该镜像作为Java应用的构建与运行环境，示例Dockerfile如下：

# 使用balenalib OpenJDK镜像
FROM balenalib/cl-som-imx8-ubuntu-openjdk:latest

# 复制应用代码到容器
COPY . /usr/src/myapp

# 设置工作目录
WORKDIR /usr/src/myapp

# 编译Java代码
RUN javac Main.java

# 运行应用
CMD ["java", "Main"]

构建并运行镜像：

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

# 运行容器（交互式，退出后自动删除）
$ docker run -it --rm --name running-java-app my-java-iot-app

2. 在容器内编译应用

如需仅在容器内编译代码（不运行），可通过以下命令挂载本地目录并执行编译：

# 将当前目录挂载到容器，编译Main.java
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/cl-som-imx8-ubuntu-openjdk:latest javac Main.java

该命令会在当前目录生成编译后的Main.class文件。

适用场景

• 物联网设备部署：适合在balenaOS驱动的IoT设备上部署Java应用，如嵌入式网关、传感器数据处理节点等。
• 跨环境开发：可在开发环境使用-build变体构建应用，生产环境使用-run变体部署，减小部署体积。
• 动态设备接入：需与外部硬件设备交互的场景（如USB设备、传感器），通过UDEV=1配置实现设备节点动态识别。

用户反馈与文档

问题反馈

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

贡献指南

欢迎提交功能改进、错误修复或更新，建议先通过GitHub Issue讨论大型贡献计划。

***文档

• balenalib基础镜像文档
• 新特性介绍
• balenaOS官网

更多信息：balena.io