This is an automated email from the ASF dual-hosted git repository.
lhotari pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git
The following commit(s) were added to refs/heads/main by this push:
new 7291fca77cd docs(adaptors-kafka): pin pulsar-client-kafka to last
released 2.11.0 (#1130)
7291fca77cd is described below
commit 7291fca77cd6103b9bbe2796667af0b5d73de347
Author: Vishal Kumar Singh <[email protected]>
AuthorDate: Wed Apr 22 19:45:56 2026 +0530
docs(adaptors-kafka): pin pulsar-client-kafka to last released 2.11.0
(#1130)
* docs(adaptors-kafka): pin version to 2.11.0 and note adapter release lag
Closes apache/pulsar#23554, closes apache/pulsar#23383.
The Pulsar Kafka wrapper (pulsar-client-kafka, pulsar-client-kafka-original)
lives in the apache/pulsar-adapters repository, and its last release on
Maven Central is 2.11.0 (March 2023). However, the docs currently use the
`@pulsar:version@` build-time placeholder for the `<version>` of those
artifacts, so the rendered pom snippet shows the current Pulsar broker
version (e.g. 3.3.1, 4.2.x). Readers copy-paste those coordinates and then
hit "artifact not found" on Maven Central because those versions do not
exist for the adapter.
Pin both artifacts to 2.11.0 in the docs and add a note at the top of the
page explaining the release lag, so users on modern Pulsar brokers still
get a working dependency declaration. Applied to the main `docs/` copy
plus every versioned copy where the placeholder would have resolved to a
non-existent adapter version (3.0.x through 4.2.x).
* Use @pulsar:version:adapters@
* Remove the release date information
---------
Co-authored-by: Lari Hotari <[email protected]>
---
docs/adaptors-kafka.md | 10 ++++++++--
versioned_docs/version-3.0.x/adaptors-kafka.md | 10 ++++++++--
versioned_docs/version-3.1.x/adaptors-kafka.md | 10 ++++++++--
versioned_docs/version-3.2.x/adaptors-kafka.md | 10 ++++++++--
versioned_docs/version-3.3.x/adaptors-kafka.md | 10 ++++++++--
versioned_docs/version-4.0.x/adaptors-kafka.md | 10 ++++++++--
versioned_docs/version-4.1.x/adaptors-kafka.md | 10 ++++++++--
versioned_docs/version-4.2.x/adaptors-kafka.md | 10 ++++++++--
8 files changed, 64 insertions(+), 16 deletions(-)
diff --git a/docs/adaptors-kafka.md b/docs/adaptors-kafka.md
index 4718b1bd648..1148d32df90 100644
--- a/docs/adaptors-kafka.md
+++ b/docs/adaptors-kafka.md
@@ -8,6 +8,12 @@ description: Learn to use the Pulsar Kafka compatibility
wrapper and configure P
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
To use the Pulsar Kafka compatibility wrapper, complete the following steps.
@@ -28,7 +34,7 @@ To use the Pulsar Kafka compatibility wrapper, complete the
following steps.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -46,7 +52,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
diff --git a/versioned_docs/version-3.0.x/adaptors-kafka.md
b/versioned_docs/version-3.0.x/adaptors-kafka.md
index 49761504779..5ddc365ef7d 100644
--- a/versioned_docs/version-3.0.x/adaptors-kafka.md
+++ b/versioned_docs/version-3.0.x/adaptors-kafka.md
@@ -7,6 +7,12 @@ sidebar_label: "Kafka client wrapper"
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
In an existing application, change the regular Kafka client dependency and
replace it with the Pulsar Kafka wrapper. Remove the following dependency in
`pom.xml`:
@@ -25,7 +31,7 @@ Then include this dependency for the Pulsar Kafka wrapper:
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -43,7 +49,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
diff --git a/versioned_docs/version-3.1.x/adaptors-kafka.md
b/versioned_docs/version-3.1.x/adaptors-kafka.md
index 49761504779..5ddc365ef7d 100644
--- a/versioned_docs/version-3.1.x/adaptors-kafka.md
+++ b/versioned_docs/version-3.1.x/adaptors-kafka.md
@@ -7,6 +7,12 @@ sidebar_label: "Kafka client wrapper"
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
In an existing application, change the regular Kafka client dependency and
replace it with the Pulsar Kafka wrapper. Remove the following dependency in
`pom.xml`:
@@ -25,7 +31,7 @@ Then include this dependency for the Pulsar Kafka wrapper:
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -43,7 +49,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
diff --git a/versioned_docs/version-3.2.x/adaptors-kafka.md
b/versioned_docs/version-3.2.x/adaptors-kafka.md
index 4718b1bd648..1148d32df90 100644
--- a/versioned_docs/version-3.2.x/adaptors-kafka.md
+++ b/versioned_docs/version-3.2.x/adaptors-kafka.md
@@ -8,6 +8,12 @@ description: Learn to use the Pulsar Kafka compatibility
wrapper and configure P
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
To use the Pulsar Kafka compatibility wrapper, complete the following steps.
@@ -28,7 +34,7 @@ To use the Pulsar Kafka compatibility wrapper, complete the
following steps.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -46,7 +52,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
diff --git a/versioned_docs/version-3.3.x/adaptors-kafka.md
b/versioned_docs/version-3.3.x/adaptors-kafka.md
index 4718b1bd648..1148d32df90 100644
--- a/versioned_docs/version-3.3.x/adaptors-kafka.md
+++ b/versioned_docs/version-3.3.x/adaptors-kafka.md
@@ -8,6 +8,12 @@ description: Learn to use the Pulsar Kafka compatibility
wrapper and configure P
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
To use the Pulsar Kafka compatibility wrapper, complete the following steps.
@@ -28,7 +34,7 @@ To use the Pulsar Kafka compatibility wrapper, complete the
following steps.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -46,7 +52,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
diff --git a/versioned_docs/version-4.0.x/adaptors-kafka.md
b/versioned_docs/version-4.0.x/adaptors-kafka.md
index 4718b1bd648..1148d32df90 100644
--- a/versioned_docs/version-4.0.x/adaptors-kafka.md
+++ b/versioned_docs/version-4.0.x/adaptors-kafka.md
@@ -8,6 +8,12 @@ description: Learn to use the Pulsar Kafka compatibility
wrapper and configure P
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
To use the Pulsar Kafka compatibility wrapper, complete the following steps.
@@ -28,7 +34,7 @@ To use the Pulsar Kafka compatibility wrapper, complete the
following steps.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -46,7 +52,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
diff --git a/versioned_docs/version-4.1.x/adaptors-kafka.md
b/versioned_docs/version-4.1.x/adaptors-kafka.md
index 4718b1bd648..1148d32df90 100644
--- a/versioned_docs/version-4.1.x/adaptors-kafka.md
+++ b/versioned_docs/version-4.1.x/adaptors-kafka.md
@@ -8,6 +8,12 @@ description: Learn to use the Pulsar Kafka compatibility
wrapper and configure P
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
To use the Pulsar Kafka compatibility wrapper, complete the following steps.
@@ -28,7 +34,7 @@ To use the Pulsar Kafka compatibility wrapper, complete the
following steps.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -46,7 +52,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
diff --git a/versioned_docs/version-4.2.x/adaptors-kafka.md
b/versioned_docs/version-4.2.x/adaptors-kafka.md
index 4718b1bd648..1148d32df90 100644
--- a/versioned_docs/version-4.2.x/adaptors-kafka.md
+++ b/versioned_docs/version-4.2.x/adaptors-kafka.md
@@ -8,6 +8,12 @@ description: Learn to use the Pulsar Kafka compatibility
wrapper and configure P
Pulsar provides an easy option for applications that are currently written
using the [Apache Kafka](http://kafka.apache.org) Java client API.
+:::note
+
+The Pulsar Kafka wrapper artifacts (`pulsar-client-kafka` and
`pulsar-client-kafka-original`) live in the separate
[apache/pulsar-adapters](https://github.com/apache/pulsar-adapters) repository,
and the last released version on Maven Central is
[`@pulsar:version:adapters@`](https://repo1.maven.org/maven2/org/apache/pulsar/pulsar-client-kafka/).
Even when you run a newer Pulsar broker (3.x / 4.x), keep the dependency
pinned to `@pulsar:version:adapters@` -- newer matching artifacts are no [...]
+
+:::
+
## Use the Pulsar Kafka compatibility wrapper
To use the Pulsar Kafka compatibility wrapper, complete the following steps.
@@ -28,7 +34,7 @@ To use the Pulsar Kafka compatibility wrapper, complete the
following steps.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
@@ -46,7 +52,7 @@ unshaded Pulsar Kafka client wrapper.
<dependency>
<groupId>org.apache.pulsar</groupId>
<artifactId>pulsar-client-kafka-original</artifactId>
- <version>@pulsar:version@</version>
+ <version>@pulsar:version:adapters@</version>
</dependency>
```
