This is an automated email from the ASF dual-hosted git repository.
chia7712 pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/trunk by this push:
new 11688f2129e MINOR: Added a @since 4.2.0 note to removeRaftVoter in
Admin.java explaining the interaction with controller.quorum.auto.join.enable
(#21322)
11688f2129e is described below
commit 11688f2129ef7eb1c541d93a19cc05d1fc6058d0
Author: TaiJuWu <[email protected]>
AuthorDate: Thu Jan 22 15:01:57 2026 +0800
MINOR: Added a @since 4.2.0 note to removeRaftVoter in Admin.java
explaining the interaction with controller.quorum.auto.join.enable (#21322)
This PR updates the Javadoc for the `Admin#removeRaftVoter` method to
include a critical operational note introduced in Kafka 4.2.0.
Reviewers: Chia-Ping Tsai <[email protected]>
---
clients/src/main/java/org/apache/kafka/clients/admin/Admin.java | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
b/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
index 817545e3748..6defe2d77a1 100644
--- a/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
+++ b/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
@@ -1911,6 +1911,10 @@ public interface Admin extends AutoCloseable {
* will fail with {@link InconsistentClusterIdException}.
* If not provided, the cluster id check is skipped.
*
+ * <p> Note: Since 4.2.0, if {@code controller.quorum.auto.join.enable} is
set to true the controller
+ * must be shutdown before removing the controller from the voter set to
prevent the removed
+ * controller from automatically joining again.
+ *
* @param voterId The node ID of the voter.
* @param voterDirectoryId The directory ID of the voter.
* @param options Additional options for the operation,
including optional cluster ID.
