1. 构建环境准备与依赖

Zeppelin 0.10.1 编译同样强依赖 Bigtop 体系，强烈建议直接在官方 Bigtop 容器或预设环境下完成，极大减少环境不一致导致的构建失败。

环境组件	推荐版本	安装参考
JDK	1.8	ONEKEY——安装JDK1.8
Maven	3.8.4	ONEKEY——安装Maven3.8.4
Gradle	内嵌于 Bigtop	ONEKEY——安装Gradle5.6.4

提示

如未配置上述环境，可参考本站 JDK、Maven、Gradle 文档。不仅有详细安装说明，还附带一键安装脚本与离线包下载，覆盖主流运维场景，极大提升稳定性与复现度。

2. 源码包准备与离线编译建议

Zeppelin 的源码包建议提前下载，默认存放路径为 /opt/modules/bigtop/dl/zeppelin-0.10.1.tar.gz，首次构建会自动检测，缺失时自动尝试联网下载。

警告

企业云环境/内网环境建议务必提前下载所有源码和依赖包，否则编译过程中网络波动或墙代理问题易致失败。

3. 一键构建命令与参数说明 推荐

进入 Bigtop 根目录后，直接执行如下命令：

gradle zeppelin-rpm -PparentDir=/usr/bigtop -Dbuildwithdeps=true -PpkgSuffix -d

如果没有下载过，会自动触发下载

参数	作用说明
-PparentDir	指定 Bigtop 根路径，推荐必填
-Dbuildwithdeps=true	强制自动拉取全部依赖组件，保证依赖完整
-PpkgSuffix	自定义包名后缀，选填
-d	输出详细调试日志，有助问题定位

注意

务必确认当前 JAVA_HOME、M2_HOME 等变量已正确指向实际路径，避免依赖找不到。

4. 编译流程与关键日志解析

执行 gradle 任务后，Bigtop 会自动串联底层脚本与 Maven 任务，核心日志示例：

-rw-r--r-- jzhang/wheel    4043 2022-02-24 03:36 zeppelin-0.10.1/zeppelin-distribution/src/assemble/distribution.xml
+ STATUS=0
+ '[' 0 -ne 0 ']'
+ cd zeppelin-0.10.1
+ /usr/bin/chmod -Rf a+rX,u+w,g-w,o-w .
+ echo 'Patch #0 (patch0-exclude-conflicting-packages.diff):'
Patch #0 (patch0-exclude-conflicting-packages.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file zeppelin-interpreter/pom.xml
patching file zeppelin-plugins/notebookrepo/filesystem/pom.xml
patching file zeppelin-server/pom.xml
patching file zeppelin-zengine/pom.xml
+ echo 'Patch #1 (patch1-installation-permission.diff):'
Patch #1 (patch1-installation-permission.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file zeppelin-web/package.json
patching file zeppelin-web/pom.xml
+ echo 'Patch #2 (patch2-remove-phantomjs-prebuilt-and-karma-arm64.diff):'
Patch #2 (patch2-remove-phantomjs-prebuilt-and-karma-arm64.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file zeppelin-web/package.json
+ echo 'Patch #3 (patch3-ZEPPELIN-COMPILE-FAST.diff):'
Patch #3 (patch3-ZEPPELIN-COMPILE-FAST.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file flink/flink-scala-2.11/flink-scala-parent/pom.xml
patching file flink/flink-scala-2.12/flink-scala-parent/pom.xml
patching file flink/flink-scala-parent/pom.xml
patching file rlang/pom.xml
patching file scripts/docker/spark-cluster-managers/spark_yarn_cluster/Dockerfile
patching file scripts/docker/zeppelin/bin/Dockerfile
patching file spark/pom.xml
patching file zeppelin-web/pom.xml
patching file zeppelin-zengine/src/test/java/org/apache/zeppelin/interpreter/integration/DownloadUtils.java
+ exit 0
Executing(%build): /bin/sh -e /var/tmp/rpm-tmp.xZC1By
+ umask 022
+ cd /opt/modules/bigtop/build/zeppelin/rpm//BUILD
+ cd zeppelin-0.10.1
+ bash /opt/modules/bigtop/build/zeppelin/rpm//SOURCES/do-component-build
++ dirname /opt/modules/bigtop/build/zeppelin/rpm//SOURCES/do-component-build
+ . /opt/modules/bigtop/build/zeppelin/rpm//SOURCES/bigtop.bom
++ ZOOKEEPER_VERSION=3.5.9
++ HADOOP_VERSION=3.3.4
++ HBASE_VERSION=2.4.13
++ HIVE_VERSION=3.1.3
++ TEZ_VERSION=0.10.1
++ OOZIE_VERSION=5.2.1
++ SOLR_VERSION=8.11.2
++ SPARK_VERSION=3.5.5
++ FLINK_VERSION=1.17.2
++ PHOENIX_VERSION=5.1.2
++ BIGTOP_GROOVY_VERSION=2.5.4
++ BIGTOP_UTILS_VERSION=3.2.0-SNAPSHOT
++ BIGTOP_SELECT_VERSION=3.2.0-SNAPSHOT
++ BIGTOP_JSVC_VERSION=1.2.4
++ ALLUXIO_VERSION=2.8.0
++ KAFKA_VERSION=2.8.1
++ YCSB_VERSION=0.17.0
++ ZEPPELIN_VERSION=0.10.1
++ GPDB_VERSION=5.28.5
++ AMBARI_VERSION=2.7.5
++ BIGTOP_AMBARI_MPACK_VERSION=2.7.5
++ LIVY_VERSION=0.7.1
++ RANGER_VERSION=2.4.0
++ SQOOP_VERSION=1.4.7
++ REDIS_VERSION=7.4.0
++ DOLPHINSCHEDULER_VERSION=3.2.2
++ DORIS_VERSION=2.1.7
++ NIGHTINGALE_VERSION=7.7.2
++ CATEGRAF_VERSION=0.4.1
++ VICTORIAMETRICS_VERSION=1.109.1
++ CLOUDBEAVER_VERSION=24.3.3
++ CELEBORN_VERSION=0.5.3
++ OZONE_VERSION=1.4.1
++ IMPALA_VERSION=4.4.1
++ TRINO_VERSION=474
++ HUDI_VERSION=1.0.1
++ PAIMON_VERSION=1.1.0
++ ATLAS_VERSION=2.4.0
++ SUPERSET_VERSION=4.1.2
++ JDK_VERSION=1.8
++ SCALA_VERSION=2.12.13
+ ZEPPELIN_SCALA_BINARY_VERSION=2.11
+ ./dev/change_scala_version.sh 2.11
./dev/../flink/flink1.10-shims/pom.xml
./dev/../flink/flink1.13-shims/pom.xml
./dev/../flink/flink-scala-2.11/pom.xml
./dev/../flink/flink-scala-2.11/flink-scala-parent/pom.xml
./dev/../flink/pom.xml
./dev/../flink/flink-scala-2.12/pom.xml
./dev/../flink/flink-scala-2.12/flink-scala-parent/pom.xml
./dev/../flink/flink-shims/pom.xml
./dev/../flink/flink-scala-parent/pom.xml
./dev/../flink/flink1.11-shims/pom.xml
./dev/../flink/flink1.14-shims/pom.xml
./dev/../flink/flink1.12-shims/pom.xml
./dev/../python/pom.xml
./dev/../hbase/pom.xml
./dev/../kotlin/pom.xml
./dev/../helium-dev/pom.xml
./dev/../zeppelin-web/pom.xml
./dev/../zeppelin-jupyter/pom.xml
./dev/../zeppelin-examples/zeppelin-example-horizontalbar/pom.xml
./dev/../zeppelin-examples/zeppelin-example-spell-markdown/pom.xml
./dev/../zeppelin-examples/pom.xml
./dev/../zeppelin-examples/zeppelin-example-spell-flowchart/pom.xml
./dev/../zeppelin-examples/zeppelin-example-clock/pom.xml
./dev/../zeppelin-examples/zeppelin-example-spell-echo/pom.xml
./dev/../zeppelin-examples/zeppelin-example-spell-translator/pom.xml
./dev/../bigquery/pom.xml
./dev/../cassandra/pom.xml
./dev/../shell/pom.xml
./dev/../zeppelin-interpreter-integration/pom.xml
./dev/../spark-submit/pom.xml
./dev/../zeppelin-jupyter-interpreter/pom.xml
./dev/../zeppelin-interpreter-shaded/pom.xml
./dev/../sap/pom.xml
./dev/../pom.xml
./dev/../alluxio/pom.xml
./dev/../zeppelin-client/pom.xml
./dev/../markdown/pom.xml
./dev/../livy/pom.xml
./dev/../sparql/pom.xml
./dev/../zeppelin-jupyter-interpreter-shaded/pom.xml
./dev/../zeppelin-integration/pom.xml
./dev/../mongodb/pom.xml
./dev/../zeppelin-interpreter-parent/pom.xml
./dev/../influxdb/pom.xml
./dev/../angular/pom.xml
./dev/../beam/pom.xml
./dev/../zeppelin-interpreter/pom.xml
./dev/../spark/spark-shims/pom.xml
./dev/../spark/scala-2.10/pom.xml
./dev/../spark/scala-2.10/spark-scala-parent/pom.xml
./dev/../spark/spark2-shims/pom.xml
./dev/../spark/pom.xml
./dev/../spark/scala-2.11/pom.xml
./dev/../spark/scala-2.11/spark-scala-parent/pom.xml
./dev/../spark/scala-2.12/pom.xml
./dev/../spark/scala-2.12/spark-scala-parent/pom.xml
./dev/../spark/spark3-shims/pom.xml
./dev/../spark/spark-scala-parent/pom.xml
./dev/../spark/interpreter/pom.xml
./dev/../spark/spark-dependencies/pom.xml
./dev/../spark/spark1-shims/pom.xml
./dev/../ignite/pom.xml
./dev/../flink-cmd/pom.xml
./dev/../hazelcastjet/pom.xml
./dev/../zeppelin-web-angular/pom.xml
./dev/../zeppelin-common/pom.xml
./dev/../jdbc/pom.xml
./dev/../zeppelin-plugins/pom.xml
./dev/../zeppelin-plugins/launcher/cluster/pom.xml
./dev/../zeppelin-plugins/launcher/flink/pom.xml
./dev/../zeppelin-plugins/launcher/k8s-standard/pom.xml
./dev/../zeppelin-plugins/launcher/yarn/pom.xml
./dev/../zeppelin-plugins/launcher/docker/pom.xml
./dev/../zeppelin-plugins/notebookrepo/gcs/pom.xml
./dev/../zeppelin-plugins/notebookrepo/oss/pom.xml
./dev/../zeppelin-plugins/notebookrepo/mongo/pom.xml
./dev/../zeppelin-plugins/notebookrepo/filesystem/pom.xml
./dev/../zeppelin-plugins/notebookrepo/azure/pom.xml
./dev/../zeppelin-plugins/notebookrepo/github/pom.xml
./dev/../zeppelin-plugins/notebookrepo/zeppelin-hub/pom.xml
./dev/../zeppelin-plugins/notebookrepo/s3/pom.xml
./dev/../rlang/pom.xml
./dev/../file/pom.xml
./dev/../kylin/pom.xml
./dev/../lens/pom.xml
./dev/../zeppelin-server/pom.xml
./dev/../scio/pom.xml
./dev/../submarine/pom.xml
./dev/../pig/pom.xml
./dev/../java/pom.xml
./dev/../zeppelin-zengine/pom.xml
./dev/../zeppelin-distribution/pom.xml
./dev/../geode/pom.xml
./dev/../groovy/pom.xml
./dev/../ksql/pom.xml
./dev/../zeppelin-client-examples/pom.xml
./dev/../elasticsearch/pom.xml
./dev/../scalding/pom.xml
./dev/../zeppelin-display/pom.xml
./dev/../neo4j/pom.xml
+ EXCLUDE_INTERPRETERS='!beam,!hbase,!pig,!jdbc,!flink,!ignite,!kylin,!lens,!cassandra,!elasticsearch,!bigquery,!alluxio,!scio,!groovy,!sap,!java,!geode,!neo4j,!hazelcastjet,!submarine,!sp
arql,!mongodb,!ksql,!scalding'
+ ZEPPELIN_LIVY_VERSION=0.7.1-incubating
+ BUILD_OPTS='-Dhadoop3.2.version=3.3.4             -Dlivy.version=0.7.1-incubating             -Pscala-2.11             -Phadoop3             -Pbuild-distr'
+ '[' x86_64 = powerpc64le ']'
+ '[' '' = true ']'
+ BUILD_OPTS='-Dhadoop3.2.version=3.3.4             -Dlivy.version=0.7.1-incubating             -Pscala-2.11             -Phadoop3             -Pbuild-distr -DskipTests'
+ export 'MAVEN_OPTS=-Xmx1500m -Xms1500m'
+ MAVEN_OPTS='-Xmx1500m -Xms1500m'
+ sed -i 's/^.*ZEPPELIN_PID=.*$/ZEPPELIN_PID="$\{ZEPPELIN_PID_DIR\}\/zeppelin\-$\{ZEPPELIN_IDENT_STRING\}\.pid"/' bin/zeppelin-daemon.sh
+ mvn -Dhadoop3.2.version=3.3.4 -Dlivy.version=0.7.1-incubating -Pscala-2.11 -Phadoop3 -Pbuild-distr -DskipTests clean package -pl '!beam,!hbase,!pig,!jdbc,!flink,!ignite,!kylin,!lens,!cas
sandra,!elasticsearch,!bigquery,!alluxio,!scio,!groovy,!sap,!java,!geode,!neo4j,!hazelcastjet,!submarine,!sparql,!mongodb,!ksql,!scalding' -am
[INFO] Scanning for projects...
Downloading from nexus: http://172.20.0.2:8081/repository/maven-public/kr/motd/maven/os-maven-plugin/1.4.1.Final/os-maven-plugin-1.4.1.Final.pom
Progress (1): 6.2 kBEXECUTING [11s]

Downloaded from nexus: http://172.20.0.2:8081/repository/maven-public/kr/motd/maven/os-maven-plugin/1.4.1.Final/os-maven-plugin-1.4.1.Final.pom (6.2 kB at 9.2 kB/s)
Downloading from nexus: http://172.20.0.2:8081/repository/maven-public/kr/motd/maven/os-maven-plugin/1.4.1.Final/os-maven-plugin-1.4.1.Final.jar
Progress (1): 7.7/29 kB
Progress (1): 29 kB

Downloaded from nexus: http://172.20.0.2:8081/repository/maven-public/kr/motd/maven/os-maven-plugin/1.4.1.Final/os-maven-plugin-1.4.1.Final.jar (29 kB at 86 kB/s)
[INFO] ------------------------------------------------------------------------
[INFO] Detecting the operating system and CPU architecture
[INFO] -----

成功时，产物将归档到 output 目录，详见下节。编译日志片段

5. 编译产物与输出目录

最终产物在如下路径：

/opt/modules/bigtop/output/zeppelin/x86_64

例如：

[root@rocky8 x86_64]# ll
total 791664
drwxr-xr-x 2 root root      4096 Jun  8 08:28 .
drwxr-xr-x 3 root root      4096 Jun  8 08:28 ..
-rw-r--r-- 1 root root 810651320 Jun  8 08:28 zeppelin_3_2_0-0.10.1-1.el8.x86_64.rpm
[root@rocky8 x86_64]# pwd
/opt/modules/bigtop/output/zeppelin/x86_64
[root@rocky8 x86_64]#

6. 常见问题与后续集成

Zeppelin 包二次开发与适配过程常需涉及如下修改（参考实际业务需求可按需调整）：

按顺序修改即可