openeuler/iceberg

Iceberg Docker镜像文档

镜像概述和主要用途

官方Iceberg Docker镜像，由openEuler CloudNative SIG维护，基于openEuler构建。Apache Iceberg是一种高性能的海量分析表格式，为大数据带来SQL表的可靠性和简洁性，同时支持Spark、Trino、Flink、Presto、Hive和Impala等引擎安全地同时操作同一表。该镜像可免费使用，无每用户速率限制。

核心功能和特性

• 基于openEuler构建，稳定可靠且资源占用低
• 内置Iceberg源代码和预编译JAR包，位于/opt/iceberg，开箱即用
• 无需额外配置JDK、Gradle或依赖项，简化开发环境搭建
• 支持多引擎协作，确保Spark、Trino等工具安全操作同一表
• 提供灵活的容器挂载选项，支持本地项目、配置及数据持久化
• 支持源代码修改与重新构建，便于Iceberg本身的开发与定制

支持的标签及对应Dockerfile链接

每个Iceberg Docker镜像的标签由Iceberg版本和基础镜像版本组成，详情如下：

使用场景和适用范围

• Iceberg内核开发：修改源代码并在容器内重新构建，验证功能迭代
• 派生镜像构建：以该镜像为基础，叠加Spark、Flink等组件构建集成环境
• Iceberg应用开发：编写依赖Iceberg API的Java/Scala程序，直接使用预编译JAR
• 学习与测试：阅读源代码、调试代码逻辑或运行基准测试对比性能

使用方法和配置说明

拉取镜像

从Docker仓库拉取指定标签的openeuler/iceberg镜像：

bash
docker pull openeuler/iceberg:{Tag}

替换{Tag}为支持的标签，例如1.10.1-oe2403sp3

以交互模式启动容器

启动一个交互式容器，自动进入shell环境：

bash
docker run -it --name my-iceberg openeuler/iceberg:{Tag}

容器内/opt/iceberg目录包含完整的Iceberg源代码和编译产物，可直接使用。

容器启动选项

查看容器日志

实时查看容器运行日志：

bash
docker logs -f my-iceberg

进入运行中的容器

对已启动的容器开启新的交互shell：

bash
docker exec -it my-iceberg /bin/bash

开发Iceberg内核

在容器内修改源代码并重新构建：

bash
docker exec -it my-iceberg bash
cd /opt/iceberg
# 修改源代码...
./gradlew build -x test -x integrationTest  # 跳过测试加速构建

构建派生镜像

以当前镜像为基础，叠加其他大数据组件（如Spark）：

dockerfile
FROM openeuler/iceberg:1.10.1-oe2403sp3
RUN yum install -y wget && \
    wget https://archive.apache.org/dist/spark/spark-3.5.0/spark-3.5.0-bin-hadoop3.tgz && \
    tar -xzf spark-3.5.0-bin-hadoop3.tgz -C /opt/

开发基于Iceberg的应用

使用容器内预编译JAR开发Java应用：

bash
docker exec -it my-iceberg bash
# 编写Java代码
echo 'public class MyIcebergApp { public static void main(String[] args) { System.out.println("Hello Iceberg!"); } }' > MyIcebergApp.java
# 编译（依赖Iceberg核心JAR）
javac -cp "/opt/iceberg/core/build/libs/*" MyIcebergApp.java
# 运行
java -cp ".:/opt/iceberg/core/build/libs/*" MyIcebergApp

问题与反馈

如有功能需求或问题，请在openeuler-docker-images提交issue或pull request。