This is an automated email from the ASF dual-hosted git repository.
davidzollo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/seatunnel-shade.git
The following commit(s) were added to refs/heads/main by this push:
new ab62f00 [Improve][Shade] Prepare 3.0.2-SNAPSHOT and align README with
3.0.1 (#29)
ab62f00 is described below
commit ab62f00a3c54acbe0a530ddf6e291325d18b5748
Author: zhiweiniu <[email protected]>
AuthorDate: Tue Nov 17 14:43:15 2026 +0800
[Improve][Shade] Prepare 3.0.2-SNAPSHOT and align README with 3.0.1 (#29)
---
README.md | 73 +++++++++++++++++++---------------
pom.xml | 4 +-
seatunnel-shade-arrow/pom.xml | 2 +-
seatunnel-shade-calcite/pom.xml | 2 +-
seatunnel-shade-commons-lang3/pom.xml | 2 +-
seatunnel-shade-guava/pom.xml | 2 +-
seatunnel-shade-hadoop-aws/pom.xml | 2 +-
seatunnel-shade-hadoop3-uber/pom.xml | 2 +-
seatunnel-shade-hazelcast/pom.xml | 2 +-
seatunnel-shade-hikari/pom.xml | 2 +-
seatunnel-shade-jackson-yaml/pom.xml | 2 +-
seatunnel-shade-jackson/pom.xml | 2 +-
seatunnel-shade-janino/pom.xml | 2 +-
seatunnel-shade-jetty/pom.xml | 2 +-
seatunnel-shade-scala-compiler/pom.xml | 2 +-
seatunnel-shade-thrift-service/pom.xml | 2 +-
16 files changed, 57 insertions(+), 48 deletions(-)
diff --git a/README.md b/README.md
index 8fecb2c..b748e49 100644
--- a/README.md
+++ b/README.md
@@ -4,11 +4,14 @@ Apache SeaTunnel Shade — shaded (relocated) JARs of
third-party libraries for
Each module wraps a single third-party library, relocating its packages under
`org.apache.seatunnel.shade.*` to avoid classpath conflicts when SeaTunnel
itself depends on different versions of the same libraries.
+The latest release is **3.0.1** (`v3.0.1`). The `main` branch builds
**3.0.2-SNAPSHOT**.
+Release and consumer examples below use the published 3.0.1 baseline.
+
## Modules
-| Module | Library | Version |
+| Module | Library | Library version in 3.0.1 |
|----------------------------------|---------|---------|
-| `seatunnel-shade-hazelcast` | Hazelcast | 5.1 |
+| `seatunnel-shade-hazelcast` | Hazelcast | 5.1.7 |
| `seatunnel-shade-hadoop3-uber` | Hadoop Client | 3.1.4 |
| `seatunnel-shade-jackson` | Jackson | 2.15.4 |
| `seatunnel-shade-guava` | Guava | 27.0-jre |
@@ -18,13 +21,15 @@ Each module wraps a single third-party library, relocating
its packages under `o
| `seatunnel-shade-thrift-service` | Apache Doris Thrift | 1.0.0 |
| `seatunnel-shade-janino` | Janino | 3.1.12 |
| `seatunnel-shade-scala-compiler` | Scala Compiler | 2.12.15 |
-| `seatunnel-shade-jetty` | Jetty | 9.4.56 |
+| `seatunnel-shade-jetty` | Jetty | 9.4.56.v20240826 |
| `seatunnel-shade-commons-lang3` | Commons Lang3 | 3.18.0 |
| `seatunnel-shade-calcite` | Apache Calcite | 1.38.0 |
| `seatunnel-shade-jackson-yaml` | Jackson | 2.15.4 |
## Build
+Builds from `main` use the `3.0.2-SNAPSHOT` shade suffix, for example
`5.1.7-3.0.2-SNAPSHOT` for Hazelcast.
+
```bash
# Full build (skip tests, skip RAT license check)
mvn -B -DskipTests -Drat.skip=true clean install
@@ -43,7 +48,9 @@ mvn -B -DskipTests -pl seatunnel-shade-guava clean install
### Full release
-Deploy all modules:
+Deploy all modules from a prepared release checkout. Set both the root POM
version and
+`seatunnel.shade.version`, together with every child POM's parent version, to
the release
+version before deploying. For 3.0.1, all three use `3.0.1`.
```bash
mvn -B -DskipTests -Drat.skip=true clean deploy
@@ -71,60 +78,62 @@ mvn -B -DskipTests -Drat.skip=true \
**Key points**:
-- **First release (all modules)**: Set `seatunnel.shade.version` in root
`pom.xml` and use `${library.version}-${seatunnel.shade.version}` for all
module versions. Root POM `<version>` must be the actual release version (e.g.
`3.0.0`, not `${revision}`), otherwise Nexus will reject the deployment.
+- **Full release (all modules)**: Set `seatunnel.shade.version` in root
`pom.xml` and use `${library.version}-${seatunnel.shade.version}` for all
module versions. Root POM `<version>` and every child POM's parent version must
be the actual release version (e.g. `3.0.1`, not `${revision}`).
- **Incremental release (partial modules)**: After the parent POM is released,
its `<properties>` cannot be updated in a new release. Override the library
version in the child module's own `<properties>` block, then use the same
`${lib.version}-${seatunnel.shade.version}` expression — it will resolve to the
child's property value, not the parent's. The version string must differ from
already-published artifacts to avoid a Nexus 400 conflict.
-- **Never** run `mvn clean deploy` without `-pl` — unchanged modules will be
redeployed, and Nexus will reject them with a 400 error.
+- **For a partial release**, run `mvn clean deploy` with `-pl` — unchanged
modules must not be redeployed, or Nexus will reject them with a 400 error.
- If only the shade plugin configuration changed (not the library version),
you must bump the version manually before deploying.
-**Background**: The shade project must release before its consumers (e.g.
`apache/seatunnel`) can build. Once `seatunnel-shade:3.0.0` is published, its
POM properties are frozen. A child module that continues referencing the
parent's property will resolve to the old value, since the parent's
`<properties>` cannot be updated in an incremental release. The fix is to
declare the updated property in the child module's own `<properties>` block —
Maven child properties override parent properti [...]
+**Background**: The shade project must release before its consumers (e.g.
`apache/seatunnel`) can build. Once `seatunnel-shade:3.0.1` is published, its
POM properties are frozen. A child module that continues referencing the
parent's property will resolve to the old value, since the parent's
`<properties>` cannot be updated in an incremental release. The fix is to
declare the updated property in the child module's own `<properties>` block —
Maven child properties override parent properti [...]
-**Incremental release example** (upgrading janino `3.0.11` → `3.1.12`):
+**Incremental release example** (upgrading Hazelcast `5.1.7` → `5.3.5`):
Parent `pom.xml` (already released, cannot be changed):
```xml
-<janino.verion>3.0.11</janino.verion>
+<hazelcast.version>5.1.7</hazelcast.version>
```
-Child `seatunnel-shade-janino/pom.xml` **before** incremental release:
+Child `seatunnel-shade-hazelcast/pom.xml` **before** incremental release:
```xml
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.0</version>
+ <version>3.0.1</version>
</parent>
-<artifactId>seatunnel-shade-janino</artifactId>
-<version>${janino.verion}-${seatunnel.shade.version}</version>
+<artifactId>seatunnel-shade-hazelcast</artifactId>
+<version>${hazelcast.version}-${seatunnel.shade.version}</version>
```
-Child `seatunnel-shade-janino/pom.xml` **after** incremental release:
+Child `seatunnel-shade-hazelcast/pom.xml` **after** incremental release:
```xml
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.0</version>
+ <version>3.0.1</version>
</parent>
+<artifactId>seatunnel-shade-hazelcast</artifactId>
+<version>${hazelcast.version}-${seatunnel.shade.version}</version> <!--
resolves to 5.3.5-3.0.1 -->
+
<properties>
- <janino.verion>3.1.12</janino.verion> <!-- overrides parent's property
-->
+ <hazelcast.version>5.3.5</hazelcast.version> <!-- overrides parent's
property -->
</properties>
-
-<artifactId>seatunnel-shade-janino</artifactId>
-<version>${janino.verion}-${seatunnel.shade.version}</version> <!-- resolves
to 3.1.12-3.0.0 -->
```
Deploy with `-pl` to avoid touching unchanged modules:
```bash
-mvn -B -DskipTests -Drat.skip=true -pl seatunnel-shade-janino clean deploy
+mvn -B -DskipTests -Drat.skip=true -pl seatunnel-shade-hazelcast clean deploy
```
### Tagging
```bash
-git tag v3.0.0.fix
-git push origin v3.0.0.fix
+git tag v3.0.1
+git push origin v3.0.1
```
+`v3.0.1` is the existing release tag; use a new tag for the next release.
+
## Adding a new module
1. Add the new module to `<modules>` and `<properties>` in root `pom.xml`.
@@ -137,7 +146,7 @@ git push origin v3.0.0.fix
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.0</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-xxx</artifactId>
@@ -205,25 +214,26 @@ In SeaTunnel's root `pom.xml`, each shade module has a
corresponding version pro
```xml
<properties>
- <seatunnel.shade.version>3.0.0</seatunnel.shade.version>
+ <seatunnel.shade.version>3.0.1</seatunnel.shade.version>
+
<seatunnel.shade.hazelcast.version>5.1.7</seatunnel.shade.hazelcast.version>
<seatunnel.shade.guava.version>27.0-jre</seatunnel.shade.guava.version>
- <seatunnel.shade.janino.version>3.0.11</seatunnel.shade.janino.version>
+ <seatunnel.shade.janino.version>3.1.12</seatunnel.shade.janino.version>
<seatunnel.shade.scala-compiler.version>2.12.15</seatunnel.shade.scala-compiler.version>
<seatunnel.shade.calcite.version>1.38.0</seatunnel.shade.calcite.version>
<!-- ... other shade modules ... -->
</properties>
```
-The effective dependency version is assembled as
`${seatunnel.shade.<lib>.version}-${seatunnel.shade.version}` (e.g.
`1.38.0-3.0.0`).
+The effective dependency version is assembled as
`${seatunnel.shade.<lib>.version}-${seatunnel.shade.version}` (e.g.
`1.38.0-3.0.1`).
-When a shade module is updated, bump the corresponding `<lib>.version`
property. For example, after upgrading janino from `3.0.11` to `3.1.12`:
+When a shade module is updated, bump the corresponding `<lib>.version`
property. For example, after a partial release upgrading Hazelcast from `5.1.7`
to `5.3.5`:
```diff
-- <seatunnel.shade.janino.version>3.0.11</seatunnel.shade.janino.version>
-+ <seatunnel.shade.janino.version>3.1.12</seatunnel.shade.janino.version>
+- <seatunnel.shade.hazelcast.version>5.1.7</seatunnel.shade.hazelcast.version>
++ <seatunnel.shade.hazelcast.version>5.3.5</seatunnel.shade.hazelcast.version>
```
-If the `seatunnel.shade.version` itself changes (e.g. `3.0.0` → `3.0.1`), it
affects **all** shade dependencies and every module must be republished.
+If the `seatunnel.shade.version` itself changes (e.g. `3.0.1` → `3.0.2`), it
affects **all** shade dependencies and every module must be republished.
### 2. Declare the shaded dependency
@@ -237,7 +247,7 @@ All shade modules are centrally managed in SeaTunnel's root
`<dependencyManageme
</dependency>
```
-Existing entries (all 13 modules):
+Existing modules (14 in total) follow this pattern:
```xml
<dependency>
@@ -261,7 +271,6 @@ Existing entries (all 13 modules):
<version>${seatunnel.shade.calcite.version}-${seatunnel.shade.version}</version>
</dependency>
<!-- ... remaining modules follow the same pattern ... -->
-</dependency>
```
### Summary checklist
diff --git a/pom.xml b/pom.xml
index bb0f999..7a3a1fb 100644
--- a/pom.xml
+++ b/pom.xml
@@ -30,7 +30,7 @@
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
<packaging>pom</packaging>
<name>SeaTunnel : Shade :</name>
@@ -88,7 +88,7 @@
<maven-dependency-plugin.version>3.1.1</maven-dependency-plugin.version>
<maven-scm-provider-jgit.version>1.9.5</maven-scm-provider-jgit.version>
<seatunnel.shade.package>org.apache.seatunnel.shade</seatunnel.shade.package>
- <seatunnel.shade.version>3.0.1</seatunnel.shade.version>
+ <seatunnel.shade.version>3.0.2-SNAPSHOT</seatunnel.shade.version>
<jackson.version>2.15.4</jackson.version>
<arrow.version>15.0.1</arrow.version>
<enableSourceJarCreation>true</enableSourceJarCreation>
diff --git a/seatunnel-shade-arrow/pom.xml b/seatunnel-shade-arrow/pom.xml
index 35d8727..3a858c4 100644
--- a/seatunnel-shade-arrow/pom.xml
+++ b/seatunnel-shade-arrow/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-arrow</artifactId>
diff --git a/seatunnel-shade-calcite/pom.xml b/seatunnel-shade-calcite/pom.xml
index b378329..146806d 100644
--- a/seatunnel-shade-calcite/pom.xml
+++ b/seatunnel-shade-calcite/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-calcite</artifactId>
diff --git a/seatunnel-shade-commons-lang3/pom.xml
b/seatunnel-shade-commons-lang3/pom.xml
index 708b4cd..77cd7f2 100644
--- a/seatunnel-shade-commons-lang3/pom.xml
+++ b/seatunnel-shade-commons-lang3/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-commons-lang3</artifactId>
diff --git a/seatunnel-shade-guava/pom.xml b/seatunnel-shade-guava/pom.xml
index 27c00bf..14f9c9a 100644
--- a/seatunnel-shade-guava/pom.xml
+++ b/seatunnel-shade-guava/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-guava</artifactId>
diff --git a/seatunnel-shade-hadoop-aws/pom.xml
b/seatunnel-shade-hadoop-aws/pom.xml
index 7397f60..1109783 100644
--- a/seatunnel-shade-hadoop-aws/pom.xml
+++ b/seatunnel-shade-hadoop-aws/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-hadoop-aws</artifactId>
diff --git a/seatunnel-shade-hadoop3-uber/pom.xml
b/seatunnel-shade-hadoop3-uber/pom.xml
index 3f965c1..577bb66 100644
--- a/seatunnel-shade-hadoop3-uber/pom.xml
+++ b/seatunnel-shade-hadoop3-uber/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-hadoop3-uber</artifactId>
diff --git a/seatunnel-shade-hazelcast/pom.xml
b/seatunnel-shade-hazelcast/pom.xml
index 00d26dc..595a618 100644
--- a/seatunnel-shade-hazelcast/pom.xml
+++ b/seatunnel-shade-hazelcast/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-hazelcast</artifactId>
diff --git a/seatunnel-shade-hikari/pom.xml b/seatunnel-shade-hikari/pom.xml
index 3fb7a80..131dc2a 100644
--- a/seatunnel-shade-hikari/pom.xml
+++ b/seatunnel-shade-hikari/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-hikari</artifactId>
diff --git a/seatunnel-shade-jackson-yaml/pom.xml
b/seatunnel-shade-jackson-yaml/pom.xml
index 88c4e04..c592edf 100644
--- a/seatunnel-shade-jackson-yaml/pom.xml
+++ b/seatunnel-shade-jackson-yaml/pom.xml
@@ -19,7 +19,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-jackson-yaml</artifactId>
diff --git a/seatunnel-shade-jackson/pom.xml b/seatunnel-shade-jackson/pom.xml
index b0cbd80..3a8184e 100644
--- a/seatunnel-shade-jackson/pom.xml
+++ b/seatunnel-shade-jackson/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-jackson</artifactId>
diff --git a/seatunnel-shade-janino/pom.xml b/seatunnel-shade-janino/pom.xml
index 47f2907..f918175 100644
--- a/seatunnel-shade-janino/pom.xml
+++ b/seatunnel-shade-janino/pom.xml
@@ -24,7 +24,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-janino</artifactId>
diff --git a/seatunnel-shade-jetty/pom.xml b/seatunnel-shade-jetty/pom.xml
index 886fbe3..7b7db9a 100644
--- a/seatunnel-shade-jetty/pom.xml
+++ b/seatunnel-shade-jetty/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-jetty</artifactId>
diff --git a/seatunnel-shade-scala-compiler/pom.xml
b/seatunnel-shade-scala-compiler/pom.xml
index a9d9aa2..a3a6b50 100644
--- a/seatunnel-shade-scala-compiler/pom.xml
+++ b/seatunnel-shade-scala-compiler/pom.xml
@@ -24,7 +24,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<properties>
diff --git a/seatunnel-shade-thrift-service/pom.xml
b/seatunnel-shade-thrift-service/pom.xml
index 04d8954..b5fa845 100644
--- a/seatunnel-shade-thrift-service/pom.xml
+++ b/seatunnel-shade-thrift-service/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.seatunnel</groupId>
<artifactId>seatunnel-shade</artifactId>
- <version>3.0.1</version>
+ <version>3.0.2-SNAPSHOT</version>
</parent>
<artifactId>seatunnel-shade-thrift-service</artifactId>