balenalib/revpi-core-3-debian-openjdk 镜像文档

镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列，专为 IoT 设备环境优化。其核心用途是提供基于 OpenJDK 的 Java 运行和开发环境，默认适配 balena.io 平台及 balenaOS 操作系统，同时也可在其他支持相应架构的 Docker 环境中使用。

!balena 标志

核心功能和特性

1. 简化的包管理工具

• install_packages 脚本：抽象底层包管理器（如 apt）的差异，自动处理以下功能：
  • 安装指定软件包时仅包含最小依赖（忽略可选依赖）
  • 安装后自动清理包管理器元数据，减小镜像体积
  • 包安装失败时自动重试，提升构建稳定性

2. 动态设备支持

• 默认入口点为 ENTRYPOINT ["/usr/bin/entry.sh"]，通过环境变量控制设备节点管理：
  • 设置 ENV UDEV=1 时，入口脚本将启动 udevd 守护进程
  • 动态插入的设备节点将自动在容器的 /dev 目录下创建并可用

更多特性详情，请参见 balena 文档中的特性概述。

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体，又称 "运行时变体"。设计为精简版本，仅包含运行时必要组件，适用于生产环境中应用的部署运行。

:<version>-build

构建变体，包含从源代码构建所需的多数工具（如编译器、链接器等），减少 Dockerfile 中手动安装的依赖包数量，从而减小系统中所有镜像的总体积。

镜像变体详情

什么是 OpenJDK？

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

***.org/wiki/OpenJDK

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

!OpenJDK 标志

使用方法

在应用中启动 Java 实例

将 Java 容器同时作为构建和运行环境，Dockerfile 示例：

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

构建并运行镜像：

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

# 运行容器
docker run -it --rm --name my-running-app my-java-app

在容器内编译应用

仅使用容器编译源代码（不运行），通过挂载主机目录实现：

docker run --rm \
  -v "$PWD":/usr/src/myapp \  # 挂载当前目录到容器工作目录
  -w /usr/src/myapp \          # 设置工作目录
  balenalib/revpi-core-3-debian-openjdk:latest \
  javac Main.java              # 执行编译命令

编译产物 Main.class 将生成在主机当前目录中。

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或优化（无论规模）。提交拉取请求前，建议通过 GitHub Issue 讨论计划，以确保方向一致并避免重复工作。

参考文档

• balena 基础镜像文档
• balenalib 新特性博客