From 9124f860c7ba81a5c0090cfcf93e02e80bd04a38 Mon Sep 17 00:00:00 2001
From: Vipamp <ahheqingsong@126.com>
Date: Sun, 22 Dec 2024 17:18:38 +0800
Subject: [PATCH 1/3] [dist] generate release-bin tar file

---
 fluss-dist/pom.xml                          |  12 ++
 fluss-dist/src/main/assemblies/assembly.xml | 157 ++++++++++++++++++++
 2 files changed, 169 insertions(+)
 create mode 100644 fluss-dist/src/main/assemblies/assembly.xml

diff --git a/fluss-dist/pom.xml b/fluss-dist/pom.xml
index e912c801..f4b72b50 100644
--- a/fluss-dist/pom.xml
+++ b/fluss-dist/pom.xml
@@ -245,6 +245,18 @@
                             </descriptors>
                         </configuration>
                     </execution>
+                    <execution>
+                        <id>assembly</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <descriptors>
+                                <descriptor>src/main/assemblies/assembly.xml</descriptor>
+                            </descriptors>
+                        </configuration>
+                    </execution>
                 </executions>
             </plugin>
         </plugins>
diff --git a/fluss-dist/src/main/assemblies/assembly.xml b/fluss-dist/src/main/assemblies/assembly.xml
new file mode 100644
index 00000000..ad6f8c83
--- /dev/null
+++ b/fluss-dist/src/main/assemblies/assembly.xml
@@ -0,0 +1,157 @@
+<!--
+ Copyright (c) 2024 Alibaba Group Holding Ltd.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<assembly>
+    <id>dist</id>
+    <formats>
+        <format>dir</format>
+        <format>tar.gz</format>
+    </formats>
+
+    <includeBaseDirectory>true</includeBaseDirectory>
+    <baseDirectory>fluss-${project.version}-bin</baseDirectory>
+
+    <dependencySets>
+        <dependencySet>
+            <outputDirectory>lib</outputDirectory>
+            <unpack>false</unpack>
+            <useProjectArtifact>false</useProjectArtifact>
+            <useProjectAttachments>false</useProjectAttachments>
+            <useTransitiveDependencies>true</useTransitiveDependencies>
+            <useTransitiveFiltering>true</useTransitiveFiltering>
+
+            <includes>
+                <include>org.apache.logging.log4j:log4j-api</include>
+                <include>org.apache.logging.log4j:log4j-core</include>
+                <include>org.apache.logging.log4j:log4j-slf4j-impl</include>
+                <include>org.apache.logging.log4j:log4j-1.2-api</include>
+            </includes>
+        </dependencySet>
+    </dependencySets>
+
+    <files>
+        <!-- copy license -->
+        <file>
+            <source>../LICENSE</source>
+            <outputDirectory/>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <!-- copy notice -->
+        <file>
+            <source>../NOTICE</source>
+            <outputDirectory/>
+            <fileMode>0644</fileMode>
+        </file>
+
+
+        <!-- lib -->
+        <file>
+            <source>../fluss-server/target/fluss-server-${project.version}.jar</source>
+            <outputDirectory>lib</outputDirectory>
+            <destName>fluss-server-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <!-- opt -->
+        <file>
+            <source>../fluss-lakehouse/fluss-lakehouse-cli/target/fluss-lakehouse-cli-${project.version}.jar</source>
+            <outputDirectory>opt</outputDirectory>
+            <destName>fluss-lakehouse-cli-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <file>
+            <source>../fluss-lakehouse/fluss-lakehouse-paimon/target/fluss-lakehouse-paimon-${project.version}.jar
+            </source>
+            <outputDirectory>opt</outputDirectory>
+            <destName>fluss-lakehouse-paimon-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <!-- filesystem -->
+        <!-- output directory should correspond to the file system *schema* name, i.e., plugins/<schema>/  -->
+        <file>
+            <source>
+                ../fluss-filesystems/fluss-fs-hadoop/target/fluss-fs-hadoop-${project.version}-with-dependencies.jar
+            </source>
+            <outputDirectory>plugins/hdfs/</outputDirectory>
+            <destName>fluss-fs-hadoop-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <file>
+            <source>../fluss-filesystems/fluss-fs-oss/target/fluss-fs-oss-${project.version}.jar</source>
+            <outputDirectory>plugins/oss/</outputDirectory>
+            <destName>fluss-fs-oss-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <file>
+            <source>../fluss-filesystems/fluss-fs-s3/target/fluss-fs-s3-${project.version}.jar</source>
+            <outputDirectory>plugins/s3/</outputDirectory>
+            <destName>fluss-fs-s3-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <!-- metrics -->
+        <file>
+            <source>../fluss-metrics/fluss-metrics-prometheus/target/fluss-metrics-prometheus-${project.version}.jar
+            </source>
+            <outputDirectory>plugins/prometheus/</outputDirectory>
+            <destName>fluss-metrics-prometheus-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <file>
+            <source>../fluss-metrics/fluss-metrics-jmx/target/fluss-metrics-jmx-${project.version}.jar</source>
+            <outputDirectory>plugins/jmx/</outputDirectory>
+            <destName>fluss-metrics-jmx-${project.version}.jar</destName>
+            <fileMode>0644</fileMode>
+        </file>
+
+        <file>
+            <source>src/main/resources/server.yaml</source>
+            <outputDirectory>conf</outputDirectory>
+            <fileMode>0644</fileMode>
+        </file>
+    </files>
+
+    <fileSets>
+        <!-- copy bin -->
+        <fileSet>
+            <directory>src/main/resources/bin</directory>
+            <outputDirectory>bin</outputDirectory>
+            <fileMode>0755</fileMode>
+        </fileSet>
+
+        <!-- copy conf -->
+        <fileSet>
+            <directory>src/main/resources/conf</directory>
+            <outputDirectory>conf</outputDirectory>
+            <fileMode>0644</fileMode>
+        </fileSet>
+
+        <!-- empty log -->
+        <fileSet>
+            <directory>src/main/resources/</directory>
+            <outputDirectory>log</outputDirectory>
+            <fileMode>0644</fileMode>
+            <excludes>
+                <exclude>**/*</exclude>
+            </excludes>
+        </fileSet>
+    </fileSets>
+</assembly>

From 204554a44d5004a52e37215d7e76407ea9405d6b Mon Sep 17 00:00:00 2001
From: Vipamp <ahheqingsong@126.com>
Date: Wed, 25 Dec 2024 23:59:14 +0800
Subject: [PATCH 2/3] [dist] generate release-bin tar file

---
 fluss-dist/pom.xml                          |   4 +-
 fluss-dist/src/main/assemblies/assembly.xml | 157 --------------------
 fluss-dist/src/main/assemblies/tgz.xml      |  34 +++++
 website/docs/dev/building.md                |   5 +-
 4 files changed, 40 insertions(+), 160 deletions(-)
 delete mode 100644 fluss-dist/src/main/assemblies/assembly.xml
 create mode 100644 fluss-dist/src/main/assemblies/tgz.xml

diff --git a/fluss-dist/pom.xml b/fluss-dist/pom.xml
index f4b72b50..1e28dce4 100644
--- a/fluss-dist/pom.xml
+++ b/fluss-dist/pom.xml
@@ -246,14 +246,14 @@
                         </configuration>
                     </execution>
                     <execution>
-                        <id>assembly</id>
+                        <id>tgz</id>
                         <phase>package</phase>
                         <goals>
                             <goal>single</goal>
                         </goals>
                         <configuration>
                             <descriptors>
-                                <descriptor>src/main/assemblies/assembly.xml</descriptor>
+                                <descriptor>src/main/assemblies/tgz.xml</descriptor>
                             </descriptors>
                         </configuration>
                     </execution>
diff --git a/fluss-dist/src/main/assemblies/assembly.xml b/fluss-dist/src/main/assemblies/assembly.xml
deleted file mode 100644
index ad6f8c83..00000000
--- a/fluss-dist/src/main/assemblies/assembly.xml
+++ /dev/null
@@ -1,157 +0,0 @@
-<!--
- Copyright (c) 2024 Alibaba Group Holding Ltd.
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-<assembly>
-    <id>dist</id>
-    <formats>
-        <format>dir</format>
-        <format>tar.gz</format>
-    </formats>
-
-    <includeBaseDirectory>true</includeBaseDirectory>
-    <baseDirectory>fluss-${project.version}-bin</baseDirectory>
-
-    <dependencySets>
-        <dependencySet>
-            <outputDirectory>lib</outputDirectory>
-            <unpack>false</unpack>
-            <useProjectArtifact>false</useProjectArtifact>
-            <useProjectAttachments>false</useProjectAttachments>
-            <useTransitiveDependencies>true</useTransitiveDependencies>
-            <useTransitiveFiltering>true</useTransitiveFiltering>
-
-            <includes>
-                <include>org.apache.logging.log4j:log4j-api</include>
-                <include>org.apache.logging.log4j:log4j-core</include>
-                <include>org.apache.logging.log4j:log4j-slf4j-impl</include>
-                <include>org.apache.logging.log4j:log4j-1.2-api</include>
-            </includes>
-        </dependencySet>
-    </dependencySets>
-
-    <files>
-        <!-- copy license -->
-        <file>
-            <source>../LICENSE</source>
-            <outputDirectory/>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <!-- copy notice -->
-        <file>
-            <source>../NOTICE</source>
-            <outputDirectory/>
-            <fileMode>0644</fileMode>
-        </file>
-
-
-        <!-- lib -->
-        <file>
-            <source>../fluss-server/target/fluss-server-${project.version}.jar</source>
-            <outputDirectory>lib</outputDirectory>
-            <destName>fluss-server-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <!-- opt -->
-        <file>
-            <source>../fluss-lakehouse/fluss-lakehouse-cli/target/fluss-lakehouse-cli-${project.version}.jar</source>
-            <outputDirectory>opt</outputDirectory>
-            <destName>fluss-lakehouse-cli-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <file>
-            <source>../fluss-lakehouse/fluss-lakehouse-paimon/target/fluss-lakehouse-paimon-${project.version}.jar
-            </source>
-            <outputDirectory>opt</outputDirectory>
-            <destName>fluss-lakehouse-paimon-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <!-- filesystem -->
-        <!-- output directory should correspond to the file system *schema* name, i.e., plugins/<schema>/  -->
-        <file>
-            <source>
-                ../fluss-filesystems/fluss-fs-hadoop/target/fluss-fs-hadoop-${project.version}-with-dependencies.jar
-            </source>
-            <outputDirectory>plugins/hdfs/</outputDirectory>
-            <destName>fluss-fs-hadoop-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <file>
-            <source>../fluss-filesystems/fluss-fs-oss/target/fluss-fs-oss-${project.version}.jar</source>
-            <outputDirectory>plugins/oss/</outputDirectory>
-            <destName>fluss-fs-oss-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <file>
-            <source>../fluss-filesystems/fluss-fs-s3/target/fluss-fs-s3-${project.version}.jar</source>
-            <outputDirectory>plugins/s3/</outputDirectory>
-            <destName>fluss-fs-s3-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <!-- metrics -->
-        <file>
-            <source>../fluss-metrics/fluss-metrics-prometheus/target/fluss-metrics-prometheus-${project.version}.jar
-            </source>
-            <outputDirectory>plugins/prometheus/</outputDirectory>
-            <destName>fluss-metrics-prometheus-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <file>
-            <source>../fluss-metrics/fluss-metrics-jmx/target/fluss-metrics-jmx-${project.version}.jar</source>
-            <outputDirectory>plugins/jmx/</outputDirectory>
-            <destName>fluss-metrics-jmx-${project.version}.jar</destName>
-            <fileMode>0644</fileMode>
-        </file>
-
-        <file>
-            <source>src/main/resources/server.yaml</source>
-            <outputDirectory>conf</outputDirectory>
-            <fileMode>0644</fileMode>
-        </file>
-    </files>
-
-    <fileSets>
-        <!-- copy bin -->
-        <fileSet>
-            <directory>src/main/resources/bin</directory>
-            <outputDirectory>bin</outputDirectory>
-            <fileMode>0755</fileMode>
-        </fileSet>
-
-        <!-- copy conf -->
-        <fileSet>
-            <directory>src/main/resources/conf</directory>
-            <outputDirectory>conf</outputDirectory>
-            <fileMode>0644</fileMode>
-        </fileSet>
-
-        <!-- empty log -->
-        <fileSet>
-            <directory>src/main/resources/</directory>
-            <outputDirectory>log</outputDirectory>
-            <fileMode>0644</fileMode>
-            <excludes>
-                <exclude>**/*</exclude>
-            </excludes>
-        </fileSet>
-    </fileSets>
-</assembly>
diff --git a/fluss-dist/src/main/assemblies/tgz.xml b/fluss-dist/src/main/assemblies/tgz.xml
new file mode 100644
index 00000000..77eb70a0
--- /dev/null
+++ b/fluss-dist/src/main/assemblies/tgz.xml
@@ -0,0 +1,34 @@
+<!--
+ Copyright (c) 2024 Alibaba Group Holding Ltd.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<assembly
+        xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">
+    <id>tgt</id>
+    <formats>
+        <format>tgz</format>
+    </formats>
+    <baseDirectory>fluss-${project.version}</baseDirectory>
+    <fileSets>
+        <fileSet>
+            <directory>${project.basedir}/target/fluss-${project.version}-bin/fluss-${project.version}</directory>
+            <outputDirectory>/</outputDirectory>
+            <includes>
+                <include>**/*</include>
+            </includes>
+        </fileSet>
+    </fileSets>
+</assembly>
\ No newline at end of file
diff --git a/website/docs/dev/building.md b/website/docs/dev/building.md
index 96c788e8..5ff24d03 100644
--- a/website/docs/dev/building.md
+++ b/website/docs/dev/building.md
@@ -33,4 +33,7 @@ To speed up the build you can:
 The build script will be:
 ```bash
 mvn clean install -DskipTests -T 1C
-```
\ No newline at end of file
+```
+After building success, there are two ways for you to use.
+- For local testing, it's recommend to use directory `${project}/build-target` in project.
+- For deploying distributed cluster, it's recommend to use binary file named `fluss-xxx-bin.tgz`, the file is in directory `${project}/fluss-dist/target`.
\ No newline at end of file

From ac2f3c1dbf6fb3499ab33dc5467dcbd2d6c81eec Mon Sep 17 00:00:00 2001
From: Vipamp <ahheqingsong@126.com>
Date: Thu, 26 Dec 2024 00:02:25 +0800
Subject: [PATCH 3/3] [dist] generate release-bin tar file

---
 website/docs/dev/building.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/website/docs/dev/building.md b/website/docs/dev/building.md
index 5ff24d03..368bc68c 100644
--- a/website/docs/dev/building.md
+++ b/website/docs/dev/building.md
@@ -34,6 +34,7 @@ The build script will be:
 ```bash
 mvn clean install -DskipTests -T 1C
 ```
-After building success, there are two ways for you to use.
+
+**NOTE**:
 - For local testing, it's recommend to use directory `${project}/build-target` in project.
 - For deploying distributed cluster, it's recommend to use binary file named `fluss-xxx-bin.tgz`, the file is in directory `${project}/fluss-dist/target`.
\ No newline at end of file