balenalib/orbitty-tx2-alpine-openjdk

balenalib/orbitty-tx2-alpine-openjdk 镜像文档

镜像概述和主要用途

该镜像为balena.io IoT设备基础镜像系列的一部分，专为物联网设备优化，适用于balena.io平台和balenaOS，同时兼容其他支持相应架构的Docker环境。集成OpenJDK提供Java运行与开发环境，结合balenalib基础镜像特性，简化IoT应用的开发、构建与部署流程。

核心功能和特性

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

OpenJDK特性

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

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

镜像变体

:<version> 或 :<version>-run

默认镜像，run变体为精简版，仅包含运行时必需组件，体积小巧。

:<version>-build

构建变体，包含源码构建所需工具，减少Dockerfile中手动安装的包数量，降低系统镜像总体积。

详细对比见https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

使用场景和适用范围

• IoT设备上的Java应用开发与部署
• 需要动态识别外部设备的Java应用
• 基于balenaOS的嵌入式系统开发
• 跨平台Java应用的容器化构建与运行

使用方法和配置说明

在应用中启动Java实例

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

dockerfile
FROM docker.xuanyuan.run/balenalib/orbitty-tx2-alpine-openjdk:latest
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
RUN javac Main.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/orbitty-tx2-alpine-openjdk:latest javac Main.java

此命令将当前目录挂载为卷，编译Main.java生成Main.class。

环境变量配置

• UDEV：设为1时启动udevd，使容器识别动态设备节点，配置示例：ENV UDEV=1

用户反馈

问题反馈

通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E6%88%96%E7%96%91%E9%97%AE%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%E5%B0%A4%E5%85%B6%E6%98%AF%E5%A4%A7%E5%9E%8B%E8%B4%A1%E7%8C%AE%E3%80%82

文档资源

完整文档见https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub%EF%BC%8C%E6%96%B0%E7%89%B9%E6%80%A7%E8%AF%A6%E6%83%85%E5%8F%82%E8%80%83https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%E3%80%82