Skip to content

Commit 23058ad

Browse files
authored
[Docs] Add upgrade notes for fluss package changes (#1869)
1 parent aa11a26 commit 23058ad

File tree

1 file changed

+58
-0
lines changed

1 file changed

+58
-0
lines changed

website/docs/maintenance/operations/upgrade-notes-0.8.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,64 @@ However, we **strongly recommend upgrading to Java 11 or higher** to ensure comp
2323
🔁 **If you’re using Fluss with Apache Flink**:
2424
Please also upgrade your Flink deployment to **Java 11 or above**. All Flink versions currently supported by Fluss are fully compatible with Java 11.
2525

26+
## Java client: Package and GroupId Migration
27+
28+
🔧 **Action Required**: All Java client users must update their dependencies and import statements to continue using Fluss.
29+
30+
### What Changed
31+
32+
| Aspect | Fluss v0.7 | Fluss v0.8 |
33+
|-------------|------------------------------|----------------------------|
34+
| **GroupId** | `com.alibaba.fluss` | `org.apache.fluss` |
35+
| **Package** | `com.alibaba.fluss` | `org.apache.fluss` |
36+
37+
**Note**: This change does not affect the Fluss client API.
38+
39+
### Impact Assessment
40+
41+
**All Java client users** will need to update their dependencies and import statements:
42+
43+
1. **Build Dependencies**: Update your Maven/Gradle dependencies to use the new groupId
44+
2. **Import Statements**: Update all import statements from `com.alibaba.fluss.*` to `org.apache.fluss.*`
45+
46+
### Migration Steps
47+
48+
1. **Update Maven Dependencies**:
49+
```xml
50+
<!-- Old dependency -->
51+
<dependency>
52+
<groupId>com.alibaba.fluss</groupId>
53+
<artifactId>fluss-client</artifactId>
54+
<version>0.7.x</version>
55+
</dependency>
56+
57+
<!-- New dependency -->
58+
<dependency>
59+
<groupId>org.apache.fluss</groupId>
60+
<artifactId>fluss-client</artifactId>
61+
<version>0.8.0</version>
62+
</dependency>
63+
```
64+
65+
2. **Update Import Statements**:
66+
```java
67+
// Old imports
68+
import com.alibaba.fluss.client.Connection;
69+
import com.alibaba.fluss.client.ConnectionFactory;
70+
71+
// New imports
72+
import org.apache.fluss.client.Connection;
73+
import org.apache.fluss.client.ConnectionFactory;
74+
```
75+
76+
### Why This Change Was Made
77+
78+
This change represents an important milestone in Fluss's journey to becoming an Apache project. The migration to `org.apache.fluss`:
79+
80+
- Aligns with the Apache Software Foundation's naming conventions
81+
- Establishes a clear, independent identity for the project
82+
- Ensures long-term stability and governance under the Apache umbrella
83+
2684
## Metrics Updates
2785

2886
We have updated the report level for some metrics and also removed some metrics, this greatly reduces the metrics amount and improves the performance.

0 commit comments

Comments
 (0)